Metadata-Version: 2.1
Name: cbmfiles
Version: 2.2
Summary: Manipulate Commodore file types
Home-page: https://eden.mose.org.uk/gitweb/?p=python-cbmfiles.git
Author: Simon Rowe
Author-email: srowe@mose.org.uk
License: GPLv2
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
License-File: LICENSE

========
cbmfiles
========

This Python module enables access to various types of file formats used by Commodore microcomputers.

It provides classes to translate BASIC and binary program files between their native format and standard text files.


Examples
========

Classes reside in the ``cbm_files`` module, the whole module may be imported or just those definitions referenced by the user.

List the contents of a BASIC file
---------------------------------

.. code-block:: python

    from cbm_files import BASICFile

    with open('example.prg', 'rb') as f:
        prog = BASICFile(f)

    for line in prog.to_text():
        print(line)


TODO
====

- detailed documentation
- support more BASIC variants
- more examples
