abstractsemantics 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

abstractsemantics-0.0.2.dist-info/METADATA

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: abstractsemantics
+Version: 0.0.2
+Summary: Semantics registry (predicates/types) for AbstractFramework.
+Author: Laurent-Philippe Albou
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Dynamic: license-file
+
+# AbstractSemantics (`abstractsemantics`)
+
+Central, editable semantics registry (predicates + entity types) for AbstractFramework, with helpers to build a compact JSON Schema for knowledge-graph (KG) assertion structured outputs.
+
+This package intentionally contains **definitions**, not storage:
+- prefix mappings (CURIE namespaces)
+- predicate allowlists (optional inverse pointers)
+- entity-type allowlists
+
+## Status
+
+Small, dependency-light package (only PyYAML) with a tiny public API:
+- the default registry is shipped as package data (`abstractsemantics/semantics.yaml`; in this repo: `src/abstractsemantics/semantics.yaml`)
+- the loader returns immutable dataclasses (`SemanticsRegistry`)
+- the v0 schema builder produces a deterministic JSON Schema dict
+
+## Install
+
+From PyPI:
+
+```bash
+pip install abstractsemantics
+```
+
+From source (editable, with test deps):
+
+```bash
+pip install -e ".[dev]"
+```
+
+Requires Python `>=3.10` (see `pyproject.toml`).
+
+## Quickstart
+
+Load the default registry and build the v0 structured-output schema:
+
+```python
+from abstractsemantics import load_semantics_registry, build_kg_assertion_schema_v0
+
+reg = load_semantics_registry()
+print(len(reg.predicates), len(reg.entity_types))
+
+schema = build_kg_assertion_schema_v0(registry=reg, include_predicate_aliases=True)
+```
+
+Use a custom registry YAML (must exist on disk):
+
+```bash
+export ABSTRACTSEMANTICS_REGISTRY_PATH=/absolute/path/to/semantics.yaml
+```
+
+```python
+from abstractsemantics import load_semantics_registry
+
+reg = load_semantics_registry()  # loads from ABSTRACTSEMANTICS_REGISTRY_PATH if set
+```
+
+Note: `load_semantics_registry()` only requires at least 1 predicate, but `build_kg_assertion_schema_v0()` requires both predicate ids **and** entity-type ids (it raises `ValueError` if `entity_types` is empty).
+
+## Intended consumers (external)
+
+This package is designed to be consumed by:
+- AbstractRuntime (validation at ingestion boundary)
+- AbstractFlow (UI dropdowns + authoring support)
+- AbstractMemory (storage/query on top of validated semantics)
+
+## Documentation
+
+Start with:
+- `docs/getting-started.md` (recommended entrypoint)
+- `docs/README.md` (documentation index)
+- `docs/architecture.md` (what exists in this repo, with diagrams)
+- `docs/registry.md` (registry YAML format)
+- `docs/schema.md` (KG assertion JSON Schema + `$ref`)
+- `docs/faq.md` (common questions and troubleshooting)
+
+## Project
+
+- Changelog: `CHANGELOD.md`
+- Contributing: `CONTRIBUTING.md`
+- Security: `SECURITY.md`
+- Acknowledgments: `ACKNOWLEDMENTS.md`
+
+## License
+
+MIT (see `LICENSE`).

abstractsemantics-0.0.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+abstractsemantics/__init__.py,sha256=4v-QtKbj-XPzAWkin6wGtBjsvoEbUsDPUowwpVUgZjI,435
+abstractsemantics/registry.py,sha256=p7RnE8CJrgi0jqbccxGaAxW0mpaTSKkdrqCcps_eZ1Q,3829
+abstractsemantics/schema.py,sha256=euxAnpEyYIA4kDxmika8RhdrvgIyY5js_akea_ohJKQ,5244
+abstractsemantics/semantics.yaml,sha256=BeFa6e-LmtTN01jjSO9_Tih6knOkhkNWro2gWXQKpkQ,4160
+abstractsemantics-0.0.2.dist-info/licenses/LICENSE,sha256=ifO3lH7cJAMqNv7IWJlVUsJ_4FOBfoh1SkhzTkxQHd4,1079
+abstractsemantics-0.0.2.dist-info/METADATA,sha256=8wXtlcMKfweeYDF-_e_7cMQOYtyr7VEvaX20huxEI6g,2966
+abstractsemantics-0.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+abstractsemantics-0.0.2.dist-info/top_level.txt,sha256=vKH3yydhRsGZk5Jinb3B1RdJ-YvZMuDFT-RPaVF_tkM,18
+abstractsemantics-0.0.2.dist-info/RECORD,,

{abstractsemantics-0.0.1.dist-info → abstractsemantics-0.0.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

abstractsemantics-0.0.2.dist-info/licenses/LICENSE

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

abstractsemantics-0.0.1.dist-info/METADATA

@@ -1,26 +0,0 @@
-Metadata-Version: 2.4
-Name: abstractsemantics
-Version: 0.0.1
-Summary: Semantics registry (predicates/types) for AbstractFramework.
-Author: Laurent-Philippe Albou
-License: MIT
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: PyYAML>=6.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-
-# AbstractSemantics
-
-Central, editable semantics registry for AbstractFramework.
-
-This package intentionally contains **definitions**, not storage:
-- prefix mappings (CURIE namespaces)
-- predicate allowlists (and optional inverses/constraints)
-- entity-type allowlists (optional in v0)
-
-It is designed to be consumed by:
-- AbstractRuntime (validation at ingestion boundary)
-- AbstractFlow (UI dropdowns + authoring support)
-- AbstractMemory (storage/query on top of validated semantics)
-

abstractsemantics-0.0.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-abstractsemantics/__init__.py,sha256=4v-QtKbj-XPzAWkin6wGtBjsvoEbUsDPUowwpVUgZjI,435
-abstractsemantics/registry.py,sha256=p7RnE8CJrgi0jqbccxGaAxW0mpaTSKkdrqCcps_eZ1Q,3829
-abstractsemantics/schema.py,sha256=euxAnpEyYIA4kDxmika8RhdrvgIyY5js_akea_ohJKQ,5244
-abstractsemantics/semantics.yaml,sha256=BeFa6e-LmtTN01jjSO9_Tih6knOkhkNWro2gWXQKpkQ,4160
-abstractsemantics-0.0.1.dist-info/METADATA,sha256=wQSXAJG_CHxafhad9P09lrErZrMKfZ9_x5pm6SrNeKo,820
-abstractsemantics-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractsemantics-0.0.1.dist-info/top_level.txt,sha256=vKH3yydhRsGZk5Jinb3B1RdJ-YvZMuDFT-RPaVF_tkM,18
-abstractsemantics-0.0.1.dist-info/RECORD,,