structtype 0.2.0__tar.gz → 0.4.0__tar.gz

structtype-0.4.0/.opencode/opencode.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    ".opencode/plugins/graphify.js"
+  ]
+}

structtype-0.4.0/.opencode/plugins/graphify.js

@@ -0,0 +1,30 @@
+// graphify OpenCode plugin
+// Injects a knowledge graph reminder before bash tool calls when the graph exists.
+//
+// IMPORTANT: keep the reminder string free of backticks and $(...) constructs.
+// The hook prepends `echo "<reminder>" && <cmd>` to the user's bash command;
+// backticks inside the double-quoted echo trigger bash command substitution,
+// which both corrupts tool output and silently executes the very graphify
+// command we are only suggesting. Plain words render fine in opencode's TUI.
+import { existsSync } from "fs";
+import { join } from "path";
+
+export const GraphifyPlugin = async ({ directory }) => {
+  let reminded = false;
+
+  return {
+    "tool.execute.before": async (input, output) => {
+      if (reminded) return;
+      if (!existsSync(join(directory, "graphify-out", "graph.json"))) return;
+
+      if (input.tool === "bash") {
+        // ';' not '&&' — Windows PowerShell 5.1 rejects '&&' as a statement
+        // separator, breaking the first bash command of the session (#1646).
+        output.args.command =
+          'echo "[graphify] knowledge graph at graphify-out/. For focused questions, run graphify query with your question (scoped subgraph, usually much smaller than GRAPH_REPORT.md) instead of grepping raw files. Read GRAPH_REPORT.md only for broad architecture context." ; ' +
+          output.args.command;
+        reminded = true;
+      }
+    },
+  };
+};

{structtype-0.2.0 → structtype-0.4.0}/AGENTS.md

