rumen 0.1.0__tar.gz

rumen-0.1.0/Cargo.lock

@@ -0,0 +1,216 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "libc"
+version = "0.2.191"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
+
+[[package]]
+name = "memchr"
+version = "2.7.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "229ca13b8a15bb0d1487b81ab975bfcd97513416499a8312011b6036e42e0de4"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "70130e2b6dd1ee589a8788026a429561ca5c40fa7a2fa7914c2282eddae24700"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e7ff73c555c286d212d4ce7e5fbda845a973c4f61bd5f160f5f2c3c2a04d1c4"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c46d2e5862c7bb8207e3b639f713dda3c499933444784154c11d013c5a691b60"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38b89f066f2ae72a2aef52d1537ca2fcd104440ebfadee06e97aa90738a25b9b"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.37"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5b9d34b8991d19d98081b46eacdd8eb58c6f2b201139f7c5f643cc155a633af"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rumen"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+ "serde",
+ "serde_json",
+ "thiserror",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.154"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7e9cc8b1b85264074fbcc02a88680c4096b1e47df8f739dceb03bf482f04bd6"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d78c8dee4c7bf0e14673097256fed6142ce9d3b85a408189d07482442145823b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "thiserror"
+version = "2.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09e52cb86a36cede5cb101bf8908837b3e4c6e5e59fe7fd85c23fb56200d189e"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fe5197923287db20a58125f0bc85c062f7f2c892de97b18c356f9efb14b28524"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e91b56cd4cadaeb79bbf1a5645f6b4f8dc5bde8834ad5894a8db35fda9efa1fe"
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

rumen-0.1.0/Cargo.toml

@@ -0,0 +1,23 @@
+[package]
+name = "rumen"
+version = "0.1.0"
+edition = "2021"
+description = "Fumen v115 decoder with optional Python bindings"
+license = "MIT"
+repository = "https://github.com/A-Minos/rumen"
+include = ["src/**/*.rs", "tests/**/*", "LICENSES/*", "Cargo.toml", "Cargo.lock", "pyproject.toml", "rumen.pyi", "/README.md", "/LICENSE"]
+readme = "README.md"
+
+[lib]
+crate-type = ["rlib", "cdylib"]
+
+[features]
+python = ["dep:pyo3"]
+
+[dependencies]
+pyo3 = { version = "0.30.1", optional = true, features = ["abi3-py311"] }
+thiserror = "2.0.21"
+
+[dev-dependencies]
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"

rumen-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shoucandanghehe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rumen-0.1.0/LICENSES/tetris-fumen.txt

