oaknut-basic 13.4.0__tar.gz → 13.6.0__tar.gz

{oaknut_basic-13.4.0/src/oaknut_basic.egg-info → oaknut_basic-13.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oaknut-basic
-Version: 13.4.0
+Version: 13.6.0
 Summary: BBC BASIC tools: program tokeniser/de-tokeniser and PRINT#/INPUT# data-file reader/writer
 Author-email: Robert Smallshire <robert@smallshire.org.uk>
 License-Expression: MIT
@@ -9,10 +9,9 @@ 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
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: oaknut-exception>=10.0
@@ -92,7 +91,8 @@ Options:
   --help     Show this message and exit.
 
 Commands:
-  data        Read and write BBC BASIC data files.
+  data        Read and write BBC BASIC data files...
+  detect      Identify whether each FILE is a tokenised BBC BASIC program.
   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.
@@ -129,11 +129,21 @@ Programs are handled by the functions `tokenise`, `detokenise`, and
 `number_lines`, all importable from `oaknut.basic`:
 
 ```python
-from oaknut.basic import tokenise, detokenise
+from oaknut.basic import detokenise, tokenise
 
 program = tokenise('10 PRINT "HELLO"\n20 GOTO 10\n')  # str -> bytes
 listing = detokenise(program)  # bytes -> str
 assert tokenise(detokenise(program)) == program  # byte-exact
+print(program.hex(" "))
+print(listing, end="")
+```
+
+Output:
+
+```text
+0d 00 0a 0e 20 f1 20 22 48 45 4c 4c 4f 22 0d 00 14 0b 20 e5 20 8d 54 4a 40 0d ff
+10 PRINT "HELLO"
+20 GOTO 10
 ```
 
 When the program lives in a disc image, prefer the path-object wrappers
@@ -155,8 +165,16 @@ with datafile.open("scores.dat", "w") as f:
     f.write(3.5)  # float -> real record
 
 with datafile.open("scores.dat", "r") as f:
-    for value in f:  # yields "ALICE", 42, 3.5
-        print(value)
+    for value in f:
+        print(repr(value))
+```
+
+Output:
+
+```text
+'ALICE'
+42
+3.5
 ```
 
 Strings use the BBC `acorn` character set by default, and reals convert through

{oaknut_basic-13.4.0 → oaknut_basic-13.6.0}/README.md

@@ -68,7 +68,8 @@ Options:
   --help     Show this message and exit.
 
 Commands:
-  data        Read and write BBC BASIC data files.
+  data        Read and write BBC BASIC data files...
+  detect      Identify whether each FILE is a tokenised BBC BASIC program.
   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.
@@ -105,11 +106,21 @@ Programs are handled by the functions `tokenise`, `detokenise`, and
 `number_lines`, all importable from `oaknut.basic`:
 
 ```python
-from oaknut.basic import tokenise, detokenise
+from oaknut.basic import detokenise, tokenise
 
 program = tokenise('10 PRINT "HELLO"\n20 GOTO 10\n')  # str -> bytes
 listing = detokenise(program)  # bytes -> str
 assert tokenise(detokenise(program)) == program  # byte-exact
+print(program.hex(" "))
+print(listing, end="")
+```
+
+Output:
+
+```text
+0d 00 0a 0e 20 f1 20 22 48 45 4c 4c 4f 22 0d 00 14 0b 20 e5 20 8d 54 4a 40 0d ff
+10 PRINT "HELLO"
+20 GOTO 10
 ```
 
 When the program lives in a disc image, prefer the path-object wrappers
@@ -131,8 +142,16 @@ with datafile.open("scores.dat", "w") as f:
     f.write(3.5)  # float -> real record
 
 with datafile.open("scores.dat", "r") as f:
-    for value in f:  # yields "ALICE", 42, 3.5
-        print(value)
+    for value in f:
+        print(repr(value))
+```
+
+Output:
+
+```text
+'ALICE'
+42
+3.5
 ```
 
 Strings use the BBC `acorn` character set by default, and reals convert through

{oaknut_basic-13.4.0 → oaknut_basic-13.6.0}/pyproject.toml

@@ -10,13 +10,10 @@ description = "BBC BASIC tools: program tokeniser/de-tokeniser and PRINT#/INPUT#
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
-# oaknut-exception uses except* (PEP 654), so requiring it raises this
-# package's Python floor to 3.11.
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
 ]

