Metadata-Version: 2.1
Name: d64
Version: 0.10
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
Description: # 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 write program and data files within an image.
        
        In addition it contains tools useful to inspect and modify images, for example a script to check the integrity of an image.
        
        
        ## Examples
        
        Classes and functions reside in the `d64` module, the whole module may be imported or just those definitions referenced by the user.
        
        ### Displaying an image contents
        
        To perform a directory list
        
        ```python
        from pathlib import Path
        from d64 import DiskImage
        
        with DiskImage(Path('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 pathlib import Path
        from d64 import DiskImage, ProgramFile
        
        with DiskImage(Path('test.d64')) as image:
            with image.path("METEOR").open() as f:
                p = ProgramFile(f)
        
        for line in p.list():
            print(line)
        ```
        
        
        ## TODO
        
        - Detailed documentation
        - interactive shell utility
        - support for .d71
        - support for .d81
        - better docstrings
        - more examples
        - Selectable BASIC token sets
        - codec support (use [cbmcodecs](https://pypi.org/project/cbmcodecs/))
        
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
