xeus-cling is a Jupyter kernel for C++ based on the C++ interpreter cling and the native implementation of the Jupyter protocol xeus.

xeus-cling has been packaged for the mamba (or conda) package manager on the Linux and OS X platforms. At the moment, we are not providing packages for the Windows platform.

To ensure that the installation works, it is preferable to install xeus-cling in a fresh environment. It is also needed to use a miniforge or miniconda installation because with the full anaconda you may have a conflict with the ZeroMQ library which is already installed in the anaconda distribution.

The safest usage is to create an environment named cling:

mamba create -n cling
source activate cling

Then you can install in this environment xeus-cling and its dependencies

mamba install xeus-cling -c conda-forge

You will first need to create a new environment and install the dependencies:

mamba create -n xeus-cling -c conda-forge cmake xeus-zmq cling nlohmann_json=3.11.2 cppzmq xtl pugixml doctest cpp-argparse
source activate xeus-cling

Please refer to environment-host.yml for packages specific versions to install if applicable.

You can then compile the sources. From the build directory, run:

cmake -D CMAKE_INSTALL_PREFIX=${CONDA_PREFIX} -D CMAKE_C_COMPILER=$CC -D CMAKE_CXX_COMPILER=$CXX -D CMAKE_INSTALL_LIBDIR=${CONDA_PREFIX}/lib ..
make && make install

If you don't have a frontend already installed (classic Jupyter Notebook or JupyterLab for instance), install one:

mamba install jupyterlab -c conda-forge

To try out xeus-cling interactively in your web browser, just click on the binder link:

To get started with using xeus-cling, check out the full documentation

https://xeus-cling.readthedocs.io/

Launch the jupyter notebook with jupyter notebook and launch a new C++ notebook by selecting the C++17 kernel in the new dropdown.

You can now make use of the C++ programming language in the Jupyter notebook.

Quick help is shown on the pager with the special ? magic.

Content for the quick help is available for the standard library, and can be made available for third-party packages.

A C++ backend for the Jupyter interactive widgets is available in the xwidgets package.

xeus-cling depends on

• xeus-zmq
• xtl
• cling
• pugixml
• cpp-argparse
• nlohmann_json

Prior to version 0.15, xeus-cling was depending on cxxopts instead of cpp-argparse.

Prior to version 0.14, xeus-cling was depending on xeus instead of xeus-zmq:

xeus-cling requires its dependencies to be built with the same compiler and same C runtime as the one used to build cling.

See CONTRIBUTING.md to know how to contribute and set up a development environment.

We use a shared copyright model that enables all contributors to maintain the copyright on their contributions.

This software is licensed under the BSD-3-Clause license. See the LICENSE file for details.