oaknut-filesystem
The pluggable filesystem contract for the oaknut family — the base every Acorn (and, in principle, foreign) filesystem plugs into.
A filesystem is the unit of extension: Acorn DFS, Watford DFS, Opus DDOS,
ADFS, AFS, … are peers, registered on the oaknut.filesystem entry-point axis
(built on oaknut-extension). Each one:
- probes an image region and proposes what it is — with a confidence, evidence, and a candidate geometry;
- opens a region into a mount exposing a small core (list / stat /
read / write / exists, and parsing its own path syntax) plus opt-in
capability protocols (
HierarchicalDirectories,AcornMetadata,BootOption,UserDatabase,RegionHost); - declares its geometry grammar — the physical layouts it supports.
Two concerns are kept strictly apart:
- Geometry — the physical mapping of image bytes to logical sectors
(track count, sides, interleave, density, CHS). This is the discimage
DiscFormatlayer, beneath the filesystem. - Filesystem — the logical structure that turns sectors into files and directories.
This package also hosts the identification coordinator (identify()): it
runs the registered filesystems over an image, ranks the candidates, and
recurses into reserved regions (an ADFS host's tail, where an AFS or other
filesystem may live) to produce a per-partition Identification tree.
It depends on no concrete filesystem package and imports none: filesystems are discovered purely through entry points, so any subset can be installed and the rest simply aren't handled.
See docs/dev/filesystem-extensions.md (architecture) and
docs/dev/filesystem-extensions-plan.md (implementation plan).
Part of the oaknut monorepo.
Installation
uv add oaknut-filesystem # or: pip install oaknut-filesystem
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file oaknut_filesystem-12.17.1.tar.gz.
File metadata
- Download URL: oaknut_filesystem-12.17.1.tar.gz
- Upload date:
- Size: 33.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8fecc7248f3983c05dafe49374a2635d92ca6dce9fb18792d5d23c63d0e8c09b
|
|
| MD5 |
727dbe89b54cb4226d384a67ec875916
|
|
| BLAKE2b-256 |
774f2031ec9151b8a60135fa78351eb036f5ed13cd9d07d8269f1bf5ac3160ec
|
File details
Details for the file oaknut_filesystem-12.17.1-py3-none-any.whl.
File metadata
- Download URL: oaknut_filesystem-12.17.1-py3-none-any.whl
- Upload date:
- Size: 30.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6a56649194b9b26e235733ce225f25ceeeb28184eda2327f7a5063331cecd9a6
|
|
| MD5 |
d33d10ae36f72a40aa426ed9401e05be
|
|
| BLAKE2b-256 |
0cf7374d4d962f37701a126d4ba4e9c35e0f8ae2f605d5f3436efe85bd497717
|
