structtype 0.1.0__tar.gz

structtype-0.1.0/.cibuildwheel.toml

@@ -0,0 +1,4 @@
+[tool.cibuildwheel]
+build = "cp3*"
+skip = ["pp*", "*-manylinux_i686", "*-musllinux*", "*-win32"]
+test-command = "pip install pytest>=9 && pytest {project}/tests"

structtype-0.1.0/AGENTS.md

@@ -0,0 +1,62 @@
+# structtype — AGENTS.md
+
+## Project
+
+Fast struct validation + JSON serialization for Python.
+Core is a monolithic C extension (`src/structtype/_core.c`, ~20K lines).
+No runtime deps.
+
+## Setup
+
+```bash
+uv sync --frozen
+```
+
+## Commands
+
+All commands go through `make`.
+
+| Task | Command |
+|---|---|
+| Unit tests (reinstall + last-failed) | `make test-lf` |
+| Targeted tests | `uv run --reinstall pytest tests/unit/test_json.py -k test_something` |
+| Coverage | `make test-cov` |
+| Build docs | `make docs` |
+| Format | `make format` |
+| Lint | `make ruff-check` |
+| Type check | `make type-check` |
+| All checks | `make check` |
+
+## Conventions
+
+- **88-char lines**, formatted with `ruff format`
+- `ruff check` with rules `E`, `F`, `I`, `W`
+- Private modules/functions prefixed with `_`
+- C code uses `ms_`/`MS_` prefix
+- Type stubs (`.pyi`) alongside public modules
+- Sentinel values: `NODEFAULT`, `UNSET`, `_NoDefault`, `UnsetType`
+
+## Key API
+
+- `structtype.Struct` — base class with config options (frozen, tag, rename, etc.)
+- `structtype.Field` — field constraints (gt, ge, lt, le, min_length, etc.)
+- `structtype.Raw` — lazy JSON passthrough
+- `structtype._inspect.type_info()` / `multi_type_info()` — type introspection
+
+### Struct Methods
+
+- `obj.struct_dump_json()` — serialize to JSON bytes
+- `obj.struct_dump()` — convert to built-in Python types
+- `obj.struct_to_dict()` — shallow field dict
+- `obj.struct_to_tuple()` — shallow field tuple
+- `obj.struct_force_setattr(name, value)` — set attr on frozen struct
+- `obj.struct_check()` — validate field values against types + constraints
+- `cls.struct_validate_json(buf)` — deserialize from JSON
+- `cls.struct_validate_jsonln(buf)` — deserialize newline-delimited JSON to a list of structs
+- `cls.struct_dump_jsonln(items)` — serialize a list of structs as newline-delimited JSON
+- `cls.struct_validate(obj)` — convert built-in types to struct
+
+## Gotchas
+
+- `pytest-randomly` shuffles test order
+- `make test-lf` reinstalls the C extension before running (last-failed first)

structtype-0.1.0/LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2026, Wolfgang Langner
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

structtype-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+prune .devcontainer
+prune .github
+prune benchmarks
+prune docs
+prune examples
+prune scripts
+exclude .*
+include .cibuildwheel.toml

structtype-0.1.0/Makefile

