https://github.com/makiuchi-d/whitenote

The whitespace kernel for Jupyter
https://github.com/makiuchi-d/whitenote

interpreter jupyter-lab jupyter-notebook whitespace

Last synced: about 1 month ago
JSON representation

The whitespace kernel for Jupyter

• Host: GitHub
• URL: https://github.com/makiuchi-d/whitenote
• Owner: makiuchi-d
• License: mit
• Created: 2022-07-07T16:52:43.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-04-17T06:41:18.000Z (over 1 year ago)
• Last Synced: 2024-09-30T10:24:05.823Z (about 2 months ago)
• Topics: interpreter, jupyter-lab, jupyter-notebook, whitespace
• Language: Go
• Homepage:
• Size: 186 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
whitenote - The whitespace kernel for Jupyter

=============================================

`whitenote` is a [whitespace](https://web.archive.org/web/20150523181043/http://compsoc.dur.ac.uk/whitespace/index.php) kernel for [Jupyter](https://jupyter.org/).

![](jupyter.gif)

## Try with Docker

Docker image avairable: [makiuchid/whitenote](https://hub.docker.com/r/makiuchid/whitenote)

```

docker run -p 8888:8888 makiuchid/whitenote

```

Follow the instructions on the screen to access Jupyter lab:

[http://localhost:8888/lab?token=????????](http://localhost:8888/)

## Install

### Required libraries

Ubuntu (focal, jammy), Debian (bullseye):

```

apt install libzmq3-dev libzmq5

```

### Build and install

```

git clone https://github.com/makiuchi-d/whitenote.git

cd whitenote

go install .

jupyter kernelspec install --name=whitenote --user ./kernel

```

## Whitespace interpreter

The whitespace interpreter (VM) is provided in the package `github.com/makiuchi-d/whitenote/wspace`.

### REPL binary

#### Install

```

go install github.com/makiuchi-d/whitenote/wspace/cmd/wspace@latest

```

#### Usage

```

wspace 

    Evaluate the file

wspace

    Launch an interactive interpreter

```