oaknut-disc
===========

Python tools for Acorn computer filesystems, files, and formats — the
BBC Micro, Electron, Archimedes, and their descendants.

If you have not yet installed anything, start with the :doc:`install`
guide.

Most readers reach for the ``disc`` :doc:`command-line interface
<cli/getting-started>` to inspect, extract, or modify Acorn disc
images from a shell. The :doc:`Python API <api/getting-started>` is
for programs that consume the on-disc formats directly.

.. toctree::
   :hidden:
   :caption: Installation

   install

.. toctree::
   :hidden:
   :caption: Command-line interface

   cli/getting-started
   cli/cookbook
   cli/conventions/index
   cli/commands/index

.. toctree::
   :hidden:
   :caption: Python API

   api/getting-started
   api/cookbook
   api/patterns/index
   api/reference/index

.. toctree::
   :hidden:
   :caption: Reference

   glossary
   changelog