Skip to main content

Python library for Acorn ROM Filing System (ROMFS) paged-ROM images

Project description

oaknut-romfs

Acorn ROM Filing System (ROMFS) support for the oaknut family of packages.

ROMFS is the filing system for paged ROMs on the BBC Micro and Acorn Electron — sideways ROMs and cartridges. It stores files in the same block layout as the Cassette Filing System (CFS), with the ROM image standing in for the tape: each file is a chain of CFS-format blocks carrying Acorn load and execution addresses, a block number, a length, a flag byte, and header and data CRCs, introduced by a standard paged-ROM service header.

The medium is read-only ROM, so the filing system is flat: there are no directories, and a file's metadata is the load/exec pair plus a lock bit, exactly as on cassette.

This package contributes ROMFS to the oaknut.filesystem extension axis, so ROMFS images are identified, listed and read through the disc CLI alongside the disc-based filing systems.

Status

Pre-alpha. The package is being built up format-first: see docs/romfs-format-spec.md for the on-ROM byte layout and docs/architecture.md for the package design and its mapping onto the oaknut.filesystem contract.

Installation

uv add oaknut-romfs

Licence

MIT — see LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oaknut_romfs-12.6.1.tar.gz (36.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

oaknut_romfs-12.6.1-py3-none-any.whl (26.7 kB view details)

Uploaded Python 3

File details

Details for the file oaknut_romfs-12.6.1.tar.gz.

File metadata

  • Download URL: oaknut_romfs-12.6.1.tar.gz
  • Upload date:
  • Size: 36.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for oaknut_romfs-12.6.1.tar.gz
Algorithm Hash digest
SHA256 56189c03d9c66ba2ee82af160e4fb78894ef92a9c71319ab5e50b61b95a95d44
MD5 66be3145a3197b01d9ea526e60335180
BLAKE2b-256 7da1c96d69f7d1b1f1c7f20bc4b38268319b3dfcb03a6941469a2305f02b66ce

See more details on using hashes here.

File details

Details for the file oaknut_romfs-12.6.1-py3-none-any.whl.

File metadata

  • Download URL: oaknut_romfs-12.6.1-py3-none-any.whl
  • Upload date:
  • Size: 26.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for oaknut_romfs-12.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6f677bfb10e3f198371d62cdbea34eee5d4ac4ae2584aa20903a0ee38a99089d
MD5 08163dd8ae2fd9c75bc3a5bf3e374e6c
BLAKE2b-256 4092ce22fd4ebdae2805f6bb3c2e2de62a5f64249d59b59aaa676e4e1fdcd94e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page