Skip to main content

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)

Source distribution for asmchip8 0.1
File Size Uploaded
asmchip8-0.1.tar.gz 31.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for asmchip8 0.1
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page