Skip to content
No description, website, or topics provided.
Perl 6 Shell Python
Branch: master
Clone or download
Latest commit df7feb7 Dec 17, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin fix leaving Dec 17, 2017
docker docker Dec 15, 2017
lib/Net/Jupyter 0.1.3 messages Dec 16, 2017
resources/kernels/perl6 META updated Dec 7, 2017
t 0.1.2 Dec 16, 2017
xt first commit Sep 9, 2017
.gitignore docker Dec 15, 2017
.travis.yml travis.yml changed Nov 22, 2017
LICENSE.md first commit Sep 9, 2017
META6.json 0.1.3 shutdown Dec 16, 2017
README.md README 0.1.3 Dec 16, 2017

README.md

Net::Jupyter

SYNOPSIS

Net::Jupyter is a Perl6 Jupyter kernel

Introduction

This is a perl6 kernel for jupyter

the minumum required messages are implemented: kernel_info_request and execute_request also implemented: shutdown_request

Version 0.1.3

Status

In development.

Todo:

  1. Implement Magic statements (see section below)
  2. Implement additional messages

Alternatives

  1. https://github.com/timo/iperl6kernel

  2. https://github.com/bduggan/p6-jupyter-kernel

Portability

relies on Net::ZMQ

Documentation

see also http://jupyter.org/

Installation

First, install the module:

git clone https://github.com/gabrielash/p6-net-jupyter
cd p6-net-jupyter
zef install .

then, install the kernel:

bin/kernel-install.sh [ dir ]?

Assuming jupyter is already installed on your system, and LOCAL_HOME is defined, it will try to install in the correct .local subdir that Anaconda recognizes for jupyter kernels. You can also specify a custom dirctory as an argument.

Docker Installation

  docker run -d --name jupyter-als \
    -p 8888:8888 \
    -v $CONFIG:/home/jovyan/.jupyter \
    -v $NOTEBOOKS:/home/jovyan/work \
    gabrielash/all-spark-notebook
  1. set CONFIG to the directory (Full Path) for overriding jupyter settings. For example to substitute a fixed authentification token. There is a demo jupyter_notebook_config.py in the docker dir that you can copy into it and edit.
  2. set NOTEBOOKS to the directory that will hold all notebooks created. It will be the top directory for the Jupyter server.

see also Jupyter's all-spark-notebook docker image

An alternative minimal image based on jupyter base-notebook is also provided. see the docker directory.

Magic declarations

magic declrations are lines beginning and ending with %%.

All magic declarations apply to the whole cell, must come at the top, and cannot be interleaved with Perl6 code.

Implemented:

%% timeout 5 %%  
# sets a timeout on execution

%% class Classname %%
does Positional {
  ...
}

# defines a class. Note that the magic declaration replaces the beginning 
# of the class declaration, but any qualification must follow outside it
You can’t perform that action at this time.