querygraph 0.2.0__py3-none-any.whl

querygraph-0.2.0.dist-info/METADATA

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: querygraph
+Version: 0.2.0
+Summary: Python port of the QueryGraph AI Navigator semantic layer
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.7
+Provides-Extra: agents
+Requires-Dist: langchain-core>=0.3; extra == 'agents'
+Provides-Extra: all
+Requires-Dist: googleapis-common-protos>=1.75.0; extra == 'all'
+Requires-Dist: grpcio-status>=1.81.0; extra == 'all'
+Requires-Dist: grpcio>=1.81.0; extra == 'all'
+Requires-Dist: langchain-core>=0.3; extra == 'all'
+Requires-Dist: pandas>=3.0.0; extra == 'all'
+Requires-Dist: pyarrow>=24.0.0; extra == 'all'
+Requires-Dist: pyspark>=4.1.2; extra == 'all'
+Requires-Dist: zstandard>=0.25.0; extra == 'all'
+Provides-Extra: lakehouse
+Requires-Dist: googleapis-common-protos>=1.75.0; extra == 'lakehouse'
+Requires-Dist: grpcio-status>=1.81.0; extra == 'lakehouse'
+Requires-Dist: grpcio>=1.81.0; extra == 'lakehouse'
+Requires-Dist: pandas>=3.0.0; extra == 'lakehouse'
+Requires-Dist: pyarrow>=24.0.0; extra == 'lakehouse'
+Requires-Dist: pyspark>=4.1.2; extra == 'lakehouse'
+Requires-Dist: zstandard>=0.25.0; extra == 'lakehouse'
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# QueryGraph Python
+
+Python ecosystem for the QueryGraph AI Navigator.
+
+It mirrors and extends the Rust implementation in `../qg-rust`:
+
+- Croissant JSON-LD dataset metadata
+- CDIF discovery/access/profile projection
+- deterministic `did:oyd` identity documents
+- ODRL permissions and prohibitions
+- OSI semantic models over Croissant fields and Sail columns
+- TypeDID agents modeled with Pydantic
+- optional LangChain adapters for governed agent tools
+- OpenLineage events and DID-style attestations
+- PySpark helpers for querying a local Sail warehouse
+- a CLI compatible with the Rust semantic bundle commands
+
+The design goal is Python-native ergonomics over the same governed lakehouse:
+Rust loads and verifies the warehouse; Python gives notebooks, PySpark users,
+LangChain agents, and data scientists a typed interop layer.
+
+## Stack versions
+
+This port tracks the same coordinated QueryGraph stack releases as `../qg-rust`:
+
+- **Grust 0.11.0 "Crab"** — the property-graph + GQL/Cypher substrate.
+- **TypeSec 0.11.0 "Burano"** — the typed security fabric; the Pydantic
+  `TypeDidEnvelope` mirrors its audit-safe attestation (action, resource,
+  privacy level, negotiated profile, and an envelope digest).
+- **LakeCat 0.2.1 "Lynx"** — the thin Iceberg REST catalog boundary, now sharing
+  its bootstrap-bundle wire format with the importer via `qglake-bundle`.
+
+See `../qg-rust/docs/blog/announcing-querygraph-stack.md` for the full story.
+
+## Install
+
+Core metadata and TypeDID/Pydantic support:
+
+```bash
+uv sync
+```
+
+Optional PySpark/Sail support:
+
+```bash
+uv sync --extra lakehouse
+```
+
+Optional LangChain tool adapters:
+
+```bash
+uv sync --extra agents
+```
+
+Everything:
+
+```bash
+uv sync --extra all
+```
+
+## Build a Semantic Bundle
+
+```bash
+python -m querygraph navigator \
+  --dataset-name "Hazard vocabulary" \
+  --description "Controlled vocabulary with multilingual technical terms" \
+  --landing-page "https://querygraph.ai/datasets/hazards" \
+  --data-url "https://querygraph.ai/datasets/hazards.csv"
+```
+
+## QG Lakehouse Agent Story
+
+```bash
+python -m querygraph qglake-story --pretty
+```
+
+This produces a Pydantic TypeDID multi-agent run: supervisor, finance, energy,
+mobility, climate-health, reference, restricted-data broker, synthesis,
+OpenLineage, and DID attestation.
+
+## Query Sail with PySpark
+
+Start Sail from the Rust project after the lakehouse has been loaded:
+
+```bash
+cd ../qg-rust
+sail spark server --port 50051
+```
+
+In another shell:
+
+```bash
+cd ../qg-python
+uv sync --extra lakehouse
+uv run querygraph lakehouse-register \
+  --manifest ../qg-rust/.querygraph/lakehouse/manifest/load-report.json \
+  --warehouse ../qg-rust/spark-warehouse
+uv run querygraph audit-register --warehouse ../qg-rust/spark-warehouse
+uv run querygraph pyspark-examples
+```
+
+Open a shell:
+
+```bash
+uv run pyspark --remote sc://127.0.0.1:50051
+```
+
+Then query the registered views:
+
+```python
+spark.sql("SELECT COUNT(*) FROM global_temp.government_finance__countydata").show()
+spark.sql("SELECT quantity, value, unit FROM global_temp.codata_constants_2022__codata_constants_2022 LIMIT 5").show(truncate=False)
+spark.sql("SELECT event_hash, event_type, job_name FROM global_temp.openlineage_events LIMIT 10").show(truncate=False)
+```
+
+## OSI with Semantic Croissant
+
+```bash
+uv run python examples/osi_semantic_croissant.py
+```
+
+The example starts with concrete Semantic Croissant fields and projects them
+into an OSI semantic model with ontology terms and Sail SQL expressions.
+
+## TypeDID Agents with LangChain
+
+```bash
+uv sync --extra agents
+uv run python examples/typedid_langchain_agents.py
+```
+
+The agents are Pydantic models first. When LangChain is installed, a
+`TypeDidLangChainToolAdapter` exposes the same governed agent as a LangChain
+`StructuredTool`.
+
+## Test
+
+```bash
+uv run python -m pytest
+```
+
+The test suite includes equivalence checks against the sibling Rust implementation.

