Metadata-Version: 2.1
Name: d64
Version: 0.2
Summary: Read and write Commodore disk images
Home-page: https://eden.mose.org.uk/gitweb/?p=python-d64.git
Author: Simon Rowe
Author-email: srowe@mose.org.uk
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown

# d64

This Python module enables access to disk image files (.d64) used by various Commodore microcomputer emulators and tools.

It provides familiar interfaces for developers to read (and eventually write) program and data files within an image.


## Examples

Classes and functions reside in the `d64` module, the whole module may be imported or just those definitions referenced by the suer.

### Displaying an image contents

To perform a directory list

```python
from d64 import DiskImage

with DiskImage('test/data/squadron.d64') as image:
    for line in image.directory():
        print(line)
```

This prints out

```
0 "SQUADRON        " Q9 2A
15   "SQUADRON PAL"     PRG
15   "SQUADRON NTSC"    PRG
634 BLOCKS FREE.
```

### Listing a BASIC program

To display a BASIC program as text

```python
from d64 import DiskImage, ProgramFile

with DiskImage('test/data/test.d64') as image:
    with image.path("METEOR").open() as f:
        p = ProgramFile(f)

for line in p.list():
    print(line)
```


## TODO

- interactive shell utility
- File write support
- Entry deletion
- Empty image creation
- codec support (use cbmcodecs)


