pyprodos
This is a simple Python implementation of the Apple ProDOS ™️ filesystem based on the technical reference manual.
It provides a simple unix-style CLI for managing existing ProDOS images in
.po and .2mg files and for creating new ones.
This provides an accessible file system for Apple // or other 8-bit hardware.
As an example, let's recreate a ProDOS boot volume. Grab the ProDOS 2.4.3
boot disk from https://prodos8.com/. (There's a copy in images/ here.)
Check what's on it:
% prodos info images/ProDOS_2_4_3.po
Volume PRODOS.2.4.3 23-12-29T19:07
BlockDevice on images/ProDOS_2_4_3.po contains 280 total blocks, 26 free (91% used)
% prodos ls images/ProDOS_2_4_3.po
File name EOF T/FT Access Created Modified Blocks @ Key
---------------------------------------------------------------------------------
VIEW.README 512 1/FC RW-BND 18-02-13T09:09 18-02-13T09:09 1 @ 250
...
BASIC.SYSTEM 10240 2/FF RW-BND 23-12-30T02:43 23-12-30T02:43 21 @ 42
...
PRODOS 17128 2/FF RW-BND 23-12-30T02:43 23-12-30T02:43 34 @ 7
README 999 2/04 RW-BND 23-12-30T02:43 23-12-30T02:43 3 @ 251
17 files in PRODOS.2.4.3 F RW--ND 23-12-29T19:07
Let's extract the PRODOS o/s and BASIC.SYSTEM files, plus the bootloader.
ProDOS should execute the first .SYSTEM file it finds after it boots.
% prodos export images/ProDOS_2_4_3.po /PRODOS /BASIC.SYSTEM . --loader loader.bin
Now we'll make a new 140K (280 block) floppy boot disk:
% prodos create boot.po --name MYVOL --size 280
then import the system files and bootloader and check the listing:
% prodos import boot.po --loader loader.bin PRODOS BASIC.SYSTEM /
% prodos ls boot.po
File name EOF T/FT Access Created Modified Blocks @ Key
---------------------------------------------------------------------------------
PRODOS 17128 2/FF RW-BND 25-12-28T15:20 25-12-28T15:20 34 @ 7
BASIC.SYSTEM 10240 2/FF RW-BND 25-12-28T15:20 25-12-28T15:20 21 @ 41
2 files in MYVOL F RW-BND 25-12-28T15:19
Finally, test the image in your favorite emulator. I used VirtualII and popped my volume in the virtual Disk ][ drive. After a ProDOS splash screen, you you see the familiar Basic prompt:
PRODOS BASIC 1.7
COPYRIGHT APPLE 1983-92
]
My original goal was to learn how the on-disk representation worked and to manage disk images for a 6502-based breadboard computer. ProDOS is simple enough that a minimal kernel can be very small. For example I use a read-only version that's only a couple hundred lines of TaliForth. I also ported a version of the original 6502 ProDOS filestyem kernel: p8fs.
Metadata
Release files for pyprodos 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pyprodos-0.4.0.tar.gz | 43.0 kB | Without provenance | Details for pyprodos-0.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pyprodos-0.4.0-py3-none-any.whl | Python 3 | none | any | Details for pyprodos-0.4.0-py3-none-any.whl |
Total release size: 72.7 kB
Release files / pyprodos-0.4.0.tar.gz
| Download URL | pyprodos-0.4.0.tar.gz |
|---|---|
| Size | 43.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da44adac3e0318f8582c9ab2c61541e4b8e3d7e2444d948121cc1f2548fd9e16
|
|
BLAKE2b-256 checksum How to use checksums |
b86b5fdf5e18438d7e41bd5640028f90421cc25d2617aa6b63d347e98db46895
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.12
|
Release files / pyprodos-0.4.0-py3-none-any.whl
| Download URL | pyprodos-0.4.0-py3-none-any.whl |
|---|---|
| Size | 29.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e912fb426645bad1a4538f59f356846438f2d260df1f7bb3f82f39f94ff186e4
|
|
BLAKE2b-256 checksum How to use checksums |
13da3a1a22e1afcf4be20b1f3b6c5dc1e3b1fb92adc04147bdb51797ce0f0d75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.12
|
Security for pyprodos 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.