Skip to content

Lightweight Rust integration in Jupyter notebook

License

Notifications You must be signed in to change notification settings

axil/rust-magic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rust-magic Build Status

Allows to try rust in Jupyter notebook. Implemented via line/cell magics:

Installation

  1. Install rust and jupyter-notebook

  2. cargo install cargo-script

  3. pip install rust-magic

  4. Enjoy :)

Third-party crates

are supported via normal cargo script syntax (see below for a more compact notation):

Compiler options

can be provided in the cell mode:

NB Here's a copy-pastable form of all the examples above.

Syntax highlighting

To enable rust syntax highlighting in %%rust cells run the following snippet in a python jupyter cell:

from notebook.services.config import ConfigManager
c = ConfigManager()
c.update('notebook', {"CodeCell": {"highlight_modes": {"text/x-rustsrc": {"reg": ["^%%rust"]}}}})

This only needs to be run once: it stores the setting in a config file in home directory.

Long cells

Jupyter "doesn't like" long cells: when a cell gets longer than the screen its output is not readily visible. Here're a few ways how to handle the problem with rust_magic:

a) putting dependencies into a separate cell (more)

b) collapsing function bodies with codefolding jupyter extension

c) putting function definitions into separate cells (more)

Faster compile times

can be acheived by caching dependencies compile results with sccache. Rust-magic automatically uses it if it is installed in the system (cargo install sccache).

About

Lightweight Rust integration in Jupyter notebook

Resources

License

Stars

Watchers

Forks

Packages

No packages published