oaknut-basic 12.6.1__tar.gz → 12.7.1__tar.gz

oaknut_basic-12.7.1/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: oaknut-basic
+Version: 12.7.1
+Summary: BBC BASIC tokeniser and detokeniser for Acorn 8-bit and 32-bit BASIC source files
+Author-email: Robert Smallshire <robert@smallshire.org.uk>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rob-smallshire/oaknut/tree/master/packages/oaknut-basic
+Project-URL: Repository, https://github.com/rob-smallshire/oaknut
+Project-URL: Issues, https://github.com/rob-smallshire/oaknut/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: oaknut-exception>=10.0
+Provides-Extra: cli
+Requires-Dist: oaknut-cli>=10.0; extra == "cli"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/rob-smallshire/oaknut/master/docs/basic/_static/oaknut-basic-logo.png" alt="oaknut-basic" width="300">
+</p>
+
+# oaknut-basic
+
+[![PyPI version](https://img.shields.io/pypi/v/oaknut-basic)](https://pypi.org/project/oaknut-basic/)
+[![CI](https://github.com/rob-smallshire/oaknut/actions/workflows/ci.yml/badge.svg)](https://github.com/rob-smallshire/oaknut/actions/workflows/ci.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/oaknut-basic)](https://pypi.org/project/oaknut-basic/)
+[![License: MIT](https://img.shields.io/pypi/l/oaknut-basic)](https://github.com/rob-smallshire/oaknut/blob/master/packages/oaknut-basic/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-online-blue)](https://rob-smallshire.github.io/oaknut/basic/)
+
+**[Read the documentation](https://rob-smallshire.github.io/oaknut/basic/)** — getting started, the command reference, and the API.
+
+Convert [BBC BASIC](https://en.wikipedia.org/wiki/BBC_BASIC) programs between
+their compact on-disc *tokenised* form and a plain-text listing — the two
+directions a real BBC Micro performs when you `LOAD` a program and `LIST` it —
+plus line numbering for source typed without numbers.
+
+## The problem
+
+A tokenised BBC BASIC program is bytecode, not text: keywords like `PRINT` and
+`GOTO` are single bytes, line numbers are packed into each line's header, and a
+reference such as `GOTO 100` is scrambled into a three-byte form that can never
+be mistaken for a line terminator. A text codec cannot read it; decoding one as
+text produces garbage.
+
+`oaknut-basic` reproduces the **BBC BASIC II** ROM's tokeniser and de-tokeniser
+exactly — every token value, flag, and the line-number encoding — so a program
+round-trips between bytes and text **byte-for-byte**.
+
+## Installation
+
+Install with the `[cli]` extra for the `oaknut-basic` command, or bare for the
+library only:
+
+```
+uv tool install "oaknut-basic[cli]"     # the command-line tool
+uv add oaknut-basic                       # the importable library
+```
+
+`pip` works identically with the same names. `oaknut-basic` requires Python
+3.11 or newer.
+
+## Command-line usage
+
+```
+$ oaknut-basic --help
+Usage: oaknut-basic [OPTIONS] COMMAND [ARGS]...
+
+  Tools for BBC BASIC source and tokenised programs.
+
+Options:
+  --version  Show the version and exit.
+  --help     Show this message and exit.
+
+Commands:
+  detokenise  De-tokenise a stored BBC BASIC program into source text.
+  number      Prepend ascending line numbers to an unnumbered BBC BASIC...
+  tokenise    Tokenise BBC BASIC source text into a stored program.
+```
+
+Every command reads from a file or standard input and writes to a file or
+standard output, so each works file-to-file and as a pipe stage. That makes it
+compose with [`oaknut-disc`](https://github.com/rob-smallshire/oaknut/tree/master/packages/oaknut-disc)
+to edit a program in place on a disc image:
+
+```
+disc get game.ssd MENU - | oaknut-basic detokenise > menu.bas
+oaknut-basic tokenise menu.bas | disc put game.ssd MENU -
+```
+
+Tokenising and de-tokenising are exact inverses, so a program survives a
+there-and-back trip unchanged. `tokenise` can also number unnumbered source on
+the way in (`--start` / `--step`), exactly as typing it under `AUTO` would.
+
+## Library usage
+
+The library is function-shaped — `tokenise`, `detokenise`, and `number_lines`,
+all importable from `oaknut.basic`:
+
+```python
+from oaknut.basic import tokenise, detokenise
+
+program = tokenise('10 PRINT "HELLO"\n20 GOTO 10\n')   # str -> bytes
+listing = detokenise(program)                          # bytes -> str
+assert tokenise(detokenise(program)) == program        # byte-exact
+```
+
+When the program lives in a disc image, prefer the path-object wrappers
+`DFSPath.read_basic` / `write_basic` (and the ADFS equivalents), which compose
+the codec with the disc's character encoding and the correct load address.
+
+## References
+
+- [BBC BASIC](https://en.wikipedia.org/wiki/BBC_BASIC) — Wikipedia overview of
+  the language and its versions.
+- [BBC BASIC program format](https://beebwiki.mdfs.net/Program_format) —
+  BeebWiki reference for the on-disc tokenised format and the token table.
+
+## Part of oaknut
+
+`oaknut-basic` is one package in the
+[oaknut](https://github.com/rob-smallshire/oaknut) monorepo of tools for Acorn
+computer filesystems, files, and formats. It backs the `read_basic` /
+`write_basic` methods of the `oaknut-dfs` and `oaknut-adfs` packages, and is
+usable on its own for `.bas` / `.bbc` files outside a disc image.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

oaknut_basic-12.7.1/README.md

@@ -0,0 +1,111 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/rob-smallshire/oaknut/master/docs/basic/_static/oaknut-basic-logo.png" alt="oaknut-basic" width="300">
+</p>
+
+# oaknut-basic
+
+[![PyPI version](https://img.shields.io/pypi/v/oaknut-basic)](https://pypi.org/project/oaknut-basic/)
+[![CI](https://github.com/rob-smallshire/oaknut/actions/workflows/ci.yml/badge.svg)](https://github.com/rob-smallshire/oaknut/actions/workflows/ci.yml)
+[![Python versions](https://img.shields.io/pypi/pyversions/oaknut-basic)](https://pypi.org/project/oaknut-basic/)
+[![License: MIT](https://img.shields.io/pypi/l/oaknut-basic)](https://github.com/rob-smallshire/oaknut/blob/master/packages/oaknut-basic/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-online-blue)](https://rob-smallshire.github.io/oaknut/basic/)
+
+**[Read the documentation](https://rob-smallshire.github.io/oaknut/basic/)** — getting started, the command reference, and the API.
+
+Convert [BBC BASIC](https://en.wikipedia.org/wiki/BBC_BASIC) programs between
+their compact on-disc *tokenised* form and a plain-text listing — the two
+directions a real BBC Micro performs when you `LOAD` a program and `LIST` it —
+plus line numbering for source typed without numbers.
+
+## The problem
+
+A tokenised BBC BASIC program is bytecode, not text: keywords like `PRINT` and
+`GOTO` are single bytes, line numbers are packed into each line's header, and a
+reference such as `GOTO 100` is scrambled into a three-byte form that can never
+be mistaken for a line terminator. A text codec cannot read it; decoding one as
+text produces garbage.
+
+`oaknut-basic` reproduces the **BBC BASIC II** ROM's tokeniser and de-tokeniser
+exactly — every token value, flag, and the line-number encoding — so a program
+round-trips between bytes and text **byte-for-byte**.
+
+## Installation
+
+Install with the `[cli]` extra for the `oaknut-basic` command, or bare for the
+library only:
+
+```
+uv tool install "oaknut-basic[cli]"     # the command-line tool
+uv add oaknut-basic                       # the importable library
+```
+
+`pip` works identically with the same names. `oaknut-basic` requires Python
+3.11 or newer.
+
+## Command-line usage
+
+```
+$ oaknut-basic --help
+Usage: oaknut-basic [OPTIONS] COMMAND [ARGS]...
+
+  Tools for BBC BASIC source and tokenised programs.
+
+Options:
+  --version  Show the version and exit.
+  --help     Show this message and exit.
+
+Commands:
+  detokenise  De-tokenise a stored BBC BASIC program into source text.
+  number      Prepend ascending line numbers to an unnumbered BBC BASIC...
+  tokenise    Tokenise BBC BASIC source text into a stored program.
+```
+
+Every command reads from a file or standard input and writes to a file or
+standard output, so each works file-to-file and as a pipe stage. That makes it
+compose with [`oaknut-disc`](https://github.com/rob-smallshire/oaknut/tree/master/packages/oaknut-disc)
+to edit a program in place on a disc image:
+
+```
+disc get game.ssd MENU - | oaknut-basic detokenise > menu.bas
+oaknut-basic tokenise menu.bas | disc put game.ssd MENU -
+```
+
+Tokenising and de-tokenising are exact inverses, so a program survives a
+there-and-back trip unchanged. `tokenise` can also number unnumbered source on
+the way in (`--start` / `--step`), exactly as typing it under `AUTO` would.
+
+## Library usage
+
+The library is function-shaped — `tokenise`, `detokenise`, and `number_lines`,
+all importable from `oaknut.basic`:
+
+```python
+from oaknut.basic import tokenise, detokenise
+
+program = tokenise('10 PRINT "HELLO"\n20 GOTO 10\n')   # str -> bytes
+listing = detokenise(program)                          # bytes -> str
+assert tokenise(detokenise(program)) == program        # byte-exact
+```
+
+When the program lives in a disc image, prefer the path-object wrappers
+`DFSPath.read_basic` / `write_basic` (and the ADFS equivalents), which compose
+the codec with the disc's character encoding and the correct load address.
+
+## References
+
+- [BBC BASIC](https://en.wikipedia.org/wiki/BBC_BASIC) — Wikipedia overview of
+  the language and its versions.
+- [BBC BASIC program format](https://beebwiki.mdfs.net/Program_format) —
+  BeebWiki reference for the on-disc tokenised format and the token table.
+
+## Part of oaknut
+
+`oaknut-basic` is one package in the
+[oaknut](https://github.com/rob-smallshire/oaknut) monorepo of tools for Acorn
+computer filesystems, files, and formats. It backs the `read_basic` /
+`write_basic` methods of the `oaknut-dfs` and `oaknut-adfs` packages, and is
+usable on its own for `.bas` / `.bbc` files outside a disc image.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{oaknut_basic-12.6.1 → oaknut_basic-12.7.1}/pyproject.toml

@@ -10,16 +10,29 @@ description = "BBC BASIC tokeniser and detokeniser for Acorn 8-bit and 32-bit BA
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
-requires-python = ">=3.10"
+# oaknut-exception uses except* (PEP 654), so requiring it raises this
+# package's Python floor to 3.11.
+requires-python = ">=3.11"
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
 ]
-dependencies = []
+# The tokeniser and de-tokeniser raise categorised errors from the shared
+# oaknut-exception hierarchy, so the CLI boundary can render them without a
+# traceback. That is the package's only runtime dependency.
+dependencies = ["oaknut-exception>=10.0"]
+
+# The `cli` extra pulls the shared CLI toolkit (Click, asyoulikeit, the
+# Acorn text codec and the categorised-error boundary) so this package
+# can offer the standalone `oaknut-basic` command.
+[project.optional-dependencies]
+cli = ["oaknut-cli>=10.0"]
+
+[project.scripts]
+oaknut-basic = "oaknut.basic.cli:cli"
 
 [project.urls]
 Homepage = "https://github.com/rob-smallshire/oaknut/tree/master/packages/oaknut-basic"

oaknut_basic-12.7.1/src/oaknut/basic/__init__.py

@@ -0,0 +1,72 @@
+"""BBC BASIC tokenisation and detokenisation.
+
+Tokenised BBC BASIC is a compact on-disc representation in which
+keywords like ``PRINT`` and ``GOTO`` are replaced with single bytes,
+line numbers are packed at the start of each line, and string
+literals and ``REM`` comments are stored in the Acorn character
+encoding. This module converts between source text and that byte
+representation.
+
+BBC BASIC is a language, not a text encoding — tokenised programs
+are bytecode, not text. The two functions here therefore work in
+``str`` ↔ ``bytes`` pairs and must never be composed with
+``DFSPath.read_text`` / ``write_text`` (which would silently mangle
+the bytecode). The canonical way to move a BASIC program through a
+disc image is ``DFSPath.read_basic`` / ``write_basic``, which wrap
+these functions with the correct load-address default.
+
+Beyond ``oaknut-exception`` — the base layer, whose categorised errors
+the tokeniser and de-tokeniser raise — this module has no runtime
+dependencies on any other oaknut package.
+"""
+
+from __future__ import annotations
+
+from oaknut.basic.detokeniser import detokenise
+from oaknut.basic.exceptions import (
+    AlreadyNumberedError,
+    BASICError,
+    DetokeniseError,
+    InvalidLineLengthError,
+    LineNumberOrderError,
+    LineNumberRangeError,
+    LineTooLongError,
+    MissingLineMarkerError,
+    TokeniseError,
+    TruncatedProgramError,
+    UnnumberedLineError,
+)
+from oaknut.basic.numbering import (
+    DEFAULT_LINE_NUMBER,
+    DEFAULT_LINE_STEP,
+    number_lines,
+)
+from oaknut.basic.tokeniser import tokenise
+
+__version__ = "12.7.1"
+
+# Canonical load addresses for BBC BASIC programs on each host.
+# Programs saved by *SAVE on a real machine use these by default.
+BBC_BASIC_LOAD_ADDRESS = 0x1900
+ELECTRON_BASIC_LOAD_ADDRESS = 0x0E00
+
+__all__ = [
+    "BBC_BASIC_LOAD_ADDRESS",
+    "DEFAULT_LINE_NUMBER",
+    "DEFAULT_LINE_STEP",
+    "ELECTRON_BASIC_LOAD_ADDRESS",
+    "AlreadyNumberedError",
+    "BASICError",
+    "DetokeniseError",
+    "InvalidLineLengthError",
+    "LineNumberOrderError",
+    "LineNumberRangeError",
+    "LineTooLongError",
+    "MissingLineMarkerError",
+    "TokeniseError",
+    "TruncatedProgramError",
+    "UnnumberedLineError",
+    "detokenise",
+    "number_lines",
+    "tokenise",
+]

oaknut_basic-12.7.1/src/oaknut/basic/cli.py

@@ -0,0 +1,279 @@
+"""Click command-line interface for BBC BASIC tools.
+
+A standalone ``oaknut-basic`` entry point in the style of the unified
+``disc`` CLI: Click for command parsing, asyoulikeit for formatted
+output, and the shared :func:`oaknut.exception.handled_errors` boundary
+so categorised errors surface as clean messages rather than tracebacks.
+
+This module imports Click and is loaded only when ``oaknut-basic`` is
+installed with its ``[cli]`` extra; the library core never imports it.
+"""
+
+from __future__ import annotations
+
+import click
+
+from . import __version__
+
+
+class _BasicGroup(click.Group):
+    """Click group applying the oaknut error boundary to every command.
+
+    Wrapping :meth:`invoke` means each subcommand is guarded once, with
+    no per-command decorator: categorised
+    :class:`~oaknut.exception.DataError` /
+    :class:`~oaknut.exception.ConfigurationError` are printed and turned
+    into the matching exit code. ``--debug`` re-raises them with a full
+    traceback for development.
+    """
+
+    def invoke(self, ctx: click.Context):
+        from oaknut.exception import handled_errors
+
+        debug = bool(ctx.params.get("debug", False))
+        with handled_errors(debug=debug):
+            return super().invoke(ctx)
+
+
+@click.group(cls=_BasicGroup)
+@click.version_option(__version__, prog_name="oaknut-basic")
+@click.option(
+    "--debug",
+    is_flag=True,
+    hidden=True,
+    help="Re-raise data and configuration errors with a full traceback.",
+)
+def cli(debug: bool) -> None:  # noqa: ARG001 - read by the group error boundary
+    """Tools for BBC BASIC source and tokenised programs."""
+
+
+def _validate_encoding(ctx: click.Context, param: click.Parameter, value: str) -> str:
+    """Reject an unknown ``--encoding`` with a clean usage error.
+
+    Importing :mod:`oaknut.file` first registers the ``"acorn"`` codec,
+    so it resolves alongside the stdlib encodings.
+    """
+    import codecs
+
+    import oaknut.file  # noqa: F401 - registers the "acorn" codec as a side effect
+
+    try:
+        codecs.lookup(value)
+    except LookupError:
+        raise click.BadParameter(f"unknown encoding: {value!r}") from None
+    return value
+
+
+@cli.command()
+@click.argument(
+    "input_stream",
+    metavar="[INPUT]",
+    type=click.File("rb"),
+    default="-",
+    required=False,
+)
+@click.argument(
+    "output_stream",
+    metavar="[OUTPUT]",
+    type=click.File("wb"),
+    default="-",
+    required=False,
+)
+@click.option(
+    "--encoding",
+    default="utf-8",
+    show_default=True,
+    callback=_validate_encoding,
+    help='Text encoding of INPUT and OUTPUT. Use "acorn" for the BBC '
+    "character set (CR line endings) when writing to a disc image.",
+)
+@click.option(
+    "--start",
+    type=click.IntRange(min=0),
+    default=10,
+    show_default=True,
+    help="Line number given to the first line.",
+)
+@click.option(
+    "--step",
+    type=click.IntRange(min=1),
+    default=10,
+    show_default=True,
+    help="Increment between successive line numbers.",
+)
+def number(input_stream, output_stream, encoding: str, start: int, step: int) -> None:
+    """Prepend ascending line numbers to an unnumbered BBC BASIC program.
+
+    Reads BASIC source text from INPUT and writes the numbered program
+    to OUTPUT. Both default to ``-``: INPUT to standard input, OUTPUT to
+    standard output, so the command works file-to-file ::
+
+        oaknut-basic number menu.bas menu-numbered.bas
+
+    and as a pipe stage between ``disc get`` and ``disc put`` ::
+
+        disc get game.ssd MENU - | oaknut-basic number --encoding acorn | disc put game.ssd MENU -
+
+    Text is read and written in ``--encoding`` (``utf-8`` by default; pass
+    ``acorn`` for the BBC character set). Input line endings are accepted
+    in any of the ``\\n`` / ``\\r`` / ``\\r\\n`` forms; output uses the
+    Acorn-native ``\\r`` under the ``acorn`` encoding and ``\\n``
+    otherwise.
+
+    Line numbering mirrors the BBC's ``AUTO start,step``: internal
+    references such as ``GOTO`` are left untouched, so they must already
+    match the numbering requested here.
+    """
+    import codecs
+
+    from oaknut.basic import number_lines
+    from oaknut.file import decode_text, encode_text
+
+    line_terminator = "\r" if codecs.lookup(encoding).name == "acorn" else "\n"
+    source = decode_text(input_stream.read(), encoding=encoding)
+    numbered = number_lines(source, start=start, step=step)
+    output_stream.write(encode_text(numbered, encoding=encoding, newline=line_terminator))
+
+
+def _source_to_code_points(data: bytes, encoding: str) -> str:
+    """Return the latin-1 code-point view of source text's Acorn bytes.
+
+    The tokeniser treats each character's code point as a raw byte, so
+    the CLI normalises the input encoding to Acorn bytes here. Under the
+    default ``acorn`` encoding the input is already Acorn bytes and is
+    passed through untouched; otherwise it is decoded and re-encoded to
+    the BBC character set.
+    """
+    import codecs
+
+    import oaknut.file  # noqa: F401 - registers the "acorn" codec
+
+    if codecs.lookup(encoding).name == "acorn":
+        acorn_bytes = data
+    else:
+        acorn_bytes = data.decode(encoding).encode("acorn")
+    return acorn_bytes.decode("latin-1")
+
+
+def _listing_to_bytes(listing: str, encoding: str) -> bytes:
+    """Encode a de-tokenised listing into output bytes in *encoding*.
+
+    The listing's characters are Acorn code points separated by ``\\n``.
+    Under ``acorn`` the newlines become the Acorn-native ``\\r``;
+    otherwise the Acorn bytes are transcoded to *encoding*, keeping
+    ``\\n``.
+    """
+    import codecs
+
+    import oaknut.file  # noqa: F401 - registers the "acorn" codec
+
+    if codecs.lookup(encoding).name == "acorn":
+        return listing.replace("\n", "\r").encode("latin-1")
+    return listing.encode("latin-1").decode("acorn").encode(encoding)
+
+
+@cli.command()
+@click.argument(
+    "input_stream",
+    metavar="[INPUT]",
+    type=click.File("rb"),
+    default="-",
+    required=False,
+)
+@click.argument(
+    "output_stream",
+    metavar="[OUTPUT]",
+    type=click.File("wb"),
+    default="-",
+    required=False,
+)
+@click.option(
+    "--encoding",
+    default="acorn",
+    show_default=True,
+    callback=_validate_encoding,
+    help="Text encoding of the INPUT source. Defaults to the BBC character set.",
+)
+@click.option(
+    "--start",
+    type=click.IntRange(min=0),
+    default=None,
+    help="Auto-number from this line (as AUTO would); INPUT must be unnumbered. "
+    "Defaults to 10 when only --step is given.",
+)
+@click.option(
+    "--step",
+    type=click.IntRange(min=1),
+    default=None,
+    help="Auto-numbering increment. Defaults to 10 when only --start is given.",
+)
+def tokenise(
+    input_stream, output_stream, encoding: str, start: int | None, step: int | None
+) -> None:
+    """Tokenise BBC BASIC source text into a stored program.
+
+    Reads numbered BASIC source from INPUT and writes the tokenised
+    program bytes to OUTPUT. Both default to ``-`` (stdin / stdout), so it
+    drops in alongside ``disc put`` ::
+
+        oaknut-basic tokenise menu.bas MENU
+        cat menu.bas | oaknut-basic tokenise | disc put game.ssd MENU -
+
+    Passing --start and/or --step auto-numbers unnumbered source, exactly
+    as typing it under ``AUTO`` would; it is an error to use them on source
+    that already carries line numbers ::
+
+        oaknut-basic tokenise --start 10 unnumbered.bas MENU
+
+    INPUT is read in --encoding (the BBC ``acorn`` character set by default;
+    pass ``utf-8`` for source authored in a modern editor).
+    """
+    from oaknut.basic import tokenise as tokenise_source
+
+    source = _source_to_code_points(input_stream.read(), encoding)
+    output_stream.write(tokenise_source(source, start=start, step=step))
+
+
+@cli.command()
+@click.argument(
+    "input_stream",
+    metavar="[INPUT]",
+    type=click.File("rb"),
+    default="-",
+    required=False,
+)
+@click.argument(
+    "output_stream",
+    metavar="[OUTPUT]",
+    type=click.File("wb"),
+    default="-",
+    required=False,
+)
+@click.option(
+    "--encoding",
+    default="acorn",
+    show_default=True,
+    callback=_validate_encoding,
+    help="Text encoding for the OUTPUT source. Defaults to the BBC character set.",
+)
+def detokenise(input_stream, output_stream, encoding: str) -> None:
+    """De-tokenise a stored BBC BASIC program into source text.
+
+    Reads a tokenised program from INPUT and writes numbered source text
+    to OUTPUT. Both default to ``-`` (stdin / stdout), so it drops in
+    alongside ``disc get`` ::
+
+        oaknut-basic detokenise MENU menu.bas
+        disc get game.ssd MENU - | oaknut-basic detokenise
+
+    OUTPUT is written in --encoding (the BBC ``acorn`` character set with CR
+    line endings by default; pass ``utf-8`` for a host text file).
+    """
+    from oaknut.basic import detokenise as detokenise_program
+
+    listing = detokenise_program(input_stream.read())
+    output_stream.write(_listing_to_bytes(listing, encoding))
+
+
+if __name__ == "__main__":  # pragma: no cover
+    cli()