nyxa-speedups 0.0.1__tar.gz

nyxa_speedups-0.0.1/Cargo.lock

@@ -0,0 +1,345 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "base64"
+version = "0.23.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac07cdecf99051d9a5238b80f35af32cdeba5b336e55d957b318b50137e18da5"
+
+[[package]]
+name = "block-buffer"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d2f6c7dbe95a6ed67ad9f18e57daf93a2f034c524b99fd2b76d18fdfeb6660aa"
+dependencies = [
+ "hybrid-array",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
+
+[[package]]
+name = "cmov"
+version = "0.5.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c9ea0ac24bc397ab3c98583a3c9ba74fa56b09a4449bbe172b9b1ddb016027a"
+
+[[package]]
+name = "const-oid"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a6ef517f0926dd24a1582492c791b6a4818a4d94e789a334894aa15b0d12f55c"
+
+[[package]]
+name = "cpufeatures"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ca28b0ae3115b884660db4118d803791fd6756b6e88f39c0f3f7859060d7566"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ce6e4c961d6cd6c9a86db418387425e8bdeaf05b3c8bc1411e6dca4c252f1453"
+dependencies = [
+ "hybrid-array",
+]
+
+[[package]]
+name = "ctutils"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "03bb0e1cc970d482d121d9a1744999169b69a07470b3d644a7894e53fcaf4574"
+dependencies = [
+ "cmov",
+]
+
+[[package]]
+name = "digest"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f1dd6dbb5841937940781866fa1281a1ff7bd3bf827091440879f9994983d5c2"
+dependencies = [
+ "block-buffer",
+ "const-oid",
+ "crypto-common",
+ "ctutils",
+]
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "foldhash"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77ce24cb58228fbb8aa041425bb1050850ac19177686ea6e0f41a70416f56fdb"
+
+[[package]]
+name = "hashbrown"
+version = "0.17.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed5909b6e89a2db4456e54cd5f673791d7eca6732202bbf2a9cc504fe2f9b84a"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "hmac"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6303bc9732ae41b04cb554b844a762b4115a61bfaa81e3e83050991eeb56863f"
+dependencies = [
+ "digest",
+]
+
+[[package]]
+name = "hybrid-array"
+version = "0.4.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "27f864f10dfb56725ce5ce5472bc52252c8f93a4ab86327122cebf62c5f59a17"
+dependencies = [
+ "typenum",
+]
+
+[[package]]
+name = "indexmap"
+version = "2.14.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cc4e190f5d26ca7051642629da2c52fc03bde85a03197c99408dcd291734c855"
+dependencies = [
+ "equivalent",
+ "hashbrown",
+]
+
+[[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.190"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ce5d3ddc6d3fa000eb1536d85e147bfe31aacaba692ed6a876f95cb7c855be78"
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "nyxa-speedups"
+version = "0.0.1"
+dependencies = [
+ "base64",
+ "hmac",
+ "memchr",
+ "pyo3",
+ "serde_json",
+ "sha2",
+]
+
+[[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.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "700d18fa267b73b9b521fd7e13580e2f446916f176cacee1ab63fcc8191f1655"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7b3fc0c4d08f6bb10e71fe39dfb9e2f59c6eb6854e22ec8092f50c69a4499adb"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfc0b8e19df29aad7086cf977bb0c2a2f143e30567eb113e9cf72b62ca698330"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6100e8a4b5eba53afaa5ed078364851a0b2499c553a44c31026b929049b49dc6"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6143877a16e82b5a727b7127ff4cd86858a24a28d745d72f43e6f227c7b1bdb3"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
+dependencies = [
+ "serde_core",
+]
+
+[[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 3.0.9",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.154"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7e9cc8b1b85264074fbcc02a88680c4096b1e47df8f739dceb03bf482f04bd6"
+dependencies = [
+ "foldhash",
+ "indexmap",
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "sha2"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "446ba717509524cb3f22f17ecc096f10f4822d76ab5c0b9822c5f9c284e825f4"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[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 = "typenum"
+version = "1.20.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

nyxa_speedups-0.0.1/Cargo.toml

@@ -0,0 +1,28 @@
+[package]
+name = "nyxa-speedups"
+version = "0.0.1"
+edition = "2021"
+description = "Optional native accelerators for the Nyxa framework"
+license = "MIT"
+publish = false
+readme = "README.md"
+
+[lib]
+name = "nyxa_speedups"
+crate-type = ["cdylib"]
+
+[dependencies]
+base64 = "0.23.1"
+hmac = "0.13.0"
+memchr = "2.8.3"
+pyo3 = { version = "0.29", features = ["extension-module", "abi3-py313"] }
+serde_json = { version = "1", features = ["preserve_order"] }
+sha2 = "0.11.0"
+
+[profile.release]
+lto = "fat"
+codegen-units = 1
+opt-level = 3
+# macOS 27 dyld rejects cdylibs whose LINKEDIT string pool is only 4-byte
+# aligned after ``strip=debuginfo`` (rust-lang/rust#157750). Keep symbols.
+strip = "none"

nyxa_speedups-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Al-Amin Islam Nerob
+
+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.

nyxa_speedups-0.0.1/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: nyxa-speedups
+Version: 0.0.1
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+License-File: LICENSE
+Summary: Native accelerators for the Nyxa framework (bundled with nyxa by default)
+Author-email: Al-Amin Islam Nerob <alamin@aincoder.com>
+License-Expression: MIT
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Repository, https://github.com/NyxaDev/Nyxa
+
+# nyxa-speedups
+
+Rust accelerators for the Nyxa framework — drop-in native versions of
+the hot paths (routing, headers, query/cookie parsing, multipart,
+cookie signing, URL building, form validation, pagination JSON).
+Bundled with `nyxa` by default; every helper has a pure-Python
+reference in `nyxa._speedups` with identical results.
+
+## Features
+
+- **`Matcher`** — route-tree matcher built by `RouteTree`:
+  `Matcher()`, `add_node() -> id`, `add_static(parent, segment,
+  child)`, `add_param(parent, name, pattern, child)` (compiled regex
+  or `None`), `set_wildcard(parent, child)`, `add_handler(node,
+  methods, route)`, `find(method, path) -> (route, params) | None`.
+- **HTTP parsing** — `parse_query(qs)`, `parse_query_multi(qs)`,
+  `parse_cookies(header)`, `scan_headers(...)`, `encode_headers(...)`,
+  `parse_multipart(body, boundary, max_fields, max_files,
+  max_part_size=None)` (bounded).
+- **`HeaderIndex`** — `header_index(raw)` builds a byte-exact index
+  over ASGI `[(bytes, bytes)]` pairs: `idx.get(name)`, `idx.items()`;
+  plus `flatten_headers(headers)` and `normalize_headers(...)`.
+- **Signed cookies** — `sign_cookie(value, key, timestamp=False)`,
+  `verify_cookie(value, key, max_age=None)` — the same format the
+  session middleware uses.
+- **URLs** — `url_build(...)` for fast path construction.
+- **Validation** — `validate_plan(plan, data)` evaluates compiled
+  `nyxa-forms` rule plans natively; `NATIVE_RULE_IDS` maps rule names
+  to the ids the native engine covers.
+- **Pagination JSON** — `paginate_to_json(rows, meta)` encodes
+  `{"data": rows, "meta": meta}` when every cell is JSON-safe.
+- **Graceful fallback** — each helper returns `None` for inputs it
+  doesn't cover (non-ASCII, quoted cookies, unusual items) and the
+  framework transparently falls back to the Python reference —
+  results are always identical.
+- **Kill switch** — `NYXA_NO_SPEEDUPS=1` forces the Python
+  implementations.
+
+## Install
+
+```bash
+pip install nyxa    # nyxa-speedups (maturin wheel) is bundled by default
+# standalone: pip install nyxa-speedups
+```
+
+No configuration — the framework probes the module at import and
+uses it where available.
+
+## Public API
+
+Module `nyxa_speedups` (native extension):
+
+- **`Matcher`** — the route-tree pyclass (see Features).
+- **`HeaderIndex`** — header-pair index: `get(name) -> str | None`,
+  `items() -> [(name, value)]`.
+- **`header_index(raw)`** — build a `HeaderIndex` or `None`.
+- **`parse_query(qs)`** — `dict[str, str]`, last value wins.
+- **`parse_query_multi(qs)`** — repeated keys collapse to lists.
+- **`parse_cookies(header)`** — `Cookie` header → `dict[str, str]`.
+- **`scan_headers(...)`** / **`encode_headers(...)`** — header
+  scanning/serialization used by request/response paths.
+- **`parse_multipart(body, boundary, max_fields, max_files,
+  max_part_size=None)`** — bounded multipart parse.
+- **`flatten_headers(headers)`** — `str | list` values → wire pairs.
+- **`normalize_headers(...)`** — header map normalization.
+- **`sign_cookie(value, key, timestamp=False)`** → signed string.
+- **`verify_cookie(value, key, max_age=None)`** → payload or `None`.
+- **`url_build(...)`** — fast URL construction.
+- **`validate_plan(plan, data)`** — native rule-plan evaluation or
+  `None` to defer to Python.
+- **`paginate_to_json(rows, meta)`** — JSON bytes or `None`.
+- **`NATIVE_RULE_IDS`** — `dict[str, int]` of rules the native
+  validator covers.
+
+All functions return `None` on uncovered input — callers fall back to
+Python for full semantics.
+
+## Configuration
+
+`NYXA_NO_SPEEDUPS=1` disables all acceleration.
+
+## License
+
+MIT
+

nyxa_speedups-0.0.1/README.md

@@ -0,0 +1,84 @@
+# nyxa-speedups
+
+Rust accelerators for the Nyxa framework — drop-in native versions of
+the hot paths (routing, headers, query/cookie parsing, multipart,
+cookie signing, URL building, form validation, pagination JSON).
+Bundled with `nyxa` by default; every helper has a pure-Python
+reference in `nyxa._speedups` with identical results.
+
+## Features
+
+- **`Matcher`** — route-tree matcher built by `RouteTree`:
+  `Matcher()`, `add_node() -> id`, `add_static(parent, segment,
+  child)`, `add_param(parent, name, pattern, child)` (compiled regex
+  or `None`), `set_wildcard(parent, child)`, `add_handler(node,
+  methods, route)`, `find(method, path) -> (route, params) | None`.
+- **HTTP parsing** — `parse_query(qs)`, `parse_query_multi(qs)`,
+  `parse_cookies(header)`, `scan_headers(...)`, `encode_headers(...)`,
+  `parse_multipart(body, boundary, max_fields, max_files,
+  max_part_size=None)` (bounded).
+- **`HeaderIndex`** — `header_index(raw)` builds a byte-exact index
+  over ASGI `[(bytes, bytes)]` pairs: `idx.get(name)`, `idx.items()`;
+  plus `flatten_headers(headers)` and `normalize_headers(...)`.
+- **Signed cookies** — `sign_cookie(value, key, timestamp=False)`,
+  `verify_cookie(value, key, max_age=None)` — the same format the
+  session middleware uses.
+- **URLs** — `url_build(...)` for fast path construction.
+- **Validation** — `validate_plan(plan, data)` evaluates compiled
+  `nyxa-forms` rule plans natively; `NATIVE_RULE_IDS` maps rule names
+  to the ids the native engine covers.
+- **Pagination JSON** — `paginate_to_json(rows, meta)` encodes
+  `{"data": rows, "meta": meta}` when every cell is JSON-safe.
+- **Graceful fallback** — each helper returns `None` for inputs it
+  doesn't cover (non-ASCII, quoted cookies, unusual items) and the
+  framework transparently falls back to the Python reference —
+  results are always identical.
+- **Kill switch** — `NYXA_NO_SPEEDUPS=1` forces the Python
+  implementations.
+
+## Install
+
+```bash
+pip install nyxa    # nyxa-speedups (maturin wheel) is bundled by default
+# standalone: pip install nyxa-speedups
+```
+
+No configuration — the framework probes the module at import and
+uses it where available.
+
+## Public API
+
+Module `nyxa_speedups` (native extension):
+
+- **`Matcher`** — the route-tree pyclass (see Features).
+- **`HeaderIndex`** — header-pair index: `get(name) -> str | None`,
+  `items() -> [(name, value)]`.
+- **`header_index(raw)`** — build a `HeaderIndex` or `None`.
+- **`parse_query(qs)`** — `dict[str, str]`, last value wins.
+- **`parse_query_multi(qs)`** — repeated keys collapse to lists.
+- **`parse_cookies(header)`** — `Cookie` header → `dict[str, str]`.
+- **`scan_headers(...)`** / **`encode_headers(...)`** — header
+  scanning/serialization used by request/response paths.
+- **`parse_multipart(body, boundary, max_fields, max_files,
+  max_part_size=None)`** — bounded multipart parse.
+- **`flatten_headers(headers)`** — `str | list` values → wire pairs.
+- **`normalize_headers(...)`** — header map normalization.
+- **`sign_cookie(value, key, timestamp=False)`** → signed string.
+- **`verify_cookie(value, key, max_age=None)`** → payload or `None`.
+- **`url_build(...)`** — fast URL construction.
+- **`validate_plan(plan, data)`** — native rule-plan evaluation or
+  `None` to defer to Python.
+- **`paginate_to_json(rows, meta)`** — JSON bytes or `None`.
+- **`NATIVE_RULE_IDS`** — `dict[str, int]` of rules the native
+  validator covers.
+
+All functions return `None` on uncovered input — callers fall back to
+Python for full semantics.
+
+## Configuration
+
+`NYXA_NO_SPEEDUPS=1` disables all acceleration.
+
+## License
+
+MIT

nyxa_speedups-0.0.1/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["maturin>=1.5,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "nyxa-speedups"
+version = "0.0.1"
+description = "Native accelerators for the Nyxa framework (bundled with nyxa by default)"
+readme = "README.md"
+authors = [{ name = "Al-Amin Islam Nerob", email = "alamin@aincoder.com" }]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13"
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: Implementation :: CPython",
+]
+
+[project.urls]
+Repository = "https://github.com/NyxaDev/Nyxa"
+
+[tool.maturin]
+module-name = "nyxa_speedups"
+
+# Rebuild in the parent project's env when the Rust sources change
+[tool.uv]
+cache-keys = [
+    { file = "pyproject.toml" },
+    { file = "Cargo.toml" },
+    { file = "src/**/*.rs" },
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]