@@ -0,0 +1,24 @@
+tetris-fumen 1.1.3 — https://github.com/knewjade/tetris-fumen
+Reference revision: 4a77d0dc52216432227a43847012deed1b2f4536
+
+MIT License
+
+Copyright (c) 2019
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rumen-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: rumen
+Version: 0.1.0
+License-File: LICENSE
+License-File: LICENSES/tetris-fumen.txt
+Summary: Fumen v115 decoder backed by Rust
+License-Expression: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# rumen
+
+**小方块，大吞吐。Rust 干重活，Python 管好用。**
+
+用 Rust 编写的 **fumen v115 解码器**，通过 PyO3 提供 Python 绑定。输入谱面字符串或查看器链接，得到盘面、操作和注释，用来分析谱面、处理训练数据，或者接进你的方块工具。
+
+- 每页独立的 `24 × 10` 盘面快照、方块操作与事件标志，支持注释继承和 Quiz。
+- 紧凑盘面存储、原地转义、Quiz 缓冲区复用，减少重复分配与搬运。
+- Python 支持按页访问、批量整数矩阵和类型提示，解码时释放 GIL。
+
+## Python：几行就够
+
+需要 **Python 3.11+、Rust 工具链和 uv**。以下从源码安装，在仓库根目录执行：
+
+```sh
+uv venv
+uv pip install .
+```
+
+用 `.venv` 中的 Python 运行：
+
+```python
+import rumen
+
+fumen = rumen.parse("v115@ghE8JeAgHvhAAAA")
+page = fumen[0]
+matrix = page.to_matrix()       # list[list[int]]，24 行 × 10 列
+
+for page in fumen:
+    print(page.notes, page.flag.positions())
+
+matrices = fumen.to_matrices()  # list[list[list[int]]]，页 / 行 / 列
+```
+
+`fumen` 支持长度、下标、负索引和迭代。模型属性只读，导出的矩阵是独立的可变列表。
+
+## Rust：直接接上
+
+在消费项目的 `Cargo.toml` 中添加本地依赖，把路径指向这个仓库：
+
+```toml
+[dependencies]
+rumen = { path = "../rumen" }
+```
+
+```rust
+use rumen::DecodeError;
+
+fn main() -> Result<(), DecodeError> {
+    let fumen = rumen::parse("https://fumen.zui.jp/?v115@ghE8JeAgHvhAAAA")?;
+
+    for page in &fumen.pages {
+        println!("{} {:?}", page.notes, page.flag.positions());
+    }
+    Ok(())
+}
+```
+
+`Fumen` 也实现了 `FromStr`。原生 Rust 使用不需要开启 `python` feature。
+
+### 命令行也能用
+
+```sh
+cargo run --release -- 'v115@ghE8JeAgHvhAAAA'
+```
+
+输出完整的 Rust Debug 结构，方便检查谱面。
+
+## 接口约定
+
+- 盘面是当前页操作前的状态，按 `[y][x]` 访问；左上角为 `(0, 0)`，向右、向下递增，`y = 23` 为垃圾行。
+- 矩阵编码 `0..8` 依次对应 `Empty, I, L, O, Z, T, J, S, Garbage`。
+- `flag.location` 与 `flag.positions()` 使用同一套自上而下的坐标。`positions()` 返回方块占据的四个格子，无活动方块时为 `None`；坐标可能超出盘面。
+- `page.notes` 是继承与 Quiz 推进后的可见注释，`page.flag.note` 表示该页是否显式更新了注释。
+- 解码失败时，Rust 返回 `DecodeError`，Python 抛出 `rumen.DecodeError`（`ValueError` 子类）。
+- 目前仅提供 v115 解码，不含编码器。
+
+## 开发
+
+```sh
+cargo fmt --check
+cargo test --all-features --locked
+cargo clippy --all-targets --all-features --locked -- -D warnings
+
+# 先按上文安装 Python 包；以下为 Linux / macOS 路径
+.venv/bin/python -B -m unittest discover -s tests -p test_python.py
+```
+
+## 发布
+
+[Release 工作流](https://github.com/A-Minos/rumen/actions/workflows/Release.yml) 构建 Linux x86_64 / aarch64、macOS x86_64 / arm64、Windows x86_64 的 ABI3 wheel，分别在 CPython 3.11–3.15 上测试，并验证源码包。
+
+推送代码、标签或普通手动运行只做检查。发布 GitHub Release 时，标签须为 `v<Cargo.toml 中的版本>`；全部检查通过后，crates.io 与 PyPI 使用 OIDC 发布同一版本。两端 Trusted Publisher 均绑定 `A-Minos/rumen` 和 `Release.yml`，不设置 Environment 限制。
+
+crates.io 首个版本需在本地 `cargo publish --locked`，之后才能配置 Trusted Publisher。首发时推送对应版本标签，不创建 GitHub Release；手动运行工作流，选择该标签并勾选 `publish_pypi`，只补发 PyPI。
+
+项目采用 [MIT](LICENSE) 许可。协议行为参考 [tetris-fumen](https://github.com/knewjade/tetris-fumen)，相关第三方许可见 [LICENSES/tetris-fumen.txt](LICENSES/tetris-fumen.txt)。
+

rumen-0.1.0/README.md

@@ -0,0 +1,97 @@
+# rumen
+
+**小方块，大吞吐。Rust 干重活，Python 管好用。**
+
+用 Rust 编写的 **fumen v115 解码器**，通过 PyO3 提供 Python 绑定。输入谱面字符串或查看器链接，得到盘面、操作和注释，用来分析谱面、处理训练数据，或者接进你的方块工具。
+
+- 每页独立的 `24 × 10` 盘面快照、方块操作与事件标志，支持注释继承和 Quiz。
+- 紧凑盘面存储、原地转义、Quiz 缓冲区复用，减少重复分配与搬运。
+- Python 支持按页访问、批量整数矩阵和类型提示，解码时释放 GIL。
+
+## Python：几行就够
+
+需要 **Python 3.11+、Rust 工具链和 uv**。以下从源码安装，在仓库根目录执行：
+
+```sh
+uv venv
+uv pip install .
+```
+
+用 `.venv` 中的 Python 运行：
+
+```python
+import rumen
+
+fumen = rumen.parse("v115@ghE8JeAgHvhAAAA")
+page = fumen[0]
+matrix = page.to_matrix()       # list[list[int]]，24 行 × 10 列
+
+for page in fumen:
+    print(page.notes, page.flag.positions())
+
+matrices = fumen.to_matrices()  # list[list[list[int]]]，页 / 行 / 列
+```
+
+`fumen` 支持长度、下标、负索引和迭代。模型属性只读，导出的矩阵是独立的可变列表。
+
+## Rust：直接接上
+
+在消费项目的 `Cargo.toml` 中添加本地依赖，把路径指向这个仓库：
+
+```toml
+[dependencies]
+rumen = { path = "../rumen" }
+```
+
+```rust
+use rumen::DecodeError;
+
+fn main() -> Result<(), DecodeError> {
+    let fumen = rumen::parse("https://fumen.zui.jp/?v115@ghE8JeAgHvhAAAA")?;
+
+    for page in &fumen.pages {
+        println!("{} {:?}", page.notes, page.flag.positions());
+    }
+    Ok(())
+}
+```
+
+`Fumen` 也实现了 `FromStr`。原生 Rust 使用不需要开启 `python` feature。
+
+### 命令行也能用
+
+```sh
+cargo run --release -- 'v115@ghE8JeAgHvhAAAA'
+```
+
+输出完整的 Rust Debug 结构，方便检查谱面。
+
+## 接口约定
+
+- 盘面是当前页操作前的状态，按 `[y][x]` 访问；左上角为 `(0, 0)`，向右、向下递增，`y = 23` 为垃圾行。
+- 矩阵编码 `0..8` 依次对应 `Empty, I, L, O, Z, T, J, S, Garbage`。
+- `flag.location` 与 `flag.positions()` 使用同一套自上而下的坐标。`positions()` 返回方块占据的四个格子，无活动方块时为 `None`；坐标可能超出盘面。
+- `page.notes` 是继承与 Quiz 推进后的可见注释，`page.flag.note` 表示该页是否显式更新了注释。
+- 解码失败时，Rust 返回 `DecodeError`，Python 抛出 `rumen.DecodeError`（`ValueError` 子类）。
+- 目前仅提供 v115 解码，不含编码器。
+
+## 开发
+
+```sh
+cargo fmt --check
+cargo test --all-features --locked
+cargo clippy --all-targets --all-features --locked -- -D warnings
+
+# 先按上文安装 Python 包；以下为 Linux / macOS 路径
+.venv/bin/python -B -m unittest discover -s tests -p test_python.py
+```
+
+## 发布
+
+[Release 工作流](https://github.com/A-Minos/rumen/actions/workflows/Release.yml) 构建 Linux x86_64 / aarch64、macOS x86_64 / arm64、Windows x86_64 的 ABI3 wheel，分别在 CPython 3.11–3.15 上测试，并验证源码包。
+
+推送代码、标签或普通手动运行只做检查。发布 GitHub Release 时，标签须为 `v<Cargo.toml 中的版本>`；全部检查通过后，crates.io 与 PyPI 使用 OIDC 发布同一版本。两端 Trusted Publisher 均绑定 `A-Minos/rumen` 和 `Release.yml`，不设置 Environment 限制。
+
+crates.io 首个版本需在本地 `cargo publish --locked`，之后才能配置 Trusted Publisher。首发时推送对应版本标签，不创建 GitHub Release；手动运行工作流，选择该标签并勾选 `publish_pypi`，只补发 PyPI。
+
+项目采用 [MIT](LICENSE) 许可。协议行为参考 [tetris-fumen](https://github.com/knewjade/tetris-fumen)，相关第三方许可见 [LICENSES/tetris-fumen.txt](LICENSES/tetris-fumen.txt)。

rumen-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["maturin>=1.9.4,<2"]
+build-backend = "maturin"
+
+[project]
+name = "rumen"
+dynamic = ["version"]
+description = "Fumen v115 decoder backed by Rust"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE", "LICENSES/*"]
+
+[tool.maturin]
+features = ["python"]
+bindings = "pyo3"

rumen-0.1.0/rumen.pyi

@@ -0,0 +1,121 @@
+from collections.abc import Iterator
+from typing import ClassVar, SupportsIndex, final
+
+__all__ = [
+    "Block",
+    "ColorScheme",
+    "DecodeError",
+    "Facing",
+    "Flag",
+    "Fumen",
+    "Location",
+    "Page",
+    "ViewMode",
+    "parse",
+]
+
+class DecodeError(ValueError):
+    """A fumen input could not be decoded; the message preserves the Rust error."""
+
+@final
+class Block:
+    Empty: ClassVar[Block]
+    I: ClassVar[Block]
+    L: ClassVar[Block]
+    O: ClassVar[Block]
+    Z: ClassVar[Block]
+    T: ClassVar[Block]
+    J: ClassVar[Block]
+    S: ClassVar[Block]
+    Garbage: ClassVar[Block]
+    def __int__(self) -> int: ...
+    def __eq__(self, other: object, /) -> bool: ...
+    def __hash__(self) -> int: ...
+
+@final
+class Facing:
+    Down: ClassVar[Facing]
+    Right: ClassVar[Facing]
+    Up: ClassVar[Facing]
+    Left: ClassVar[Facing]
+    def __int__(self) -> int: ...
+    def __eq__(self, other: object, /) -> bool: ...
+    def __hash__(self) -> int: ...
+
+@final
+class ColorScheme:
+    GuideLine: ClassVar[ColorScheme]
+    Sega: ClassVar[ColorScheme]
+    def __int__(self) -> int: ...
+    def __eq__(self, other: object, /) -> bool: ...
+    def __hash__(self) -> int: ...
+
+@final
+class ViewMode:
+    Normal: ClassVar[ViewMode]
+    Mini: ClassVar[ViewMode]
+    List: ClassVar[ViewMode]
+    MiniList: ClassVar[ViewMode]
+    def __int__(self) -> int: ...
+    def __eq__(self, other: object, /) -> bool: ...
+    def __hash__(self) -> int: ...
+
+@final
+class Location:
+    """Wire coordinate: x=0..9, y=0..23, with (0, 0) at the top-left."""
+    @property
+    def x(self) -> int: ...
+    @property
+    def y(self) -> int: ...
+    def __eq__(self, other: object, /) -> bool: ...
+    def __hash__(self) -> int: ...
+
+@final
+class Flag:
+    @property
+    def mino(self) -> Block: ...
+    @property
+    def face(self) -> Facing | None: ...
+    @property
+    def location(self) -> Location | None: ...
+    @property
+    def up(self) -> bool: ...
+    @property
+    def mirror(self) -> bool: ...
+    @property
+    def color_scheme(self) -> ColorScheme: ...
+    @property
+    def note(self) -> bool: ...
+    @property
+    def lock(self) -> bool: ...
+    def positions(self) -> list[tuple[int, int]] | None:
+        """The four occupied cells in top-down coordinates, or None for no mino."""
+    def __eq__(self, other: object, /) -> bool: ...
+
+@final
+class Page:
+    @property
+    def flag(self) -> Flag: ...
+    @property
+    def notes(self) -> str:
+        """The resolved comment, including inheritance and quiz progression."""
+    def to_matrix(self) -> list[list[int]]:
+        """Copy the 24x10 field into block codes 0..8, with garbage at row 23."""
+    def __eq__(self, other: object, /) -> bool: ...
+
+@final
+class Fumen:
+    def __len__(self) -> int: ...
+    def __iter__(self) -> Iterator[Page]: ...
+    def __getitem__(self, index: SupportsIndex, /) -> Page:
+        """Copy one page; negative indices count from the end."""
+    def to_matrices(self) -> list[list[list[int]]]:
+        """Copy all fields into page/row/column integer lists, without per-cell calls."""
+    @property
+    def mode(self) -> ViewMode: ...
+    @property
+    def version(self) -> int: ...
+    def __eq__(self, other: object, /) -> bool: ...
+
+def parse(input: str) -> Fumen:
+    """Decode a v115 string or viewer URL; invalid input raises DecodeError."""

rumen-0.1.0/src/block.rs

@@ -0,0 +1,32 @@
+#[cfg_attr(feature = "python", pyo3::pyclass(frozen, eq, hash, module = "rumen"))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
+#[repr(u8)]
+pub enum Block {
+    Empty,
+    I,
+    L,
+    O,
+    Z,
+    T,
+    J,
+    S,
+    Garbage,
+}
+
+impl TryFrom<u8> for Block {
+    type Error = &'static str;
+    fn try_from(value: u8) -> Result<Self, Self::Error> {
+        Ok(match value {
+            0 => Block::Empty,
+            1 => Block::I,
+            2 => Block::L,
+            3 => Block::O,
+            4 => Block::Z,
+            5 => Block::T,
+            6 => Block::J,
+            7 => Block::S,
+            8 => Block::Garbage,
+            _ => return Err("Invalid Block"),
+        })
+    }
+}

rumen-0.1.0/src/coding/base64.rs

@@ -0,0 +1,25 @@
+const DECODE: [u8; 128] = {
+    let alphabet = b"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    let mut table = [u8::MAX; 128];
+    let mut digit = 0;
+    while digit < alphabet.len() {
+        table[alphabet[digit] as usize] = digit as u8;
+        digit += 1;
+    }
+    table
+};
+
+pub(crate) fn decode(ch: char) -> Result<u8, &'static str> {
+    DECODE
+        .get(ch as usize)
+        .copied()
+        .filter(|&digit| digit < 64)
+        .ok_or("Invalid base64 char")
+}
+
+pub(crate) fn little_endian_value(data: &[u8]) -> u32 {
+    data.iter()
+        .enumerate()
+        .map(|(i, &n)| n as u32 * 64_u32.pow(i as u32))
+        .sum()
+}