runic-py 0.2.2__tar.gz → 0.3.2__tar.gz

{runic_py-0.2.2 → runic_py-0.3.2}/.gitignore

@@ -115,3 +115,11 @@ wheels/
 .task/
 .runic
 runic_test/
+.claude/ralph-loop.local.md
+
+# DeepEval run caches (tests/evals suite runs from an isolated venv)
+.deepeval/
+.deepeval-cache.json
+.deepeval_telemetry.txt
+.latest_run_full.json
+.latest_test_run.json

runic_py-0.2.2/README.md → runic_py-0.3.2/PKG-INFO

@@ -1,11 +1,48 @@
+Metadata-Version: 2.4
+Name: runic-py
+Version: 0.3.2
+Summary: Graph schema migrations and ORM for Cypher-based graph databases.
+Project-URL: Homepage, https://runic-py.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/jenreh/runic
+Author: Jens Rehpöhler
+License: MIT
+License-File: LICENSE.md
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Database
+Requires-Python: >=3.14
+Requires-Dist: mako<2.0.0,>=1.3.0
+Requires-Dist: rich<16.0.0,>=14.0.0
+Requires-Dist: typer<1.0.0,>=0.26.0
+Provides-Extra: age
+Requires-Dist: psycopg<4.0.0,>=3.3.4; extra == 'age'
+Provides-Extra: age-binary
+Requires-Dist: psycopg[binary]<4.0.0,>=3.3.4; extra == 'age-binary'
+Provides-Extra: all
+Requires-Dist: falkordb<2.0.0,>=1.6.0; extra == 'all'
+Requires-Dist: neo4j<7.0.0,>=6.2.0; extra == 'all'
+Requires-Dist: psycopg[binary]<4.0.0,>=3.3.4; extra == 'all'
+Provides-Extra: arcadedb
+Requires-Dist: neo4j<7.0.0,>=6.2.0; extra == 'arcadedb'
+Provides-Extra: falkordb
+Requires-Dist: falkordb<2.0.0,>=1.6.0; extra == 'falkordb'
+Provides-Extra: memgraph
+Requires-Dist: neo4j<7.0.0,>=6.2.0; extra == 'memgraph'
+Provides-Extra: neo4j
+Requires-Dist: neo4j<7.0.0,>=6.2.0; extra == 'neo4j'
+Description-Content-Type: text/markdown
+
 <div align="center">
   <img src="https://raw.githubusercontent.com/jenreh/runic/refs/heads/main/docs/source/_static/runic.svg" width="240" alt="Runic logo">
 
 # Runic
 
-**Graph schema migrations and ORM for FalkorDB.**
+**Graph schema migrations and ORM for Cypher-based graph databases.**
 
