oaknut-basic 13.3.1__tar.gz → 13.5.0__tar.gz

{oaknut_basic-13.3.1/src/oaknut_basic.egg-info → oaknut_basic-13.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oaknut-basic
-Version: 13.3.1
+Version: 13.5.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
@@ -92,7 +92,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 +130,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 +166,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.3.1 → oaknut_basic-13.5.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.3.1 → oaknut_basic-13.5.0}/src/oaknut/basic/__init__.py

@@ -81,7 +81,7 @@ from oaknut.basic.tokens import (
     TOKEN_TO_KEYWORD,
 )
 
-__version__ = "13.3.1"
+__version__ = "13.5.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.3.1 → oaknut_basic-13.5.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.3.1 → oaknut_basic-13.5.0/src/oaknut_basic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oaknut-basic
-Version: 13.3.1
+Version: 13.5.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
@@ -92,7 +92,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 +130,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 +166,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