crystal_kernel

Simple Python wrapper kernel for Crystal language. ICrystal is the widely used Jupyter kernel for Crystal, which uses ICR. On the other hand, this crystal_kernel uses the official Crystal interpreter.

Forked from bash_kernel

Installation

Make sure the Crystal's interpreter starts with crystal i.

Then type the following commands.

pip install crystal_kernel

python -m crystal_kernel.install

Compiling Crystal interpreter

Crystal 1.3.2 does not provide the Crystal interpreter by default.

To enable crystal i, you need to compile Crystal from source code with interpreter option. Crystal is required to compile Crystal. So please do not remove the existing Crystal just because you are going to install Crystal from source code.

git clone https://github.com/crystal-lang/crystal
cd crystal
make help                               # check available options
make interpreter=1 release=1 progress=1 # whatever you want
sudo make install                       # sudo checkinstall

Then check the interpreter start.

crystal i

Did it work?

Using Shards

Use shards when you want to use crystal libraries. Go to your working directory and create shard.yml with shards init and write the necessary libraries to it. After shards install, start jupyter.

Development

Clone the repository:

git clone https://github.com/crystal-data/crystal_kernel
cd crystal_kernel

Install in development mode:

pip install flit
flit install --symlink

Install the kernel spec:

python -m crystal_kernel.install

Build the package:

flit build

Publish to PyPI:

flit publish

See Python wrapper kernel for more information.

Feel free to fork this project and start your own project. The author (kojix2) is not familiar with Python and is ready to transfer this project to a more suitable person. If you are interested in taking over the project, please let us know.