'A Jupyter kernel for Kqlmagic.'
Project description
Prerequisites
Installation
To install using pip:
pip install kqlmagic_kernel
Add --user to install in the user-level environment instead of the system environment.
To install using conda:
conda config --add channels conda-forge conda install kqlmagic_kernel conda install texinfo # For the inline documentation (shift-tab) to appear. python -m kqlmagic_kernel.install
Kqlmagic Jupyter kernelspec is automatically installed as part of the python package. This location can be found using jupyter kernelspec list. If the default location is not desired, remove the directory for the kqlmagic kernel, and install using python -m kqlmagic_kernel install. See python -m kqlmagic_kernel install --help for available options.
Usage
To use the kernel, run one of:
jupyter notebook
# In the notebook interface, select Kqlmagic from the 'New' menu
jupyter qtconsole --kernel kqlmagic
jupyter console --kernel kqlmagic
This kernel is based on ipykernel, which means it features a standard set of magics (such as %%html). For a full list of magics, run %lsmagic in a cell.
A sample notebook is available online.
Configuration
The kernel can be configured by adding an kqlmagic_kernel_config.py file to the jupyter config path.
The path to the Kqlmagic kernel JSON file can also be specified by creating an KQLMAGIC_KERNEL_JSON environment variable.
Troubleshooting
Kernel Times Out While Starting
If the kernel does not start, run the following command from a terminal:
python -m kqlmagic_kernel.check
This can help diagnose problems with setting up integration with Octave. If in doubt, create an issue with the output of that command.
Kernel is Not Listed
If the kernel is not listed as an available kernel, first try the following command:
python -m kqlmagic_kernel install --user
If the kernel is still not listed, verify that the following point to the same version of python:
which python # use "where" if using cmd.exe
which jupyter
For details of how this works, see the Jupyter docs on wrapper kernels
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for kqlmagic_kernel-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a7b54a9dee31e9c65666d902d7f05bc6558f690c2f62538289883623a37c77c7 |
|
MD5 | 9b16e8dd57222d1ed106d9adf0746357 |
|
BLAKE2b-256 | eefcbaebb0303a541a4fca3b900a486fae4de5f77e87fec69a23dc0af8337300 |