{oaknut_basic-13.4.0 → oaknut_basic-13.6.0}/src/oaknut/basic/__init__.py

@@ -81,7 +81,7 @@ from oaknut.basic.tokens import (
     TOKEN_TO_KEYWORD,
 )
 
-__version__ = "13.4.0"
+__version__ = "13.6.0"
 
 # Canonical load addresses for BBC BASIC programs on each host.
 # Programs saved by *SAVE on a real machine use these by default.

{oaknut_basic-13.4.0 → oaknut_basic-13.6.0}/src/oaknut/basic/cli.py

@@ -11,6 +11,8 @@ installed with its ``[cli]`` extra; the library core never imports it.
 
 from __future__ import annotations
 
+import sys
+
 import click
 from asyoulikeit.cli import report_output
 from oaknut.cli.help import use_plain_help
@@ -358,7 +360,7 @@ def detect(ctx: click.Context, inputs, quiet: bool) -> None:
     """
     from oaknut.basic import detect as detect_blob
 
-    streams = inputs if inputs else (click.get_binary_stream("stdin"),)
+    streams = inputs if inputs else (sys.stdin.buffer,)
     all_basic = True
     for stream in streams:
         result = detect_blob(stream.read())

{oaknut_basic-13.4.0 → oaknut_basic-13.6.0/src/oaknut_basic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oaknut-basic
-Version: 13.4.0
+Version: 13.6.0
 Summary: BBC BASIC tools: program tokeniser/de-tokeniser and PRINT#/INPUT# data-file reader/writer
 Author-email: Robert Smallshire <robert@smallshire.org.uk>
 License-Expression: MIT
@@ -9,10 +9,9 @@ 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
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: oaknut-exception>=10.0
@@ -92,7 +91,8 @@ Options:
   --help     Show this message and exit.
 
 Commands:
-  data        Read and write BBC BASIC data files.
+  data        Read and write BBC BASIC data files...
+  detect      Identify whether each FILE is a tokenised BBC BASIC program.
   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.
@@ -129,11 +129,21 @@ Programs are handled by the functions `tokenise`, `detokenise`, and
 `number_lines`, all importable from `oaknut.basic`:
 
 ```python
-from oaknut.basic import tokenise, detokenise
+from oaknut.basic import detokenise, tokenise
 
 program = tokenise('10 PRINT "HELLO"\n20 GOTO 10\n')  # str -> bytes
 listing = detokenise(program)  # bytes -> str
 assert tokenise(detokenise(program)) == program  # byte-exact
+print(program.hex(" "))
+print(listing, end="")
+```
+
+Output:
+
+```text
+0d 00 0a 0e 20 f1 20 22 48 45 4c 4c 4f 22 0d 00 14 0b 20 e5 20 8d 54 4a 40 0d ff
+10 PRINT "HELLO"
+20 GOTO 10
 ```
 
 When the program lives in a disc image, prefer the path-object wrappers
@@ -155,8 +165,16 @@ with datafile.open("scores.dat", "w") as f:
     f.write(3.5)  # float -> real record
 
 with datafile.open("scores.dat", "r") as f:
-    for value in f:  # yields "ALICE", 42, 3.5
-        print(value)
+    for value in f:
+        print(repr(value))
+```
+
+Output:
+
+```text
+'ALICE'
+42
+3.5
 ```
 
 Strings use the BBC `acorn` character set by default, and reals convert through