Installation
With Conda or Mamba
xeus-sql
has been packaged for the conda package manager.
To ensure that the installation works, it is preferable to install xeus-sql
in a fresh conda/mamba environment.
It is also needed to use a 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 xeus-sql
with your miniconda installation
conda create -n xeus-sql
conda activate xeus-sql # Or `source activate xeus-sql` for conda < 4.6
mamba create -n xeus-sql
mamba activate xeus-sql
Then you can install in this freshly created environment xeus-sql
and its dependencies
conda install xeus-sql notebook -c conda-forge
mamba install xeus-sql notebook -c conda-forge
or, if you prefer to use JupyterLab
conda install xeus-sql jupyterlab -c conda-forge
mamba install xeus-sql jupyterlab -c conda-forge
Conda forge offers packaged versions for MySQL, PostgreSQL and SQLite and you can download them with: soci-mysql, soci-postresql or soci-sqlite.
xeus-sql
includes soci-core
only. Which consists on the SOCI package with no DB extension attached.
From Source
You can install xeus-sql
from source with cmake
. This requires that you have all the dependencies installed in the same prefix.
conda install cmake nlohmann_json xtl cppzmq xeus mysql sqlite postgresql cpp-tabulate>=1.5 xvega xvega-bindings xproperty jupyterlab compilers -c conda-forge
mamba install cmake nlohmann_json xtl cppzmq xeus mysql sqlite postgresql cpp-tabulate>=1.5 xvega xvega-bindings xproperty jupyterlab compilers -c conda-forge
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
make install
On Windows platforms, from the source directory:
mkdir build
cd build
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=/path/to/prefix ..
nmake
nmake install