querygraph-0.2.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+querygraph/__init__.py,sha256=84T6TBw-7VgYjrtu5GIpyvnVVgMQxsoHSs2uL4U4OS0,393
+querygraph/__main__.py,sha256=rMIka4mhgI9ghOEiIXc05n5EGGxE7AKqOr8s07dN1Os,89
+querygraph/agents.py,sha256=ewYV5NvAYtnp_mk4Agu4HVsgfenm2IAogfS-qgArURE,3023
+querygraph/base58.py,sha256=uPZF1kdidqZPuP38SwUY-Bbc8nyRmuiEuWSOHEkanHc,412
+querygraph/cdif.py,sha256=wKK7Vr21TUEBrqWiVra5L4z7paxB7HgrwA74T78h-Ik,7345
+querygraph/cli.py,sha256=hGHDoJPHmSIE9YEiP9CBYV9PMaTyUYLbrkjDea3rEVQ,4643
+querygraph/codata.py,sha256=JbRQe0pQeRyddpXMNHPxvT3bR15RzbjMtJsq5wMUvew,1099
+querygraph/croissant.py,sha256=wNMBMBqgOwwe7e9WALqsfqm1_A34c_cr7Snp123u0N8,2493
+querygraph/dataverse.py,sha256=U34gRUr9a2CIou3B679HPBmhBq8_MsEzjEQ2uSc9hN4,5773
+querygraph/did.py,sha256=CdQ0zwmKqpWsPpspMoDmj308MehGAPMKeTEjyKhBlbc,1590
+querygraph/lakehouse.py,sha256=jIMgzmzHLZCnXgTESJxQaU0H5tUG-2HN9eh32isY5T4,3989
+querygraph/lineage.py,sha256=IoBIklVKdnBdCOb4Y7WzOVHroS7VzcFXnM_DJcZZdeI,3641
+querygraph/navigator.py,sha256=lhbqY5y02TVCqJOiIQPpLTV2hE9UpWF3gN2sM_fEicI,4760
+querygraph/odrl.py,sha256=1HI_FL_KIvW59ebsqSM12BD8boIh3g5CCaS4aE3cM04,1503
+querygraph/odrl_rights.py,sha256=cpigthm99OYM7bqhTqnszlwjAthwN2PdgTwx5w-lt6o,1429
+querygraph/osi.py,sha256=hbhVo7eKm2KhHBGcnT374KRwPBcL3xMdPzVZVwbeE0o,4971
+querygraph/qglake.py,sha256=NFkaC4j-upebP_CxfcIixUIRXy0fcBUiC04M3Qs4lgw,4017
+querygraph/rbac.py,sha256=RN8oPFB6FqWv2LOrZXz6BzwuPNA-QKuggvPE9Fs1NhU,839
+querygraph/typedid.py,sha256=Ll8dz2BYF5wXzDnN9MsUAPfsv4Szv55hyoTETqHbT1Q,6251
+querygraph/validation.py,sha256=F8YNd7vYxr4BnNprHeJZD3wYzjBLNRNvCiZBPsh3GB0,1368
+querygraph-0.2.0.dist-info/METADATA,sha256=mLsvhHhec0Myh9L6LqhiAdbvk8vweX5aWui_x2lMZj8,5128
+querygraph-0.2.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+querygraph-0.2.0.dist-info/entry_points.txt,sha256=AwnTT2bQoVTxAq7Aw4fbOayWzSDXB7d-PGuzTWgbQB0,51
+querygraph-0.2.0.dist-info/RECORD,,

querygraph-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

querygraph-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+querygraph = querygraph.cli:main