qsln-py 1.0.0__tar.gz

qsln_py-1.0.0/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: qsln-py
+Version: 1.0.0
+Summary: Quick Scratch List Notation
+Author: bddjr
+License-Expression: Unlicense
+Project-URL: Homepage, https://github.com/bddjr/QSLN
+Project-URL: Repository, https://github.com/bddjr/QSLN.git
+Keywords: qsln,scratch
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# QSLN
+
+Quick Scratch List Notation (Python implementation)
+
+About QSLN specification: https://github.com/bddjr/QSLN
+
+## Installation
+
+```bash
+pip install qsln-py
+```
+
+## Usage
+
+```python
+import qsln
+
+# Serialize
+encoded = qsln.stringify([["a", "b"], ["cd", "ef"]])
+print(encoded)
+# => "01a01b;02cd02ef;"
+
+# Deserialize
+decoded = qsln.parse("01a01b;02cd02ef;")
+print(decoded)
+# => [["a", "b"], ["cd", "ef"]]
+```
+
+> **Note**: `parse` raises a `SyntaxError` on malformed or truncated inputs.
+
+## 📄 License
+
+This project is released into the public domain under [The Unlicense](https://unlicense.org).
+
+The "Scratch" name is a trademark of the Scratch Foundation.

qsln_py-1.0.0/README.md

@@ -0,0 +1,35 @@
+# QSLN
+
+Quick Scratch List Notation (Python implementation)
+
+About QSLN specification: https://github.com/bddjr/QSLN
+
+## Installation
+
+```bash
+pip install qsln-py
+```
+
+## Usage
+
+```python
+import qsln
+
+# Serialize
+encoded = qsln.stringify([["a", "b"], ["cd", "ef"]])
+print(encoded)
+# => "01a01b;02cd02ef;"
+
+# Deserialize
+decoded = qsln.parse("01a01b;02cd02ef;")
+print(decoded)
+# => [["a", "b"], ["cd", "ef"]]
+```
+
+> **Note**: `parse` raises a `SyntaxError` on malformed or truncated inputs.
+
+## 📄 License
+
+This project is released into the public domain under [The Unlicense](https://unlicense.org).
+
+The "Scratch" name is a trademark of the Scratch Foundation.

qsln_py-1.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "qsln-py"
+version = "1.0.0"
+description = "Quick Scratch List Notation"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "Unlicense"
+authors = [{ name = "bddjr" }]
+keywords = ["qsln", "scratch"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://github.com/bddjr/QSLN"
+Repository = "https://github.com/bddjr/QSLN.git"
+
+[tool.setuptools]
+py-modules = ["qsln"]

qsln_py-1.0.0/qsln.py

@@ -0,0 +1,83 @@
+# [QSLN] Quick Scratch List Notation
+# Author: bddjr
+# License: The Unlicense
+
+from collections.abc import Iterable
+import sys
+from typing import Any
+
+__all__ = ["stringify", "parse"]
+
+HEX = "0123456789abcdef"
+ErrUnexpectedEndOfInput = "Unexpected end of input"
+UTF16_CODEC = "utf-16le" if sys.byteorder == "little" else "utf-16be"
+
+
+def stringify(lists: Iterable[Iterable[Any]]) -> str:
+    """Serialize a 2D iterable of strings into a QSLN string."""
+    out: list[str] = []
+    for l in lists:
+        for v in l:
+            if not isinstance(v, str):
+                v = str(v)
+            u16_len = len(v.encode(UTF16_CODEC)) >> 1
+            l_str = str(u16_len)
+            out.append(HEX[len(l_str) - 1])
+            out.append(l_str)
+            out.append(v)
+        out.append(";")
+    return "".join(out)
+
+
+def parse(qsln: str) -> list[list[str]]:
+    """Parse a QSLN string into a 2D list of strings."""
+    if not isinstance(qsln, str):
+        qsln = str(qsln)
+    if not qsln:
+        raise SyntaxError(ErrUnexpectedEndOfInput)
+
+    raw = qsln.encode(UTF16_CODEC)
+    u16 = memoryview(raw).cast("H")
+    length = len(u16)
+    out: list[list[str]] = []
+    ls: list[str] = []
+    i = 0
+    while True:
+        n = u16[i]
+        # ';'
+        if n == 59:
+            out.append(ls)
+            i += 1
+            if i == length:
+                return out
+            ls = []
+            continue
+
+        j = i + 1
+        if 48 <= n <= 57:
+            # 0-9
+            i += n - 46
+        else:
+            # [A-Fa-f]
+            masked = n & -33
+            if 65 <= masked <= 70:
+                i += masked - 53
+            else:
+                raise SyntaxError(f"Unexpected token '{chr(n)}' at position {i}")
+
+        if i >= length:
+            raise SyntaxError(ErrUnexpectedEndOfInput)
+
+        n = 0
+        while j < i:
+            c = u16[j] - 48
+            if c < 0 or c > 9:
+                raise SyntaxError(f"Unexpected token '{chr(u16[j])}' at position {j}")
+            n = n * 10 + c
+            j += 1
+
+        i += n
+        if i >= length:
+            raise SyntaxError(ErrUnexpectedEndOfInput)
+
+        ls.append(u16[j:i].tobytes().decode(UTF16_CODEC))

qsln_py-1.0.0/qsln_py.egg-info/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: qsln-py
+Version: 1.0.0
+Summary: Quick Scratch List Notation
+Author: bddjr
+License-Expression: Unlicense
+Project-URL: Homepage, https://github.com/bddjr/QSLN
+Project-URL: Repository, https://github.com/bddjr/QSLN.git
+Keywords: qsln,scratch
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# QSLN
+
+Quick Scratch List Notation (Python implementation)
+
+About QSLN specification: https://github.com/bddjr/QSLN
+
+## Installation
+
+```bash
+pip install qsln-py
+```
+
+## Usage
+
+```python
+import qsln
+
+# Serialize
+encoded = qsln.stringify([["a", "b"], ["cd", "ef"]])
+print(encoded)
+# => "01a01b;02cd02ef;"
+
+# Deserialize
+decoded = qsln.parse("01a01b;02cd02ef;")
+print(decoded)
+# => [["a", "b"], ["cd", "ef"]]
+```
+
+> **Note**: `parse` raises a `SyntaxError` on malformed or truncated inputs.
+
+## 📄 License
+
+This project is released into the public domain under [The Unlicense](https://unlicense.org).
+
+The "Scratch" name is a trademark of the Scratch Foundation.

qsln_py-1.0.0/qsln_py.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+qsln.py
+qsln_py.egg-info/PKG-INFO
+qsln_py.egg-info/SOURCES.txt
+qsln_py.egg-info/dependency_links.txt
+qsln_py.egg-info/top_level.txt

qsln_py-1.0.0/qsln_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

qsln_py-1.0.0/qsln_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+qsln

qsln_py-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+