verifiably-nodes 0.2.0__tar.gz

verifiably_nodes-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+.ruff_cache/
+.venv/
+node_modules/
+ts/dist/
+.nodes-index/
+
+# Fallback test-timing log, written by tools/tt when the shared log is unwritable and
+# emptied by ops `tt-report`; never committed.
+.tt/
+# pytest-testmon's per-checkout selection database, rebuilt on demand.
+.testmondata*

verifiably_nodes-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Keith Hughitt
+
+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.

verifiably_nodes-0.2.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.5
+Name: verifiably-nodes
+Version: 0.2.0
+Import-Name: nodes.core
+Import-Namespace: nodes
+Summary: Nodes core: a problem-agnostic knowledge substrate
+Project-URL: Homepage, https://github.com/verifiably/nodes
+Project-URL: Repository, https://github.com/verifiably/nodes
+Project-URL: Issues, https://github.com/verifiably/nodes/issues
+Author-email: Keith Hughitt <keith.hughitt@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rfc8785<0.2,>=0.1.4
+Description-Content-Type: text/markdown
+
+# verifiably-nodes
+
+Nodes core: a problem-agnostic knowledge substrate.
+
+`verifiably-nodes` is the Python implementation of the Nodes kernel — a portable
+corpus of plain-text nodes with typed relations, structural shapes, and
+derived full-text-search and similarity indexes. A TypeScript implementation
+([`@verifiably/nodes`](https://www.npmjs.com/package/@verifiably/nodes)) passes
+the same cross-language conformance fixtures.
+
+## Install
+
+```
+pip install verifiably-nodes
+```
+
+## Use
+
+```python
+import nodes.core
+```
+
+The `nodes` namespace is a PEP 420 native namespace package; `verifiably-nodes`
+ships exactly the `nodes.core` subpackage.
+
+## Documentation
+
+The language-neutral format and behavior specification, both
+implementations, and the shared conformance fixtures live at
+<https://github.com/verifiably/nodes>.
+
+## License
+
+MIT

verifiably_nodes-0.2.0/README.md

@@ -0,0 +1,34 @@
+# verifiably-nodes
+
+Nodes core: a problem-agnostic knowledge substrate.
+
+`verifiably-nodes` is the Python implementation of the Nodes kernel — a portable
+corpus of plain-text nodes with typed relations, structural shapes, and
+derived full-text-search and similarity indexes. A TypeScript implementation
+([`@verifiably/nodes`](https://www.npmjs.com/package/@verifiably/nodes)) passes
+the same cross-language conformance fixtures.
+
+## Install
+
+```
+pip install verifiably-nodes
+```
+
+## Use
+
+```python
+import nodes.core
+```
+
+The `nodes` namespace is a PEP 420 native namespace package; `verifiably-nodes`
+ships exactly the `nodes.core` subpackage.
+
+## Documentation
+
+The language-neutral format and behavior specification, both
+implementations, and the shared conformance fixtures live at
+<https://github.com/verifiably/nodes>.
+
+## License
+
+MIT

verifiably_nodes-0.2.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "verifiably-nodes"
+import-names = ["nodes.core"]
+import-namespaces = ["nodes"]
+version = "0.2.0"
+description = "Nodes core: a problem-agnostic knowledge substrate"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Keith Hughitt", email = "keith.hughitt@gmail.com" }]
+requires-python = ">=3.11"
+classifiers = ["Typing :: Typed"]
+dependencies = [
+  "pydantic>=2.0",
+  "pyyaml>=6.0.3",
+  "rfc8785>=0.1.4,<0.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/verifiably/nodes"
+Repository = "https://github.com/verifiably/nodes"
+Issues = "https://github.com/verifiably/nodes/issues"
+
+[build-system]
+requires = ["hatchling>=1.30"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+core-metadata-version = "2.5"
+packages = ["src/nodes"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 120
+
+[tool.pyright]
+pythonVersion = "3.11"
+typeCheckingMode = "basic"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0",
+    "ruff>=0.15.7",
+    "pyright>=1.1.390",
+    "pytest-testmon>=2.2.0",
+]

verifiably_nodes-0.2.0/scripts/gen_search_oracle.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from nodes.core.corpus import Corpus
+from nodes.core.ranking import score_key
+
+FIXTURES = Path(__file__).parent.parent.parent / "fixtures"
+CORPUS = FIXTURES / "search-corpus"
+ORACLE = FIXTURES / "search.oracle.json"
+
+QUERIES = ["search", "documents ranking", "relevance"]
+
+
+def main() -> None:
+    corpus = Corpus(CORPUS)
+    cases = []
+    for query in QUERIES:
+        hits = corpus.search(query)
+        cases.append(
+            {"query": query, "hits": [{"id": h.id, "score": score_key(h.score)} for h in hits]}
+        )
+    ORACLE.write_text(json.dumps(cases, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+
+
+if __name__ == "__main__":
+    main()

verifiably_nodes-0.2.0/scripts/gen_similarity_oracle.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import json
+import shutil
+import tempfile
+from pathlib import Path
+
+from nodes.core.corpus import Corpus
+from nodes.core.ranking import score_key
+from nodes.core.similarity import Vector, embed_text
+
+FIXTURES = Path(__file__).parent.parent.parent / "fixtures"
+CORPUS = FIXTURES / "similarity-corpus"
+VECTORS = FIXTURES / "similarity.vectors.json"
+ORACLE = FIXTURES / "similarity.oracle.json"
+
+
+class LookupEmbedder:
+    cache_namespace = "fixture-v1"
+
+    def __init__(self, table: dict[str, Vector]) -> None:
+        self._table = table
+
+    def embed(self, texts: list[str]) -> list[Vector]:
+        return [self._table[t] for t in texts]
+
+
+def build_table(data: dict, nodes: list) -> dict[str, Vector]:
+    by_id = {d["id"]: tuple(d["vector"]) for d in data["documents"]}
+    table: dict[str, Vector] = {embed_text(n): by_id[n.id] for n in nodes}
+    for q in data["queries"]:
+        table[q["text"]] = tuple(q["vector"])
+    return table
+
+
+def _hits(hits) -> list[dict]:
+    return [{"id": h.id, "score": score_key(h.score)} for h in hits]
+
+
+def main() -> None:
+    data = json.loads(VECTORS.read_text(encoding="utf-8"))
+    with tempfile.TemporaryDirectory() as td:
+        dst = Path(td) / "similarity-corpus"
+        shutil.copytree(CORPUS, dst)
+        nodes = Corpus(dst).all()  # plain read, no embedder
+        emb = LookupEmbedder(build_table(data, nodes))
+        corpus = Corpus(dst, embedder=emb)
+        cases = {
+            "similar": [{"ref": d["id"], "hits": _hits(corpus.similar(d["id"]))} for d in data["documents"]],
+            "query_vector": [
+                {"text": q["text"], "hits": _hits(corpus.query_vector(tuple(q["vector"])))}
+                for q in data["queries"]
+            ],
+            "similar_text": [
+                {"text": q["text"], "hits": _hits(corpus.similar_text(q["text"]))} for q in data["queries"]
+            ],
+        }
+    ORACLE.write_text(json.dumps(cases, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+
+
+if __name__ == "__main__":
+    main()

verifiably_nodes-0.2.0/scripts/gen_tokenizer_oracle.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from nodes.core.search import tokenize
+
+ORACLE = Path(__file__).parent.parent.parent / "fixtures" / "search.tokenizer.json"
+
+INPUTS = [
+    "",
+    "   \t\n ",
+    "The Quick Brown Fox",
+    "the THE The",
+    "well-known",
+    "state_of_art",
+    "don't",
+    "3.14 and 2",
+    "café",            # composed U+00E9
+    "café",      # decomposed e + combining acute
+    "Hello МИР",       # Cyrillic
+    "hello 世界",       # CJK
+    "data\U0001D7D9point",  # non-BMP MATHEMATICAL DOUBLE-STRUCK DIGIT ONE inside a token
+]
+
+
+def main() -> None:
+    cases = [{"input": text, "tokens": tokenize(text)} for text in INPUTS]
+    ORACLE.write_text(json.dumps(cases, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+
+
+if __name__ == "__main__":
+    main()

verifiably_nodes-0.2.0/src/nodes/core/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations