asmchip8 is an assembler for CHIP-8. It is free software under the GNU AGPLv3+ license.
The author and maintainer is Mariano Street <mctpyt@proton.me>.
Dependencies
Runtime dependency: Python 3.10 or later.
Install dependency: Flit.
Test dependencies: PyTest, PyEnv, Test.
Development
How to run?
From the project directory, run:
$ ./src/asmchip8/main.py <input>
For information on command-line options, see asmchip8(1) or run with -h or --help.
How to install?
Part of the project can be installed via Flit:
$ flit install
How to run the test suite?
From the project directory, run:
$ PYTHONPATH=src pytest tests
If you want a more verbose output, add the -v option.
PyTest is required to be installed. One way to handle this is via Tox: see the next section.
How to test different Python versions?
Use PyEnv and Tox.
For example, to test 3.11:
$ pyenv install 3.11-dev $ PATH=$PATH:$HOME/.pyenv/versions/3.11-dev/bin tox -e py311
When testing via Tox, it is not necessary to have PyTest installed on the system. Tox installs it automatically in an isolated environment.
Additional documentation
Two manpages are provided with the project:
- asmchip8(1)
Located at doc/asmchip8.1. It documents the asmchip8 command.
- asmchip8(5)
Located at doc/asmchip8.5. It documents the assembly language.
They can be read without installing like this, from the project directory:
$ man -l doc/asmchip8.1 $ man -l doc/asmchip8.5
In addition, the source code contains some comments and docstrings.
Metadata
Release files for asmchip8 0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| asmchip8-0.1.tar.gz | 31.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| asmchip8-0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.0 kB
Release files / asmchip8-0.1.tar.gz
| Download URL | asmchip8-0.1.tar.gz |
|---|---|
| Size | 31.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5a14ae510abb942a8b7006cde5ec36d9667a0be5198e1cabc2d8fff747859ee
|
|
BLAKE2b-256 checksum How to use checksums |
e724edf45e05dbb6403d025978c9d7f42cc341e2bf81ca1d8a758922c101feaf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.28.1
|
Release files / asmchip8-0.1-py3-none-any.whl
| Download URL | asmchip8-0.1-py3-none-any.whl |
|---|---|
| Size | 16.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
05cf5ac5a81c681b61f0acfc60e32c8ffdeca252e86ec5e6a5cc3e8274b85670
|
|
BLAKE2b-256 checksum How to use checksums |
896b84980a44dac08ad72af5603d7688d96469982194b4aad4f291a9a9983aa6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.28.1
|