Metadata-Version: 2.1
Name: forth-kernel
Version: 0.3
Summary: A Forth kernel for IPython (Fork of https://github.com/jdfreder/iforth)
Home-page: https://github.com/sohang3112/iforth
Author: Sohang Chopra
Author-email: sohangchopra@gmail.com
Classifier: Framework :: IPython
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Shells
Description-Content-Type: text/markdown
License-File: LICENSE

# IForth

Forth kernel for the Jupyter / IPython notebook.  Requires IPython 3.x (master at the time of writing).

## Installation
1. Install [Gforth](https://www.gnu.org/software/gforth/).  Make sure it is accessible via the commandline/terminal (`gforth --version`).
2. Run `pip install iforth`

### Development Installation
Clone this repository and do an [editable `pip` install](https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs) in this repository's folder:
```bash
pip install -e .
jupyter kernelspec install ./kernelspec --user   
```

**Note:** `jupyter kernelspec install` is required here, because unlike in normal install, the kernel does NOT automatically show in `jupyter kernelspec list`.

## Usage
- Run `jupyter notebook` (or `ipython notebook`, whichever you prefer).
- In a new or existing notebook, use the kernel selector (located at the top right of the notebook) to select `IForth`.
