Metadata-Version: 2.0
Name: calysto-lc3
Version: 0.6
Summary: An LC-3 Assembly Language kernel for Jupyter based on MetaKernel
Home-page: https://github.com/Calysto/calysto_lc3
Author: Douglas Blank
Author-email: doug.blank@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Framework :: IPython
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Lisp
Classifier: Topic :: System :: Shells
Requires-Dist: metakernel

# calysto_lc3

Calysto Little Computer - LC3 Assembly Language for Jupyter 

An Jupyter kernel for LC3

This requires IPython 3.

To install::

    pip install calysto_lc3
    python -m calysto_lc3.install

To use it, run one of:

* ipython notebook
  * In the notebook interface, select 'Calysto LC3' from the 'New' menu
* ipython qtconsole --kernel calysto_lc3
* ipython console --kernel calysto_lc3

Typing `?` to the kernel gives:
```
This is the Calysto LC3 Jupyter kernel.

LC3 Interactive Magic Directives: 

 %bp [clear | SUSPENDHEX]           - show, clear, or set breakpoints
 %cont                              - continue running
 %dis [STARTHEX [STOPHEX]]          - dump memory as program
 %dump [STARTHEX [STOPHEX]]         - list memory in hex
 %exe                               - execute the program
 %mem HEXLOCATION HEXVALUE          - set memory
 %pc HEXVALUE                       - set PC
 %reg REG HEXVALUE                  - set register REG to HEXVALUE
 %regs                              - show registers
 %reset                             - reset LC3 to start state
 %step                              - execute the next instruction, increment PC

HEX values begin with an 'x' and are composed of 4 0-F digits or letters.
```
Additional help is available with `%help ITEM` such as `%help pc`.