-![Version](https://img.shields.io/badge/version-0.2.2-blue)
+![Version](https://img.shields.io/badge/version-0.3.2-blue)
+[![PyPI](https://img.shields.io/pypi/v/runic-py.svg)](https://pypi.org/project/runic-py/)
 [![Python](https://img.shields.io/badge/python-3.14%2B-orange)](https://www.python.org)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
 
@@ -15,44 +52,64 @@
 
 ---
 
-**Runic** is a Python toolkit for [FalkorDB](https://falkordb.com/) that covers two layers:
+**Runic** is a Python toolkit for Cypher-based graph databases that covers two layers:
 
 - **`runic.migrate`** — Alembic-style schema migrations with revision tracking, a CLI, and rollback snapshots.
-- **`runic.orm`** — A lightweight graph ORM: declare `Node` and `Edge` models, manage sessions, traverse relationships, and sync indexes — all using FalkorDB-native Cypher under the hood.
+- **`runic.orm`** — A lightweight graph ORM: declare `Node` and `Edge` models, manage sessions, traverse relationships, and sync indexes — all via a pluggable driver layer supporting FalkorDB, ArcadeDB, and any Bolt-compatible database.
 
 ## Features
 
 ### Migration CLI
 
 - **Alembic-Style Workflow** — Familiar CLI verbs: `init`, `revision`, `upgrade`, `downgrade`, `current`, `baseline`.
-- **Graph-Native** — Migration state stored inside dedicated graph nodes (`:_FalkorMigrateVersion`).
+- **Graph-Native** — Migration state stored inside dedicated graph nodes; no external state table needed.
 - **Idempotent Cypher** — Explicit, guarded migration steps; safe to replay on an empty graph.
 - **Offline & Dry Run** — Review generated Cypher scripts before running them in production.
-- **Rollback Snapshots** — Uses `GRAPH.COPY` for high-risk, non-reversible migrations.
+- **Rollback Snapshots** — Optional snapshot-based rollback for high-risk, non-reversible migrations.
 
 ### Graph ORM
 
 - **Declarative Models** — `Node` and `Edge` subclasses with typed `Field` descriptors; no metaclass magic.
-- **Session & Repository** — Unit-of-work session with change tracking; typed `Repository` for queries and pagination.
+- **Pluggable Driver Layer** — `GraphDriver` / `GraphDialect` protocols; built-in drivers for FalkorDB, ArcadeDB (via Bolt), and any Bolt-compatible DB. Switch backends without changing model code.
+- **Session & Repository** — Unit-of-work session with change tracking; typed `Repository` for queries and offset reads.
 - **Relationships** — `Relation` field for INCOMING / OUTGOING edges; lazy and eager loading; edge property models.
 - **Schema Management** — `IndexManager` and `SchemaManager` to create, validate, and sync RANGE, FULLTEXT, and UNIQUE indexes.
-- **Native FalkorDB Types** — First-class `Vector` (vecf32), `GeoLocation` (point), interned strings, and auto-converters for `datetime` and `Enum`.
+- **Native Graph Types** — First-class `Vector` (vecf32), `GeoLocation` (point), interned strings, and auto-converters for `datetime` and `Enum`.
 - **Async Support** — `AsyncSession`, `AsyncRepository`, and `AsyncConnectionManager` for async-first applications.
 
 ## Installation
 
-```bash
-uv pip install runic
-```
+Install the core package, then add the optional extra for your database backend:
 
-Or add it to an existing project:
+| Backend | Extra | Package installed |
+| --- | --- | --- |
+| FalkorDB | `falkordb` | `falkordb` |
+| Neo4j | `neo4j` | `neo4j` |
+| Memgraph | `memgraph` | `neo4j` (Bolt) |
+| ArcadeDB | `arcadedb` | `neo4j` (Bolt) |
+| Apache AGE | `age` | `psycopg[binary]` |
+| All backends | `all` | all of the above |
 
 ```bash
-uv add runic
+# FalkorDB
+uv add "runic-py[falkordb]"
+
+# Neo4j
+uv add "runic-py[neo4j]"
+
+# Memgraph or ArcadeDB (both use the Neo4j Bolt driver)
+uv add "runic-py[memgraph]"
+uv add "runic-py[arcadedb]"
+
+# Apache AGE (PostgreSQL extension)
+uv add "runic-py[age]"
+
+# All backends at once
+uv add "runic-py[all]"
 ```
 
 > [!NOTE]
-> Runic requires Python 3.14+ and is optimized for the latest FalkorDB clients.
+> Runic requires Python 3.14+. The core package has no graph-driver dependency — install only the extra for your backend.
 
 ---
 
@@ -90,7 +147,7 @@ runic downgrade 1975e    # roll back to a specific revision (prefix is enough)
 
 ### Baselining an existing graph
 
-Bring an unmanaged FalkorDB graph under runic control without re-running anything:
+Bring an existing graph under runic control without re-running anything:
 
 ```bash
 runic baseline -m "baseline"   # introspect, generate root revision, stamp it
@@ -112,9 +169,12 @@ from runic.migrate.adapters import create_adapter
 
 init(Path("runic/"))
 
+# Any supported backend — swap the adapter name and kwargs
 adapter = create_adapter(
     "falkordb", url="falkor://localhost:6379", graph_name="my_graph"
 )
+# adapter = create_adapter("neo4j", host="localhost", port=7687, database="neo4j", username="neo4j", password="secret")
+
 runic = Runic(adapter, script_location=Path("runic/"))
 runic.migrate.upgrade("head")
 
@@ -160,23 +220,28 @@ class Author(Node, labels=["Author"]):
 
 ### Session-based CRUD
 
+`Session` accepts any `GraphDriver`. Use `create_driver()` to build one for your backend:
+
 ```python
-from runic.orm import Session, Repository
+from runic.orm import Session, Repository, create_driver
 
-with Session(graph) as session:
+# Pick your backend — the rest of the code is identical
+driver = create_driver("falkordb", host="localhost", port=6379, graph="myapp")
+
+with Session(driver) as session:
     session.add_all([
         User(id="alice", email="alice@example.com", name="Alice"),
         User(id="bob", email="bob@example.com", name="Bob"),
     ])
     session.commit()
 
-with Session(graph) as session:
+with Session(driver) as session:
     repo = Repository(session, User)
     alice = session.get(User, "alice")
     alice.name = "Alice Smith"  # change tracking — no explicit dirty flag
     session.commit()
 
-with Session(graph) as session:
+with Session(driver) as session:
     user = session.get(User, "bob")
     session.delete(user)
     session.commit()
@@ -186,12 +251,12 @@ with Session(graph) as session:
 
 ```python
 # Lazy load (default) — triggers a query on first access
-with Session(graph) as session:
+with Session(driver) as session:
     author = session.get(Author, "alice")
     posts = author.posts  # query executed here
 
 # Eager load — single round-trip
-with Session(graph) as session:
+with Session(driver) as session:
     author = session.get(Author, "alice", fetch=["posts"])
     posts = author.posts  # already loaded, no extra query
 ```
@@ -199,12 +264,12 @@ with Session(graph) as session:
 ### Pagination and custom queries
 
 ```python
-from runic.orm import Pageable, Repository
+from runic.orm import Repository
 
-with Session(graph) as session:
+with Session(driver) as session:
     repo = Repository(session, User)
-    page = repo.find_all_paginated(Pageable(page=0, size=20, sort_by="name"))
-    print(f"{len(list(page))} of {page.total_elements} total")
+    first_page = repo.find_all(skip=0, limit=20)
+    next_page = repo.find_all(skip=20, limit=20)
 ```
 
 Extend `Repository` to add typed Cypher helpers:
@@ -219,6 +284,28 @@ class UserRepository(Repository[User]):
         )
 ```
 
+### Composable queries
+
+`select()` creates a query statement independently of any session, enabling
+dynamic query composition (e.g. conditional UI filters) before execution:
+
+```python
+from runic.orm import select
+
+stmt = select(User).where(User.active == True)
+if min_age > 0:
+    stmt = stmt.where(User.age >= min_age)
+
+with Session(driver) as session:
+    users: list[User] = session.scalars(stmt)  # list[User]
+    user: User | None = session.scalar(stmt)  # User | None
+    n: int = session.count(stmt)  # int
+```
+
+The same `stmt` is reusable — pass it to multiple sessions or execute it
+multiple times.  The older `session.query(User).where(...).all()` pattern is
+still fully supported.
+
 ### Schema management
 
 Declare indexes inline on `Field`, then let `SchemaManager` keep the live graph in sync:
@@ -235,14 +322,14 @@ class Place(Node, labels=["Place"]):
     lon: float = Field(index=True)
 
 
-schema = SchemaManager(graph)
+schema = SchemaManager(driver)
 schema.sync_schema([Place], drop_extra=False)  # create missing; leave extras alone
 
 result = schema.validate_schema([Place])
 print("valid:", result.is_valid)
 ```
 
-### Native FalkorDB types
+### Native graph types
 
 `Vector`, `GeoLocation`, `datetime`, and `Enum` fields get their converters assigned automatically — no `converter=` argument needed:
 

runic_py-0.2.2/PKG-INFO → runic_py-0.3.2/README.md

@@ -1,32 +1,12 @@
-Metadata-Version: 2.4
-Name: runic-py
-Version: 0.2.2
-Summary: OGM and schema migrations for FalkorDB.
-Project-URL: Homepage, https://runic-py.readthedocs.io/latest/
-Project-URL: Repository, https://github.com/jenreh/runic
-Author: Jens Rehpöhler
-License: MIT
-License-File: LICENSE.md
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Home Automation
-Requires-Python: >=3.14
-Requires-Dist: falkordb<2.0.0,>=1.6.0
-Requires-Dist: mako<2.0.0,>=1.3.0
-Requires-Dist: rich<16.0.0,>=15.0.0
-Requires-Dist: typer<1.0.0,>=0.26.0
-Description-Content-Type: text/markdown
-
 <div align="center">
   <img src="https://raw.githubusercontent.com/jenreh/runic/refs/heads/main/docs/source/_static/runic.svg" width="240" alt="Runic logo">
 
 # Runic
 
-**Graph schema migrations and ORM for FalkorDB.**
+**Graph schema migrations and ORM for Cypher-based graph databases.**
 
-![Version](https://img.shields.io/badge/version-0.2.2-blue)
+![Version](https://img.shields.io/badge/version-0.3.2-blue)
+[![PyPI](https://img.shields.io/pypi/v/runic-py.svg)](https://pypi.org/project/runic-py/)
 [![Python](https://img.shields.io/badge/python-3.14%2B-orange)](https://www.python.org)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
 
@@ -36,44 +16,64 @@ Description-Content-Type: text/markdown
 
 ---
 
-**Runic** is a Python toolkit for [FalkorDB](https://falkordb.com/) that covers two layers:
+**Runic** is a Python toolkit for Cypher-based graph databases that covers two layers:
 
 - **`runic.migrate`** — Alembic-style schema migrations with revision tracking, a CLI, and rollback snapshots.
-- **`runic.orm`** — A lightweight graph ORM: declare `Node` and `Edge` models, manage sessions, traverse relationships, and sync indexes — all using FalkorDB-native Cypher under the hood.
+- **`runic.orm`** — A lightweight graph ORM: declare `Node` and `Edge` models, manage sessions, traverse relationships, and sync indexes — all via a pluggable driver layer supporting FalkorDB, ArcadeDB, and any Bolt-compatible database.
 
 ## Features
 
 ### Migration CLI
 
 - **Alembic-Style Workflow** — Familiar CLI verbs: `init`, `revision`, `upgrade`, `downgrade`, `current`, `baseline`.
-- **Graph-Native** — Migration state stored inside dedicated graph nodes (`:_FalkorMigrateVersion`).
+- **Graph-Native** — Migration state stored inside dedicated graph nodes; no external state table needed.
 - **Idempotent Cypher** — Explicit, guarded migration steps; safe to replay on an empty graph.
 - **Offline & Dry Run** — Review generated Cypher scripts before running them in production.
-- **Rollback Snapshots** — Uses `GRAPH.COPY` for high-risk, non-reversible migrations.
+- **Rollback Snapshots** — Optional snapshot-based rollback for high-risk, non-reversible migrations.
 
 ### Graph ORM
 
 - **Declarative Models** — `Node` and `Edge` subclasses with typed `Field` descriptors; no metaclass magic.
-- **Session & Repository** — Unit-of-work session with change tracking; typed `Repository` for queries and pagination.
+- **Pluggable Driver Layer** — `GraphDriver` / `GraphDialect` protocols; built-in drivers for FalkorDB, ArcadeDB (via Bolt), and any Bolt-compatible DB. Switch backends without changing model code.
+- **Session & Repository** — Unit-of-work session with change tracking; typed `Repository` for queries and offset reads.
 - **Relationships** — `Relation` field for INCOMING / OUTGOING edges; lazy and eager loading; edge property models.
 - **Schema Management** — `IndexManager` and `SchemaManager` to create, validate, and sync RANGE, FULLTEXT, and UNIQUE indexes.
-- **Native FalkorDB Types** — First-class `Vector` (vecf32), `GeoLocation` (point), interned strings, and auto-converters for `datetime` and `Enum`.
+- **Native Graph Types** — First-class `Vector` (vecf32), `GeoLocation` (point), interned strings, and auto-converters for `datetime` and `Enum`.
 - **Async Support** — `AsyncSession`, `AsyncRepository`, and `AsyncConnectionManager` for async-first applications.
 
 ## Installation
 
-```bash
-uv pip install runic
-```
+Install the core package, then add the optional extra for your database backend:
 
-Or add it to an existing project:
+| Backend | Extra | Package installed |
+| --- | --- | --- |
+| FalkorDB | `falkordb` | `falkordb` |
+| Neo4j | `neo4j` | `neo4j` |
+| Memgraph | `memgraph` | `neo4j` (Bolt) |
+| ArcadeDB | `arcadedb` | `neo4j` (Bolt) |
+| Apache AGE | `age` | `psycopg[binary]` |
+| All backends | `all` | all of the above |
 
 ```bash
-uv add runic
+# FalkorDB
+uv add "runic-py[falkordb]"
+
+# Neo4j
+uv add "runic-py[neo4j]"
+
+# Memgraph or ArcadeDB (both use the Neo4j Bolt driver)
+uv add "runic-py[memgraph]"
+uv add "runic-py[arcadedb]"
+
+# Apache AGE (PostgreSQL extension)
+uv add "runic-py[age]"
+
+# All backends at once
+uv add "runic-py[all]"
 ```
 
 > [!NOTE]
-> Runic requires Python 3.14+ and is optimized for the latest FalkorDB clients.
+> Runic requires Python 3.14+. The core package has no graph-driver dependency — install only the extra for your backend.
 
 ---
 
@@ -111,7 +111,7 @@ runic downgrade 1975e    # roll back to a specific revision (prefix is enough)
 
 ### Baselining an existing graph
 
-Bring an unmanaged FalkorDB graph under runic control without re-running anything:
+Bring an existing graph under runic control without re-running anything:
 
 ```bash
 runic baseline -m "baseline"   # introspect, generate root revision, stamp it
@@ -133,9 +133,12 @@ from runic.migrate.adapters import create_adapter
 
 init(Path("runic/"))
 
+# Any supported backend — swap the adapter name and kwargs
 adapter = create_adapter(
     "falkordb", url="falkor://localhost:6379", graph_name="my_graph"
 )
+# adapter = create_adapter("neo4j", host="localhost", port=7687, database="neo4j", username="neo4j", password="secret")
+
 runic = Runic(adapter, script_location=Path("runic/"))
 runic.migrate.upgrade("head")
 
@@ -181,23 +184,28 @@ class Author(Node, labels=["Author"]):
 
 ### Session-based CRUD
 
+`Session` accepts any `GraphDriver`. Use `create_driver()` to build one for your backend:
+
 ```python
-from runic.orm import Session, Repository
+from runic.orm import Session, Repository, create_driver
 
-with Session(graph) as session:
+# Pick your backend — the rest of the code is identical
+driver = create_driver("falkordb", host="localhost", port=6379, graph="myapp")
+
+with Session(driver) as session:
     session.add_all([
         User(id="alice", email="alice@example.com", name="Alice"),
         User(id="bob", email="bob@example.com", name="Bob"),
     ])
     session.commit()
 
-with Session(graph) as session:
+with Session(driver) as session:
     repo = Repository(session, User)
     alice = session.get(User, "alice")
     alice.name = "Alice Smith"  # change tracking — no explicit dirty flag
     session.commit()
 
-with Session(graph) as session:
+with Session(driver) as session:
     user = session.get(User, "bob")
     session.delete(user)
     session.commit()
@@ -207,12 +215,12 @@ with Session(graph) as session:
 
 ```python
 # Lazy load (default) — triggers a query on first access
-with Session(graph) as session:
+with Session(driver) as session:
     author = session.get(Author, "alice")
     posts = author.posts  # query executed here
 
 # Eager load — single round-trip
-with Session(graph) as session:
+with Session(driver) as session:
     author = session.get(Author, "alice", fetch=["posts"])
     posts = author.posts  # already loaded, no extra query
 ```
@@ -220,12 +228,12 @@ with Session(graph) as session:
 ### Pagination and custom queries
 
 ```python
-from runic.orm import Pageable, Repository
+from runic.orm import Repository
 
-with Session(graph) as session:
+with Session(driver) as session:
     repo = Repository(session, User)
-    page = repo.find_all_paginated(Pageable(page=0, size=20, sort_by="name"))
-    print(f"{len(list(page))} of {page.total_elements} total")
+    first_page = repo.find_all(skip=0, limit=20)
+    next_page = repo.find_all(skip=20, limit=20)
 ```
 
 Extend `Repository` to add typed Cypher helpers:
@@ -240,6 +248,28 @@ class UserRepository(Repository[User]):
         )
 ```
 
+### Composable queries
+
+`select()` creates a query statement independently of any session, enabling
+dynamic query composition (e.g. conditional UI filters) before execution:
+
+```python
+from runic.orm import select
+
+stmt = select(User).where(User.active == True)
+if min_age > 0:
+    stmt = stmt.where(User.age >= min_age)
+
+with Session(driver) as session:
+    users: list[User] = session.scalars(stmt)  # list[User]
+    user: User | None = session.scalar(stmt)  # User | None
+    n: int = session.count(stmt)  # int
+```
+
+The same `stmt` is reusable — pass it to multiple sessions or execute it
+multiple times.  The older `session.query(User).where(...).all()` pattern is
+still fully supported.
+
 ### Schema management
 
 Declare indexes inline on `Field`, then let `SchemaManager` keep the live graph in sync:
@@ -256,14 +286,14 @@ class Place(Node, labels=["Place"]):
     lon: float = Field(index=True)
 
 
-schema = SchemaManager(graph)
+schema = SchemaManager(driver)
 schema.sync_schema([Place], drop_extra=False)  # create missing; leave extras alone
 
 result = schema.validate_schema([Place])
 print("valid:", result.is_valid)
 ```
 
-### Native FalkorDB types
+### Native graph types
 
 `Vector`, `GeoLocation`, `datetime`, and `Enum` fields get their converters assigned automatically — no `converter=` argument needed:
 

{runic_py-0.2.2 → runic_py-0.3.2}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "runic-py"
-version = "0.2.2"
-description = "OGM and schema migrations for FalkorDB."
+version = "0.3.2"
+description = "Graph schema migrations and ORM for Cypher-based graph databases."
 readme = "README.md"
 requires-python = ">=3.14"
 license = { text = "MIT" }
@@ -12,39 +12,55 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Topic :: Home Automation",
+    "Topic :: Database",
 ]
 
 dependencies = [
     "typer>=0.26.0,<1.0.0",
-    "rich>=15.0.0,<16.0.0",
-    "falkordb>=1.6.0,<2.0.0",
+    "rich>=14.0.0,<16.0.0",
     "mako>=1.3.0,<2.0.0",
 ]
 
+[project.optional-dependencies]
+falkordb = ["falkordb>=1.6.0,<2.0.0"]
+neo4j = ["neo4j>=6.2.0,<7.0.0"]
+memgraph = ["neo4j>=6.2.0,<7.0.0"]
+arcadedb = ["neo4j>=6.2.0,<7.0.0"]
+age = ["psycopg>=3.3.4,<4.0.0"]
+age-binary = ["psycopg[binary]>=3.3.4,<4.0.0"]
+all = [
+    "falkordb>=1.6.0,<2.0.0",
+    "neo4j>=6.2.0,<7.0.0",
+    "psycopg[binary]>=3.3.4,<4.0.0",
+]
 [dependency-groups]
 dev = [
     "bump-my-version==1.3.0",
+    "deepeval==4.0.5",
     "detect-secrets==1.5.0",
+    "falkordb>=1.6.1",
+    "falkordblite==0.10.0",
+    "furo==2025.12.19",
+    "neo4j==6.2.0",
     "pre-commit==4.6.0",
-    "pytest==9.0.3",
+    "psycopg[binary]==3.3.4",
     "pytest-asyncio==1.4.0",
     "pytest-cov==7.1.0",
     "pytest-httpserver==1.1.5",
+    "pytest==9.0.3",
+    "python-dotenv==1.2.2",
     "ruff==0.15.16",
-    "falkordblite==0.10.0",
-    "sphinx==9.1.0",
-    "furo==2025.12.19",
     "sphinx-copybutton==0.5.2",
     "sphinx-design==0.7.0",
-    "ty>=0.0.44",
+    "sphinx==9.1.0",
+    "ty==0.0.44",
 ]
 
 [project.scripts]
 runic = "runic.migrate.cli:app"
 
 [project.urls]
-Homepage = "https://runic-py.readthedocs.io/latest/"
+Homepage = "https://runic-py.readthedocs.io/en/latest/"
 Repository = "https://github.com/jenreh/runic"
 
 [tool.hatch.build.targets.wheel]
@@ -76,7 +92,7 @@ exclude = [
 
 [tool.bumpversion]
 commit = false
-current_version = "0.2.2"
+current_version = "0.3.2"
 tag = false
 allow-dirty = false
 
@@ -92,8 +108,13 @@ replace = '![Version](https://img.shields.io/badge/version-{new_version}-blue)'
 
 [[tool.bumpversion.files]]
 filename = "docs/source/index.rst"
-search = 'Documentation for version: {current_version}.'
-replace = 'Documentation for version: {new_version}.'
+search = '.. |Github| image:: https://img.shields.io/badge/release-{current_version}-yellow?logo=github'
+replace = '.. |Github| image:: https://img.shields.io/badge/release-{new_version}-yellow?logo=github'
+
+[[tool.bumpversion.files]]
+filename = "docs/source/index.rst"
+search = '   :target: https://github.com/jenreh/runic/tree/v{current_version}'
+replace = '   :target: https://github.com/jenreh/runic/tree/v{new_version}'
 
 [[tool.bumpversion.files]]
 filename = "docs/source/conf.py"
@@ -228,10 +249,14 @@ known-local-folder = ["sonos"]
 [tool.pytest.ini_options]
 cache_dir = ".cache/pytest"
 testpaths = ["tests"]
+# Evals (tests/evals) are excluded from the default suite; run explicitly with
+# `uv run pytest tests/evals`.
+addopts = "--ignore=tests/evals"
 asyncio_mode = "auto"
 markers = [
-    "sonos_live: requires real Sonos hardware on the network",
-    "integration: requires falkordblite (embedded FalkorDB, no external server)",
+    "integration: requires a live graph backend (embedded FalkorDB via redislite by default; other backends via RUNIC_TEST_BACKENDS env var + docker-compose.test.yml)",
+    "requires_multi_label: test requires multi-label node support (not available on Apache AGE)",
+    "requires_geo_update: test requires SET n.prop = point() support (not available on ArcadeDB via Bolt)",
 ]
 
 [tool.ty.environment]
@@ -245,12 +270,16 @@ exclude = [
     ".venv",
     "build",
     "dist",
+    "examples",
 ]
 
 [tool.ty.rules]
 unresolved-import = "warn"
 missing-argument = "error"
 
+[tool.mypy]
+cache_dir = ".cache/mypy"
+
 [tool.coverage.run]
 branch = true
 source = ["app", "runic"]

{runic_py-0.2.2 → runic_py-0.3.2}/runic/migrate/__init__.py

@@ -8,19 +8,29 @@ from runic.migrate.manifest import (
     UniqueConstraint,
     VectorIndex,
 )
+from runic.migrate.schema import (
+    IndexManager,
+    SchemaInfo,
+    SchemaManager,
+    ValidationResult,
+)
 from runic.migrate.script import AmbiguousRevision, RevisionNotFound
 from runic.migrate.service import init
 
 __all__ = [
     "AmbiguousRevision",
     "FulltextIndex",
+    "IndexManager",
     "IrreversibleMigrationError",
     "MandatoryConstraint",
     "RangeIndex",
     "RevisionNotFound",
     "Runic",
+    "SchemaInfo",
+    "SchemaManager",
     "SchemaManifest",
     "UniqueConstraint",
+    "ValidationResult",
     "VectorIndex",
     "context",
     "init",