@@ -19,7 +19,7 @@ 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` |
+| Targeted tests | `uv run --reinstall pytest tests/test_json.py -k test_something` |
 | Coverage | `make test-cov` |
 | Build docs | `make docs` |
 | Format | `make format` |
@@ -35,6 +35,7 @@ All commands go through `make`.
 - C code uses `ms_`/`MS_` prefix
 - Type stubs (`.pyi`) alongside public modules
 - Sentinel values: `NODEFAULT`, `UNSET`, `_NoDefault`, `UnsetType`
+- never do git commit
 
 ## Key API
 
@@ -48,8 +49,7 @@ All commands go through `make`.
 
 - `obj.struct_dump_json(*, enc_hook=None, decimal_format=None, uuid_format=None, order=None)` — serialize to JSON bytes
 - `obj.struct_dump()` — convert to built-in Python types (uses `encode_name` for keys)
-- `obj.struct_force_setattr(name, value)` — set attr on frozen struct
-- `obj.struct_validate_self(*, strict=True, dec_hook=None)` — validate field values against types + constraints
+- `obj.struct_validate_self()` — validate field values against types + constraints
 - `cls.struct_validate_json(buf, *, strict=True, dec_hook=None)` — deserialize from JSON
 - `cls.struct_validate(obj, *, strict=True, from_attributes=False, dec_hook=None)` — convert built-in types to struct
 
@@ -62,3 +62,16 @@ Struct instances support the mapping protocol:
 ## Gotchas
 
 - `make test-lf` reinstalls the C extension before running (last-failed first)
+
+## graphify
+
+This project has a knowledge graph at graphify-out/ with god nodes, community structure, and cross-file relationships.
+
+When the user types `/graphify`, use the installed graphify skill or instructions before doing anything else.
+
+Rules:
+- For codebase questions, first run `graphify query "<question>"` when graphify-out/graph.json exists. Use `graphify path "<A>" "<B>"` for relationships and `graphify explain "<concept>"` for focused concepts. These return a scoped subgraph, usually much smaller than GRAPH_REPORT.md or raw grep output.
+- Dirty graphify-out/ files are expected after hooks or incremental updates; dirty graph files are not a reason to skip graphify. Only skip graphify if the task is about stale or incorrect graph output, or the user explicitly says not to use it.
+- If graphify-out/wiki/index.md exists, use it for broad navigation instead of raw source browsing.
+- Read graphify-out/GRAPH_REPORT.md only for broad architecture review or when query/path/explain do not surface enough context.
+- After modifying code, run `graphify update .` to keep the graph current (AST-only, no API cost).

{structtype-0.2.0 → structtype-0.4.0}/MANIFEST.in

@@ -5,4 +5,3 @@ prune docs
 prune examples
 prune scripts
 exclude .*
-include .cibuildwheel.toml

{structtype-0.2.0 → structtype-0.4.0}/Makefile

@@ -13,6 +13,14 @@ docs: ## build docs
 	rm -rf .doctrees site
 	uv run --group docs sphinx-build -d .doctrees -b html docs site --fail-on-warning
 
+.PHONY: docs-serve
+docs-serve: ## Open built docs in browser
+	uv run python -m webbrowser site/index.html
+
+.PHONY: wheels
+wheels: ## build wheels
+	uvx --from cibuildwheel==4.2.0 cibuildwheel
+
 ##@ Quality
 .PHONY: test-cov
 test-cov: ## Run tests with coverage
@@ -32,6 +40,26 @@ test-all: ## Run tests in all supporte Python versions
 		uv run --isolated -p $$py_v pytest; \
 	done
 
+UNAME_S := $(shell uname -s)
+ifeq ($(UNAME_S),Darwin)
+ASAN_RUNTIME := $(shell clang --print-file-name=libclang_rt.asan_osx_dynamic.dylib)
+SANITIZE_PRELOAD := DYLD_INSERT_LIBRARIES=$(ASAN_RUNTIME)
+else
+ASAN_RUNTIME := $(shell gcc --print-file-name=libasan.so)
+SANITIZE_PRELOAD := LD_PRELOAD=$(ASAN_RUNTIME)
+endif
+
+DEBUG_PY ?= 3.14+debug
+DEBUG_VENV = .venv-debug
+
+.PHONY: test-debug
+test-debug: ## Build core with Py_DEBUG + ASan/UBSan + debug allocator and run all tests
+	uv venv --clear --python $(DEBUG_PY) $(DEBUG_VENV)
+	STRUCTTYPE_SANITIZE=1 uv pip install --python $(DEBUG_VENV) --reinstall --no-cache --group dev -e .
+	$(SANITIZE_PRELOAD) STRUCTTYPE_ASAN_RUNTIME=$(ASAN_RUNTIME) ASAN_OPTIONS=detect_leaks=0 \
+		PYTHONMALLOC=debug PYTHONFAULTHANDLER=1 PYTHONDEVMODE=1 \
+		$(DEBUG_VENV)/bin/python -m pytest
+
 .PHONY: check
 check: ## Run all checks
 	-uvx ty check ${SOURCE_DIR}

{structtype-0.2.0/src/structtype.egg-info → structtype-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: structtype
-Version: 0.2.0
+Version: 0.4.0
 Summary: Fast Struct type with validation and JSON serialization for Python.
 Maintainer-email: Wolfgang Langner <tds333@mailbox.org>
 License-Expression: BSD-3-Clause

structtype-0.4.0/graphify-out/.graphify_labels.json

@@ -0,0 +1,108 @@
+{
+  "0": "_core.c",
+  "1": "test_schema.py",
+  "2": "TypeNodeCollectState",
+  "3": "TypeNode",
+  "4": "EncoderState",
+  "5": "test_inspect.py",
+  "6": "_inspect.py",
+  "7": "ryu.h",
+  "8": "JSONDecoderState",
+  "9": "PathNode",
+  "10": "parametrize",
+  "11": "Field",
+  "12": "StructspecState",
+  "13": "test_struct_meta.py",
+  "14": "unicode_str_and_size",
+  "15": "test_json.py",
+  "16": "visitproc",
+  "17": "test_struct.py",
+  "18": "parametrize",
+  "19": "TestDict",
+  "20": "test_check.py",
+  "21": "test_msgspec.py",
+  "22": "structtype/__init__.py",
+  "23": "test_constraints.py",
+  "24": "test_pydantic.py",
+  "25": "TestRename",
+  "26": "StructAdapter",
+  "27": "TestStruct",
+  "28": "TestDatetime",
+  "29": "TestEncoderMisc",
+  "30": "multi_type_info",
+  "31": "PyObject",
+  "32": "TestStructParameterOrdering",
+  "33": "bench_libs.py",
+  "34": "TestGetClassAnnotations",
+  "35": "_utils.py",
+  "36": "temp_module",
+  "37": "replace",
+  "38": "_Lookup_OnMissing",
+  "39": "test_raw.py",
+  "40": "TestRaw",
+  "41": "bench_gc.py",
+  "42": "atof.h",
+  "43": "Rand",
+  "44": "TestBoolAndNone",
+  "45": "TestSetAttr",
+  "46": "TestStructGC",
+  "47": "structtype — AGENTS.md",
+  "48": "TestStrings",
+  "49": "TestDecodeFunction",
+  "50": "TestSequences",
+  "51": "TestOrderAndEq",
+  "52": "structtype_geojson.py",
+  "53": ".roundtrip",
+  "54": "TestStructArray",
+  "55": "TestRepr",
+  "56": "TestEncodeFunction",
+  "57": "TestInspectFields",
+  "58": "strbuilder_build",
+  "59": "test_cpylint.py",
+  "60": "test_free_threading.py",
+  "61": "utils.py",
+  "62": "structtype",
+  "63": "TestDecimal",
+  "64": "test_JSONTestSuite.py",
+  "65": "TestMixins",
+  "66": "LiteralType",
+  "67": "TestFloatConstraints",
+  "68": "TestStructArrayUnion",
+  "69": "TestPostInit",
+  "70": "bench_structs.py",
+  "71": "Changelog",
+  "72": "as_tuple",
+  "73": "EnumType",
+  "74": "TestSignature",
+  "75": "graphify.js",
+  "76": "Struct_get_index",
+  "77": "generate_atof_consts.py",
+  "78": "BoolType",
+  "79": ".__init__",
+  "80": ".struct_dump_json",
+  "81": ".struct_validate",
+  "82": ".struct_dump",
+  "83": "__dir__",
+  "84": ".includes_none",
+  "85": "MS_INLINE",
+  "86": "dump_obj",
+  "87": "test_python_validate_pydantic",
+  "88": "structtype",
+  "89": "setup.py",
+  "90": "tests/__init__.py",
+  "91": "json_encode_dataclass",
+  "92": "PyTypeObject",
+  "93": "structtype_get_global_state",
+  "94": "Encoder",
+  "95": "ms_passes_big_int_constraints",
+  "96": "typenode_collect_validate_literals",
+  "97": "structtype_get_state",
+  "98": "JSONDecoder_decode",
+  "99": "typenode_collect_constraints",
+  "100": "StructMetaObject",
+  "101": "TestStrConstraints",
+  "102": "opencode.json",
+  "103": ".struct_validate_json",
+  "104": "test_dump_builtin_types",
+  "105": "test_pydantic_with_default"
+}

structtype-0.4.0/graphify-out/.graphify_labels.json.sig

@@ -0,0 +1 @@
+{"0": "d643c6cb13aaab4d", "1": "30cda3f2c9f4b116", "2": "a6d0fb59a6a2b804", "3": "8d971e8caf15c483", "4": "8566e5b3097372de", "5": "8ccf9a8216edc743", "6": "d4af17cc9de752b0", "7": "e9aa28c8ea371408", "8": "c7be1f55cc29cdc5", "9": "a86c4cdc8ba7141e", "10": "2acd3bf8d9823ee3", "11": "8b16559f248d3529", "12": "d33fcbc65b320f4d", "13": "106b80706f3e6407", "14": "898e2a4cf01ac53c", "15": "ce38cd6eac91f798", "16": "325cd5c4323c7131", "17": "d6946e44a13605fe", "18": "4f79efe7f9f1b95b", "19": "e6bbe969de75b939", "20": "f6f0ca8580c58960", "21": "bd118bda83700a30", "22": "c8aee1190bb46ed4", "23": "f07f0c3bca2e2c5e", "24": "d42c0071d964e0f0", "25": "0ea7f4ccd262c5f7", "26": "0551132be5589e8a", "27": "79ae2f66fd3d4cab", "28": "35d060ddf8835410", "29": "c06eaf5d4c15c91c", "30": "47a53cf0d19b9b25", "31": "2d3cd5fc40831866", "32": "1f2e529287de1129", "33": "61732978d44bfd1e", "34": "1532479ab8bd3527", "35": "043c7680510ea7b1", "36": "8db47582fd26984e", "37": "353f0a389c6cd66d", "38": "f6b36bbcc3d8ea00", "39": "80d3d56a2deec119", "40": "33fe916671500430", "41": "6e8fc4efdd69a5de", "42": "18f1cb0d9dd50899", "43": "ff23f8ee8952f749", "44": "d25dd65e4c5a6eb9", "45": "874874871833ac97", "46": "80f99cc1e0e70d07", "47": "d8c95f051295545a", "48": "4b5151ba8559d935", "49": "9c627f8e884be79f", "50": "74aa1435cbeb0f15", "51": "a294de0f391e4129", "52": "da025785d2e0def1", "53": "d30dd5e1985345f1", "54": "be70274335b469cb", "55": "da1c5973a1f91f99", "56": "b80ceeac4e9d9744", "57": "84c08d48d4a8c724", "58": "241ed0f17056465d", "59": "081ddb1790597c81", "60": "bb4f879e81ba01be", "61": "f21b78d8d6f651af", "62": "a5c6b49ab3c3ddd5", "63": "8e17b78f5c7aeb3a", "64": "f9e3877e16cd2034", "65": "ba4157cdcbddbfc7", "66": "6d1fbf1ddff278f1", "67": "40152a379f07657b", "68": "0a0dfcc47ee8b84d", "69": "96278a3510f58d7b", "70": "6383729bf4e402b7", "71": "e8428b8467ea6788", "72": "7772bb812f6b2b4e", "73": "f50c76eb2822aab3", "74": "3e06f29c6af9c475", "75": "f49f271aca1ae6ea", "76": "9f3e513e909e330f", "77": "b288304b40cb9e39", "78": "7bee85e51cca5a92", "79": "f934926580f53f49", "80": "eddf0ecb3f2cd816", "81": "a12fe16947302b9b", "82": "55d8fb4ea2c4932b", "83": "1c14db22800a9721", "84": "39168562a3e74dc9", "85": "799421abaca69864", "86": "f5e2387512027e5d", "87": "a3f65c0563c93809", "88": "82f5347c5f1fde6c", "89": "e76aec1367ea2252", "90": "43bbf35b96423d46", "91": "b839fd4b64b048cc", "92": "a64dcaa27dde0bd3", "93": "5decd6d5db678576", "94": "ffd6ed1437af78cb", "95": "b819762cf2d2b450", "96": "f47d1d0d20e1f658", "97": "3b43aff1e5dcc748", "98": "a8c11bc3ea56c13a", "99": "ed9780dfc51f724c", "100": "13cf78b368b49c84", "101": "5f6224204d52e0ca", "102": "919edef32945baa9", "103": "07b3d7351d3788b2", "104": "10d0037c220e2fee", "105": "f6dc073f17e45301"}

structtype-0.4.0/graphify-out/.graphify_root

@@ -0,0 +1 @@
+.

structtype-0.4.0/graphify-out/2026-08-09/.graphify_labels.json

@@ -0,0 +1,93 @@
+{
+  "0": "_core.c",
+  "1": "test_schema.py",
+  "2": "structtype_get_global_state",
+  "3": "TypeNode",
+  "4": "EncoderState",
+  "5": "test_inspect.py",
+  "6": "_inspect.py",
+  "7": "dump_obj",
+  "8": "JSONDecoderState",
+  "9": "PathNode",
+  "10": "parametrize",
+  "11": "Field",
+  "12": "StructspecState",
+  "13": "test_struct_meta.py",
+  "14": "Py_ssize_t",
+  "15": "test_json.py",
+  "16": "visitproc",
+  "17": "test_struct.py",
+  "18": "parametrize",
+  "19": "TestDict",
+  "20": "test_check.py",
+  "21": "test_msgspec.py",
+  "22": "structtype/__init__.py",
+  "23": "test_constraints.py",
+  "24": "test_pydantic.py",
+  "25": "TestRename",
+  "26": "StructAdapter",
+  "27": "TestStruct",
+  "28": "TestDatetime",
+  "29": "TestEncoderMisc",
+  "30": "multi_type_info",
+  "31": "json_decode_struct_array_inner",
+  "32": "TestStructParameterOrdering",
+  "33": "bench_libs.py",
+  "34": "TestGetClassAnnotations",
+  "35": "_utils.py",
+  "36": "temp_module",
+  "37": "replace",
+  "38": "validate_lookup_tag",
+  "39": "test_raw.py",
+  "40": "TestRaw",
+  "41": "bench_gc.py",
+  "42": "atof.h",
+  "43": "Rand",
+  "44": "TestBoolAndNone",
+  "45": "TestHash",
+  "46": "TestStructGC",
+  "47": "structtype — AGENTS.md",
+  "48": "TestStrings",
+  "49": "TestDecodeFunction",
+  "50": "TestSequences",
+  "51": "TestOrderAndEq",
+  "52": "structtype_geojson.py",
+  "53": ".roundtrip",
+  "54": "TestStructArray",
+  "55": "TestRepr",
+  "56": "TestEncodeFunction",
+  "57": "TestInspectFields",
+  "58": "strbuilder_build",
+  "59": "test_cpylint.py",
+  "60": "test_free_threading.py",
+  "61": "utils.py",
+  "62": "structtype",
+  "63": "TestDecimal",
+  "64": "test_JSONTestSuite.py",
+  "65": "TestMixins",
+  "66": "LiteralType",
+  "67": "TestFloatConstraints",
+  "68": "TestStructArrayUnion",
+  "69": "TestPostInit",
+  "70": "bench_structs.py",
+  "71": "Changelog",
+  "72": "as_tuple",
+  "73": "EnumType",
+  "74": "TestSignature",
+  "75": "graphify.js",
+  "76": "Struct_hash",
+  "77": "generate_atof_consts.py",
+  "78": "BoolType",
+  "79": ".__init__",
+  "80": ".struct_dump_json",
+  "81": ".struct_validate",
+  "82": ".struct_dump",
+  "83": "__dir__",
+  "84": ".includes_none",
+  "85": "test_structadapter_pydantic",
+  "86": "test_decode_pydantic_direct",
+  "87": "test_python_validate_pydantic",
+  "88": "structtype",
+  "89": "setup.py",
+  "90": "tests/__init__.py"
+}