<commit_before># A Python implementation of Notch's DCPU-16.

See http://0x10c.com/doc/dcpu-16.txt for specification.

Notch apparently started doing a 6502 emulator first. Given I did one in
Python <https://github.com/jtauber/applepy> it only seems fitting I now
do a DCPU-16 implementation in Python too :-)


## Status

Runs the example program successfully. Cycle times are not yet taken
into account but it otherwise should be feature-complete.

A dissassembler and (two) assemblers are also included.

* `./asm.py example.asm example.obj` will assemble Notch's example to object code
* `./dcpu16.py example.obj` will execute it (currently hard-coded to debug mode)
* `./disasm.py example.obj` will disassemble the given object code

There is also an experimental pyparsing-based assembler `./asm_pyparsing.py`
contributed by <NAME> with support for case-insensitive instructions and
identifers as well as `dat`. You'll need to `pip install pyparsing` to run it.

Note that the disassembler doesn't quite output in a format that can be
round-tripped back into the assembler as it annotates each line with a
memory offset.

I plan to work on a Forth implementation soon.

I'm also keen to find out how Notch plans I/O to work.


## Examples

Now see [https://github.com/jtauber/DCPU-16-Examples](https://github.com/jtauber/DCPU-16-Examples) (although my assembler and
emulator don't necessarily support everything there yet)<commit_msg>lots of updates to README (some stuff was outdated but added description of command line options on `dcpu16.py`<commit_after># A Python implementation of Notch's DCPU-16.

See http://0x10c.com/doc/dcpu-16.txt for specification.

Notch apparently started doing a 6502 emulator first. Given I did one in
Python <https://github.com/jtauber/applepy> it only seems fitting I now
do a DCPU-16 implementation in Python too :-)


## Status

Runs the example program successfully. Cycle times are not yet taken
into account but it otherwise should be feature-complete.

A dissassembler and (two) assemblers are also included.

* `./asm.py example.asm example.obj` will assemble Notch's example to object code
* `./disasm.py example.obj` will disassemble the given object code
* `./dcpu16.py example.obj` will execute it (but won't show anything without extra options)

There is also an experimental pyparsing-based assembler `./asm_pyparsing.py`
contributed by <NAME>. You'll need to `pip install pyparsing` to run it.

`./dcpu16.py` takes a number of options:

* `--debug` runs the emulate in debug mode, enabling you to step through each instruction
* `--trace` dumps the registers and stack after every step (implied by `--debug`)
* `--speed` outputs the speed the emulator is running at in kHz
* `--term TERM` specifies a terminal to use for text output (current `null` or `pygame`)

I plan to work on a Forth implementation soon.


## Examples

Now see [https://github.com/jtauber/DCPU-16-Examples](https://github.com/jtauber/DCPU-16-Examples) (although my assembler and
emulator don't necessarily support everything there yet)
{'fraction_non_alphanumeric': 0.08357819131570356, 'fraction_numerical': 0.013712047012732615, 'mean_word_length': 4.29188255613126, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6283142', 'n_tokens_mistral': 949, 'n_tokens_neox': 876, 'n_words': 403}