@@ -0,0 +1,93 @@
+.DEFAULT_GOAL := help
+SOURCE_DIR = ./src
+PY_VERSIONS = 3.10 3.11 3.12 3.13 3.14 3.14t 3.15 3.15t
+export UV_MANAGED_PYTHON ?= 1
+
+##@ Build
+.PHONY: build
+build: ## Build
+	uv build
+
+.PHONY: docs
+docs: ## build docs
+	rm -rf .doctrees site
+	uv run --group docs sphinx-build -d .doctrees -b html docs site --fail-on-warning
+
+##@ Quality
+.PHONY: test-cov
+test-cov: ## Run tests with coverage
+	uv run pytest --cov-report=term-missing --cov-config=pyproject.toml --cov=structtype
+
+.PHONY: test-lf
+test-lf: ## Run tests in current Python
+	uv run --reinstall pytest --lf
+
+.PHONY: test-all
+test-all: ## Run tests in all supporte Python versions
+	for py_v in $(PY_VERSIONS); do \
+		uv run --isolated -p $$py_v pytest; \
+	done
+
+.PHONY: check
+check: ## Run all checks
+	-uvx ty check ${SOURCE_DIR}
+	uvx ruff check ${SOURCE_DIR}
+
+.PHONY: ruff-check
+ruff-check: ## Lint using ruff
+	uvx ruff check ${SOURCE_DIR}
+
+.PHONY: type-check
+type-check: ## Type check with
+	-uvx ty check ${SOURCE_DIR}
+	uvx pyrefly check ${SOURCE_DIR}
+
+.PHONY: format
+format: ## Format files using ruff format
+	uvx ruff format ${SOURCE_DIR}
+
+##@ Benchmark
+.PHONY: bench
+bench: ## run benchmarks
+	uv run --group bench benchmarks/bench_compare.py
+	uv run --group bench benchmarks/bench_libs.py
+
+##@ Utility
+.PHONY: clean
+clean: ## Delete all temporary files
+	rm -rf .pytest_cache
+	rm -rf **/.pytest_cache
+	rm -rf .mypy_cache
+	rm -rf .ruff_cache
+	rm -rf __pycache__
+	rm -rf **/__pycache__
+	rm -rf build
+	rm -rf dist
+	rm -f .coverage
+
+.PHONY: install
+install: install-uv ## Install virtual environment
+	uv sync --frozen
+
+.PHONY: install-uv
+install-uv: ## Install uv
+	@command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh
+
+.PHONY: update-uv
+update-uv: ## Update uv
+	uv self update
+
+.PHONY: update-lock
+update-lock: ## Update lockfile
+	uv lock --upgrade
+
+.PHONY: update-python
+update-python: ## Reinstall managed Python versions to latest release
+	for py_v in $(PY_VERSIONS); do \
+		uv python install --reinstall $$py_v ; \
+	done
+
+
+.PHONY: help
+help:  ## Display this help
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make <target>\033[36m\033[0m\n"} /^[a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)

structtype-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: structtype
+Version: 0.1.0
+Summary: Fast Struct type with validation and JSON serialization for Python.
+Maintainer-email: Wolfgang Langner <tds333@mailbox.org>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/tds333/structtype
+Project-URL: Issue Tracker, https://github.com/tds333/structtype/issues
+Project-URL: Source, https://github.com/tds333/structtype
+Keywords: JSON,schema,serialization,struct,validation
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: WebAssembly :: Emscripten
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# structtype
+
+Fast Struct type with validation + JSON serialization for Python.
+
+- **High performance** — 5-60x faster than dataclasses, attrs, or pydantic for common operations
+- **Schema validation** — familiar Python type annotations, enforced at decode time
+- **No runtime dependencies** — built on a monolithic C extension based on msgspec
+- **Rich type support** — nested Structs, dataclasses, TypedDicts, enums, UUID, Decimal, datetime, and more
+- **JSON Schema generation** — auto-generate JSON Schema 2020-12 / OpenAPI 3.1 specs
+
+## Install
+
+```bash
+pip install structtype
+```
+
+```bash
+uv add structtype
+```
+
+Requires Python ≥ 3.10.
+
+## Quick Example
+
+```python
+from structtype import Struct
+
+class User(Struct):
+    name: str
+    groups: set[str] = set()
+    email: str | None = None
+
+alice = User("alice", groups={"admin", "engineering"})
+
+# Serialize to JSON
+alice.struct_dump_json()
+# b'{"name":"alice","groups":["admin","engineering"],"email":null}'
+
+# Deserialize and validate
+User.struct_validate_json(
+    b'{"name":"alice","groups":["admin","engineering"],"email":null}'
+)
+# User(name='alice', groups={"admin", "engineering"}, email=None)
+```
+
+## Documentation
+
+Full documentation is available at **https://tds333.github.io/structtype/**.
+
+## Benchmarks
+
+structtype is as fast as msgspec and about 3-5x faster than pydantic.
+
+## License
+
+New BSD. See the [License File](LICENSE).
+The core is based on the work of Jim Crist-Harif from msgspec.

structtype-0.1.0/README.md

@@ -0,0 +1,57 @@
+# structtype
+
+Fast Struct type with validation + JSON serialization for Python.
+
+- **High performance** — 5-60x faster than dataclasses, attrs, or pydantic for common operations
+- **Schema validation** — familiar Python type annotations, enforced at decode time
+- **No runtime dependencies** — built on a monolithic C extension based on msgspec
+- **Rich type support** — nested Structs, dataclasses, TypedDicts, enums, UUID, Decimal, datetime, and more
+- **JSON Schema generation** — auto-generate JSON Schema 2020-12 / OpenAPI 3.1 specs
+
+## Install
+
+```bash
+pip install structtype
+```
+
+```bash
+uv add structtype
+```
+
+Requires Python ≥ 3.10.
+
+## Quick Example
+
+```python
+from structtype import Struct
+
+class User(Struct):
+    name: str
+    groups: set[str] = set()
+    email: str | None = None
+
+alice = User("alice", groups={"admin", "engineering"})
+
+# Serialize to JSON
+alice.struct_dump_json()
+# b'{"name":"alice","groups":["admin","engineering"],"email":null}'
+
+# Deserialize and validate
+User.struct_validate_json(
+    b'{"name":"alice","groups":["admin","engineering"],"email":null}'
+)
+# User(name='alice', groups={"admin", "engineering"}, email=None)
+```
+
+## Documentation
+
+Full documentation is available at **https://tds333.github.io/structtype/**.
+
+## Benchmarks
+
+structtype is as fast as msgspec and about 3-5x faster than pydantic.
+
+## License
+
+New BSD. See the [License File](LICENSE).
+The core is based on the work of Jim Crist-Harif from msgspec.

structtype-0.1.0/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "structtype"
+description = "Fast Struct type with validation and JSON serialization for Python."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "BSD-3-Clause"
+license-files = [
+  "LICENSE",
+]
+maintainers = [
+  { name = "Wolfgang Langner", email = "tds333@mailbox.org" },
+]
+keywords = [
+  "JSON",
+  "schema",
+  "serialization",
+  "struct",
+  "validation",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: WebAssembly :: Emscripten",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
+]
+dependencies = []
+dynamic = [
+  "version",
+]
+
+[project.urls]
+Homepage = "https://github.com/tds333/structtype"
+"Issue Tracker" = "https://github.com/tds333/structtype/issues"
+Source = "https://github.com/tds333/structtype"
+
+[dependency-groups]
+dev = [
+  "attrs",
+  "coverage",
+  "msgspec",
+  "pydantic; python_version < '3.15'",
+  "pytest>=9",
+  "pytest-coverage>=0.0",
+]
+bench = [
+  "cattrs==25.3.0",
+  "mashumaro==3.17",
+  "msgspec",
+  "orjson==3.11.4",
+  "pydantic==2.12.4",
+  "pysimdjson==7.0.2",
+  "python-rapidjson==1.22",
+  "requests",
+  "ujson==5.11.0",
+]
+docs = [
+  "furo",
+  "ipython",
+  "myst-parser",
+  "sphinx",
+  "sphinx-copybutton",
+  "sphinx-design",
+]
+hooks = [
+  "codespell==2.4.1",
+  "prek>=0.2.13",
+  "ruff==0.15.16",
+]
+
+[build-system]
+requires = [
+  "setuptools>=80",
+  "setuptools-scm>=8",
+]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["structtype"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.exclude-package-data]
+structtype = [
+  "*.c",
+  "*.h",
+]
+
+[tool.setuptools_scm]
+version_file = "src/structtype/_version.py"
+parentdir_prefix_version = "structtype-"
+
+[tool.uv.config-settings]
+editable_mode = "compat"

structtype-0.1.0/setup.cfg

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

structtype-0.1.0/setup.py

@@ -0,0 +1,68 @@
+import os
+import platform
+import sys
+
+from setuptools import setup
+from setuptools.extension import Extension
+
+# Check for 32-bit windows builds, which currently aren't supported. We can't
+# rely on `platform.architecture` here since users can still run 32-bit python
+# builds on 64 bit architectures.
+if sys.platform == "win32" and sys.maxsize == (2**31 - 1):
+    import textwrap
+
+    error = """
+    ====================================================================
+    `structtype` currently doesn't support 32-bit Python windows builds.
+    ====================================================================
+    """
+    print(textwrap.dedent(error))
+    exit(1)
+
+
+SANITIZE = os.environ.get("STRUCTTYPE_SANITIZE", False)
+COVERAGE = os.environ.get("STRUCTTYPE_COVERAGE", False)
+DEBUG = os.environ.get("STRUCTTYPE_DEBUG", SANITIZE or COVERAGE)
+
+extra_compile_args = []
+extra_link_args = []
+if SANITIZE:
+    extra_compile_args.extend(["-fsanitize=address", "-fsanitize=undefined"])
+    extra_link_args.extend(["-lasan", "-lubsan"])
+if COVERAGE:
+    extra_compile_args.append("--coverage")
+    extra_link_args.append("-lgcov")
+if DEBUG:
+    extra_compile_args.extend(["-O0", "-g", "-UNDEBUG"])
+elif sys.platform != "win32":
+    extra_compile_args.extend(["-g0"])
+    if sys.platform == "darwin" and platform.machine().lower() == "arm64":
+        extra_compile_args.extend(["-flto=thin"])
+        extra_link_args.extend(["-flto=thin"])
+
+# from https://py-free-threading.github.io/faq/#im-trying-to-build-a-library-on-windows-but-msvc-says-c-atomic-support-is-not-enabled
+if sys.platform == "win32":
+    extra_compile_args.extend(
+        [
+            "/std:c11",
+            "/experimental:c11atomics",
+        ]
+    )
+
+libraries = []
+if sys.platform != "win32":
+    libraries.append("m")
+
+    ext_modules = [
+        Extension(
+            "structtype._core",
+            [os.path.join("src", "structtype", "_core.c")],
+            libraries=libraries,
+            extra_compile_args=extra_compile_args,
+            extra_link_args=extra_link_args,
+        )
+    ]
+
+setup(
+    ext_modules=ext_modules,
+)

structtype-0.1.0/src/structtype/__init__.py

@@ -0,0 +1,17 @@
+from ._core import (
+    NODEFAULT,
+    UNSET,
+    DecodeError,
+    EncodeError,
+    Field,
+    Raw,
+    Struct,
+    StructConfig,
+    StructMeta,
+    UnsetType,
+    ValidationError,
+)
+from ._adapter import StructAdapter
+from ._inspect import FieldInfo, fields
+from ._json_schema import json_schema, json_schema_dump, json_schema_components
+from ._version import __version__