runic-py 0.3.3__tar.gz → 0.3.4__tar.gz

{runic_py-0.3.3 → runic_py-0.3.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: runic-py
-Version: 0.3.3
-Summary: Graph schema migrations and ORM for Cypher-based graph databases.
+Version: 0.3.4
+Summary: Graph schema migrations and OGM 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
@@ -40,9 +40,9 @@ Description-Content-Type: text/markdown
 
 # Runic
 
-**Graph schema migrations and ORM for Cypher-based graph databases.**
+**Graph schema migrations and OGM for Cypher-based graph databases.**
 
-![Version](https://img.shields.io/badge/version-0.3.3-blue)
+![Version](https://img.shields.io/badge/version-0.3.4-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)
@@ -56,7 +56,7 @@ Description-Content-Type: text/markdown
 **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 via a pluggable driver layer supporting FalkorDB, ArcadeDB, and any Bolt-compatible database.
+- **`runic.ogm`** — A lightweight graph OGM: 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
 
@@ -184,12 +184,12 @@ print("current:", runic.migrate.current())
 
 ---
 
-## runic.orm
+## runic.ogm
 
 ### Defining models
 
 ```python
-from runic.orm import Field, Node, Edge, Relation
+from runic.ogm import Field, Node, Edge, Relation
 
 
 class User(Node, labels=["User"]):
@@ -224,7 +224,7 @@ class Author(Node, labels=["Author"]):
 `Session` accepts any `GraphDriver`. Use `create_driver()` to build one for your backend:
 
 ```python
-from runic.orm import Session, Repository, create_driver
+from runic.ogm import Session, Repository, create_driver
 
 # Pick your backend — the rest of the code is identical
 driver = create_driver("falkordb", host="localhost", port=6379, graph="myapp")
@@ -265,7 +265,7 @@ with Session(driver) as session:
 ### Pagination and custom queries
 
 ```python
-from runic.orm import Repository
+from runic.ogm import Repository
 
 with Session(driver) as session:
     repo = Repository(session, User)
@@ -291,7 +291,7 @@ class UserRepository(Repository[User]):
 dynamic query composition (e.g. conditional UI filters) before execution:
 
 ```python
-from runic.orm import select
+from runic.ogm import select
 
 stmt = select(User).where(User.active == True)
 if min_age > 0:
@@ -312,7 +312,7 @@ still fully supported.
 Declare indexes inline on `Field`, then let `SchemaManager` keep the live graph in sync:
 
 ```python
-from runic.orm import Field, IndexManager, Node, SchemaManager
+from runic.ogm import Field, IndexManager, Node, SchemaManager
 
 
 class Place(Node, labels=["Place"]):
@@ -337,7 +337,7 @@ print("valid:", result.is_valid)
 ```python
 from datetime import UTC, datetime
 from enum import StrEnum
-from runic.orm import Field, GeoLocation, Node, Vector
+from runic.ogm import Field, GeoLocation, Node, Vector
 
 
 class Status(StrEnum):

{runic_py-0.3.3 → runic_py-0.3.4}/README.md

@@ -3,9 +3,9 @@
 
 # Runic
 
-**Graph schema migrations and ORM for Cypher-based graph databases.**
+**Graph schema migrations and OGM for Cypher-based graph databases.**
 
-![Version](https://img.shields.io/badge/version-0.3.3-blue)
+![Version](https://img.shields.io/badge/version-0.3.4-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)
@@ -19,7 +19,7 @@
 **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 via a pluggable driver layer supporting FalkorDB, ArcadeDB, and any Bolt-compatible database.
+- **`runic.ogm`** — A lightweight graph OGM: 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
 
@@ -147,12 +147,12 @@ print("current:", runic.migrate.current())
 
 ---
 
-## runic.orm
+## runic.ogm
 
 ### Defining models
 
 ```python
-from runic.orm import Field, Node, Edge, Relation
+from runic.ogm import Field, Node, Edge, Relation
 
 
 class User(Node, labels=["User"]):
@@ -187,7 +187,7 @@ class Author(Node, labels=["Author"]):
 `Session` accepts any `GraphDriver`. Use `create_driver()` to build one for your backend:
 
 ```python
-from runic.orm import Session, Repository, create_driver
+from runic.ogm import Session, Repository, create_driver
 
 # Pick your backend — the rest of the code is identical
 driver = create_driver("falkordb", host="localhost", port=6379, graph="myapp")
@@ -228,7 +228,7 @@ with Session(driver) as session:
 ### Pagination and custom queries
 
 ```python
-from runic.orm import Repository
+from runic.ogm import Repository
 
 with Session(driver) as session:
     repo = Repository(session, User)
@@ -254,7 +254,7 @@ class UserRepository(Repository[User]):
 dynamic query composition (e.g. conditional UI filters) before execution:
 
 ```python
-from runic.orm import select
+from runic.ogm import select
 
 stmt = select(User).where(User.active == True)
 if min_age > 0:
@@ -275,7 +275,7 @@ still fully supported.
 Declare indexes inline on `Field`, then let `SchemaManager` keep the live graph in sync:
 
 ```python
-from runic.orm import Field, IndexManager, Node, SchemaManager
+from runic.ogm import Field, IndexManager, Node, SchemaManager
 
 
 class Place(Node, labels=["Place"]):
@@ -300,7 +300,7 @@ print("valid:", result.is_valid)
 ```python
 from datetime import UTC, datetime
 from enum import StrEnum
-from runic.orm import Field, GeoLocation, Node, Vector
+from runic.ogm import Field, GeoLocation, Node, Vector
 
 
 class Status(StrEnum):

{runic_py-0.3.3 → runic_py-0.3.4}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "runic-py"
-version = "0.3.3"
-description = "Graph schema migrations and ORM for Cypher-based graph databases."
+version = "0.3.4"
+description = "Graph schema migrations and OGM for Cypher-based graph databases."
 readme = "README.md"
 requires-python = ">=3.14"
 license = { text = "MIT" }
@@ -93,7 +93,7 @@ exclude = [
 
 [tool.bumpversion]
 commit = false
-current_version = "0.3.3"
+current_version = "0.3.4"
 tag = false
 allow-dirty = false
 

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/__init__.py

@@ -21,7 +21,7 @@ class GraphAdapter(Protocol):
     @property
     def name(self) -> str: ...
 
-    # Normalised query execution (satisfies runic.orm.operations._Executor)
+    # Normalised query execution (satisfies runic.ogm.operations._Executor)
     def execute(self, cypher: str, params: dict[str, Any]) -> Any: ...
 
     # Low-level query execution

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/_base.py

@@ -12,7 +12,7 @@ from abc import ABC, abstractmethod
 from typing import Any, Protocol, runtime_checkable
 
 from runic.migrate.introspect import LiveSchema, SchemaSnapshot
-from runic.orm.schema.index_manager import IndexSpec
+from runic.ogm.schema.index_manager import IndexSpec
 
 log = logging.getLogger(__name__)
 

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/age.py

@@ -3,7 +3,7 @@
 Apache AGE stores graph data inside PostgreSQL, so migration version-tracking
 nodes are created as AGE vertices (not PostgreSQL tables).  The adapter
 executes Cypher through the AGE ``cypher()`` SQL function and delegates
-agtype decoding to the :mod:`runic.orm.driver.age` module.
+agtype decoding to the :mod:`runic.ogm.driver.age` module.
 """
 
 from __future__ import annotations
@@ -13,8 +13,8 @@ from typing import Any
 
 from runic.migrate.adapters import GraphAdapter
 from runic.migrate.adapters._base import GraphAdapterBase
-from runic.orm.driver.age import AGEDriver
-from runic.orm.schema.index_manager import IndexSpec
+from runic.ogm.driver.age import AGEDriver
+from runic.ogm.schema.index_manager import IndexSpec
 
 log = logging.getLogger(__name__)
 
@@ -40,7 +40,7 @@ class AGEAdapter(GraphAdapterBase, GraphAdapter):
         username: str = "postgres",
         password: str = "",  # noqa: S107
     ) -> AGEAdapter:
-        from runic.orm.driver.age import create_age_driver
+        from runic.ogm.driver.age import create_age_driver
 
         driver = create_age_driver(
             host=host,
@@ -64,7 +64,7 @@ class AGEAdapter(GraphAdapterBase, GraphAdapter):
     def run_query(self, query: str, params: dict | None = None) -> Any:
         result = self._driver.execute(query, params or {})
         # AGEDriver no longer auto-commits; the adapter owns the transaction
-        # lifecycle for write operations (not managed by an ORM Session here).
+        # lifecycle for write operations (not managed by an OGM Session here).
         self._driver.commit()
         return result
 

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/arcadedb.py

@@ -7,9 +7,9 @@ from typing import Any
 
 from runic.migrate.adapters import GraphAdapter
 from runic.migrate.adapters._base import GraphAdapterBase
-from runic.orm.driver.arcadedb import ArcadeDBDialect
-from runic.orm.driver.bolt import BoltDriver
-from runic.orm.schema.index_manager import IndexSpec
+from runic.ogm.driver.arcadedb import ArcadeDBDialect
+from runic.ogm.driver.bolt import BoltDriver
+from runic.ogm.schema.index_manager import IndexSpec
 
 log = logging.getLogger(__name__)
 

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/falkordb.py

@@ -10,8 +10,8 @@ from runic.migrate.adapters._base import _encode_kv_list, _parse_kv_list
 from runic.migrate.exceptions import ConstraintFailedError, ConstraintTimeoutError
 from runic.migrate.introspect import LiveSchema
 from runic.migrate.manifest import UniqueConstraint
-from runic.orm.driver.falkordb import FalkorDBDriver, FalkorDBResult
-from runic.orm.schema.index_manager import IndexSpec
+from runic.ogm.driver.falkordb import FalkorDBDriver, FalkorDBResult
+from runic.ogm.schema.index_manager import IndexSpec
 
 log = logging.getLogger(__name__)
 
@@ -34,7 +34,7 @@ _SET_TRACKING_QUERY = (
 class FalkorDBAdapter(GraphAdapter):
     """GraphAdapter implementation for FalkorDB (standalone or embedded via falkordblite).
 
-    Query execution is routed through :class:`~runic.orm.driver.falkordb.FalkorDBDriver`
+    Query execution is routed through :class:`~runic.ogm.driver.falkordb.FalkorDBDriver`
     so results are normalised to ``GraphResult.rows`` — consistent with Bolt adapters.
     The raw ``db`` and ``graph`` references are kept only for FalkorDB-specific migration
     operations (constraint DDL via Redis commands, snapshot copy/delete).
@@ -97,7 +97,7 @@ class FalkorDBAdapter(GraphAdapter):
         return self._graph.name  # type: ignore[no-any-return]
 
     def execute(self, cypher: str, params: dict[str, Any]) -> FalkorDBResult:
-        """Normalised query execution via ORM driver (result has .rows)."""
+        """Normalised query execution via OGM driver (result has .rows)."""
         return self._driver.execute(cypher, params)
 
     def run_query(self, query: str, params: dict | None = None) -> FalkorDBResult:

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/memgraph.py

@@ -7,9 +7,9 @@ from typing import Any
 
 from runic.migrate.adapters import GraphAdapter
 from runic.migrate.adapters._base import GraphAdapterBase
-from runic.orm.driver.bolt import BoltDriver
-from runic.orm.driver.memgraph import _MEMGRAPH_DIALECT, MemgraphDialect
-from runic.orm.schema.index_manager import IndexSpec
+from runic.ogm.driver.bolt import BoltDriver
+from runic.ogm.driver.memgraph import _MEMGRAPH_DIALECT, MemgraphDialect
+from runic.ogm.schema.index_manager import IndexSpec
 
 log = logging.getLogger(__name__)
 
@@ -17,7 +17,7 @@ log = logging.getLogger(__name__)
 class MemgraphAdapter(GraphAdapterBase, GraphAdapter):
     """Migration adapter for Memgraph accessed via Bolt protocol.
 
-    Named index convention (must match :class:`~runic.orm.driver.memgraph.MemgraphDialect`):
+    Named index convention (must match :class:`~runic.ogm.driver.memgraph.MemgraphDialect`):
 
     - **Fulltext** (text search) index name = ``{label}`` (e.g. ``Post``)
     - **Vector** index name = ``{label}_{prop}`` (e.g. ``Article_embedding``)

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/adapters/neo4j.py

@@ -7,9 +7,9 @@ from typing import Any
 
 from runic.migrate.adapters import GraphAdapter
 from runic.migrate.adapters._base import GraphAdapterBase
-from runic.orm.driver.bolt import BoltDriver
-from runic.orm.driver.neo4j import _NEO4J_DIALECT, Neo4jDialect
-from runic.orm.schema.index_manager import IndexSpec
+from runic.ogm.driver.bolt import BoltDriver
+from runic.ogm.driver.neo4j import _NEO4J_DIALECT, Neo4jDialect
+from runic.ogm.schema.index_manager import IndexSpec
 
 log = logging.getLogger(__name__)
 
@@ -17,7 +17,7 @@ log = logging.getLogger(__name__)
 class Neo4jAdapter(GraphAdapterBase, GraphAdapter):
     """Migration adapter for Neo4j 5.x accessed via Bolt protocol.
 
-    Named index convention (must match :class:`~runic.orm.driver.neo4j.Neo4jDialect`):
+    Named index convention (must match :class:`~runic.ogm.driver.neo4j.Neo4jDialect`):
 
     - **Fulltext** index name = ``{label}`` (e.g. ``Post``)
     - **Vector** index name = ``{label}_{prop}`` (e.g. ``Article_embedding``)

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/operations.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import logging
 from typing import TYPE_CHECKING
 
-from runic.orm.operations import DataOperations
+from runic.ogm.operations import DataOperations
 
 if TYPE_CHECKING:
     from runic.migrate.adapters import GraphAdapter
@@ -14,7 +14,7 @@ log = logging.getLogger(__name__)
 class GraphOperations(DataOperations):
     """Migration-script API: data manipulation + DDL, both with preview mode.
 
-    Extends :class:`~runic.orm.operations.DataOperations` with DDL operations
+    Extends :class:`~runic.ogm.operations.DataOperations` with DDL operations
     (indexes, constraints, snapshots) that delegate to the underlying adapter.
 
     Migration scripts receive this object as their ``ops`` argument::

{runic_py-0.3.3 → runic_py-0.3.4}/runic/migrate/schema.py

@@ -6,7 +6,7 @@ import logging
 from dataclasses import dataclass, field
 from typing import Any
 
-from runic.orm.schema.index_manager import IndexSpec, extract_declared_specs
+from runic.ogm.schema.index_manager import IndexSpec, extract_declared_specs
 
 log = logging.getLogger(__name__)
 
@@ -138,7 +138,7 @@ class IndexManager:
         When *if_not_exists* is ``True`` (default), existing non-FULLTEXT specs are
         skipped.  FULLTEXT creation is always attempted — adapters must handle idempotency.
         """
-        from runic.orm.core.models import Edge, Node
+        from runic.ogm.core.models import Edge, Node
 
         if issubclass(entity_class, Node):
             label: str = getattr(entity_class, "_primary_label", entity_class.__name__)
@@ -252,7 +252,7 @@ class SchemaManager:
         No-op for schemaless backends.  Issues ``CREATE VERTEX TYPE`` / ``CREATE EDGE TYPE``
         DDL for ArcadeDB.
         """
-        from runic.orm.core.models import Edge, Node
+        from runic.ogm.core.models import Edge, Node
 
         for cls in entity_classes:
             if issubclass(cls, Node):

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/__init__.py

@@ -1,25 +1,25 @@
-"""runic.orm — lightweight graph ORM for Cypher-based graph databases."""
+"""runic.ogm — lightweight graph OGM for Cypher-based graph databases."""
 
-from runic.orm.driver import (
+from runic.ogm.driver import (
     AsyncGraphDriver,
     GraphDialect,
     GraphDriver,
     GraphResult,
     TransactionalGraphDriver,
 )
-from runic.orm.driver.age import AGEDialect, AGEDriver, create_age_driver
-from runic.orm.driver.arcadedb import ArcadeDBDialect, create_arcadedb_driver
-from runic.orm.driver.bolt import BoltDriver
-from runic.orm.driver.factory import create_driver
-from runic.orm.driver.falkordb import (
+from runic.ogm.driver.age import AGEDialect, AGEDriver, create_age_driver
+from runic.ogm.driver.arcadedb import ArcadeDBDialect, create_arcadedb_driver
+from runic.ogm.driver.bolt import BoltDriver
+from runic.ogm.driver.factory import create_driver
+from runic.ogm.driver.falkordb import (
     AsyncFalkorDBDriver,
     FalkorDBDialect,
     FalkorDBDriver,
     create_falkordb_driver,
 )
-from runic.orm.driver.memgraph import MemgraphDialect, create_memgraph_driver
-from runic.orm.driver.neo4j import Neo4jDialect, create_neo4j_driver
-from runic.orm.core.descriptors import (
+from runic.ogm.driver.memgraph import MemgraphDialect, create_memgraph_driver
+from runic.ogm.driver.neo4j import Neo4jDialect, create_neo4j_driver
+from runic.ogm.core.descriptors import (
     MISSING,
     Field,
     FieldDescriptor,
@@ -27,9 +27,9 @@ from runic.orm.core.descriptors import (
     Relation,
     _NOT_LOADED,
 )
-from runic.orm.core.metadata import EdgeMeta, MetaData, NodeMeta, get_metadata, metadata
-from runic.orm.core.models import Edge, Node
-from runic.orm.core.types import (
+from runic.ogm.core.metadata import EdgeMeta, MetaData, NodeMeta, get_metadata, metadata
+from runic.ogm.core.models import Edge, Node
+from runic.ogm.core.types import (
     DatetimeConverter,
     EnumConverter,
     GeoLocation,
@@ -38,7 +38,7 @@ from runic.orm.core.types import (
     Vector,
     VectorConverter,
 )
-from runic.orm.exceptions import (
+from runic.ogm.exceptions import (
     DetachedEntityError,
     EntityNotFoundError,
     FieldValidationError,
@@ -46,11 +46,11 @@ from runic.orm.exceptions import (
     MetadataError,
     OrmError,
 )
-from runic.orm.mapper.mapper import Mapper
-from runic.orm.mapper.relationship_loader import RelationshipLoader
-from runic.orm.repository.async_repository import AsyncRepository
-from runic.orm.repository.repository import Repository
-from runic.orm.query import (
+from runic.ogm.mapper.mapper import Mapper
+from runic.ogm.mapper.relationship_loader import RelationshipLoader
+from runic.ogm.repository.async_repository import AsyncRepository
+from runic.ogm.repository.repository import Repository
+from runic.ogm.query import (
     AsyncQueryBuilder,
     FulltextQueryBuilder,
     QueryBuilder,
@@ -63,7 +63,7 @@ from runic.orm.query import (
     select,
     sum_,
 )
-from runic.orm.query.expressions import (
+from runic.ogm.query.expressions import (
     AggExpr,
     CompoundExpr,
     Expr,
@@ -71,10 +71,10 @@ from runic.orm.query.expressions import (
     NegatedExpr,
     OrderExpr,
 )
-from runic.orm.schema.index_manager import IndexSpec
-from runic.orm.session.async_session import AsyncSession
-from runic.orm.session.connection_pool import AsyncConnectionManager, ConnectionManager
-from runic.orm.session.session import Session
+from runic.ogm.schema.index_manager import IndexSpec
+from runic.ogm.session.async_session import AsyncSession
+from runic.ogm.session.connection_pool import AsyncConnectionManager, ConnectionManager
+from runic.ogm.session.session import Session
 
 __all__ = [  # noqa: RUF022
     # Driver / dialect

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/core/descriptors.py

@@ -7,7 +7,7 @@ from collections.abc import Callable
 from typing import TYPE_CHECKING, Any, Literal, overload
 
 if TYPE_CHECKING:
-    from runic.orm.core.types import TypeConverter
+    from runic.ogm.core.types import TypeConverter
 
 log = logging.getLogger(__name__)
 
@@ -43,8 +43,8 @@ class FieldDescriptor:
     --------------------------
     When accessed at the **class level** (``User.name``, ``Rated.score``),
     the descriptor returns itself.  The comparison operators defined below
-    produce :class:`~runic.orm.query.expressions.FilterExpr` objects for use
-    with :meth:`~runic.orm.query.builder.QueryBuilder.where`:
+    produce :class:`~runic.ogm.query.expressions.FilterExpr` objects for use
+    with :meth:`~runic.ogm.query.builder.QueryBuilder.where`:
 
     .. code-block:: python
 
@@ -159,7 +159,7 @@ class FieldDescriptor:
 
         session_ref = obj.__dict__.get("_session")
         if session_ref is None:
-            from runic.orm.exceptions import DetachedEntityError
+            from runic.ogm.exceptions import DetachedEntityError
 
             raise DetachedEntityError(
                 f"Entity {obj!r} has no active session. "
@@ -167,7 +167,7 @@ class FieldDescriptor:
             )
         session = session_ref() if isinstance(session_ref, weakref.ref) else session_ref
         if session is None:
-            from runic.orm.exceptions import DetachedEntityError
+            from runic.ogm.exceptions import DetachedEntityError
 
             raise DetachedEntityError(
                 f"Entity {obj!r}'s session was garbage-collected. "
@@ -228,7 +228,7 @@ class FieldDescriptor:
     __hash__ = object.__hash__  # type: ignore[assignment]
 
     def _make_filter(self, op: str, value: Any, negate: bool = False) -> Any:
-        from runic.orm.query.expressions import FilterExpr
+        from runic.ogm.query.expressions import FilterExpr
 
         return FilterExpr(
             cls=self._owner or type(self),

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/core/metadata.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import logging
 from dataclasses import dataclass, field
 
-from runic.orm.core.descriptors import FieldDescriptor, FieldInfo
+from runic.ogm.core.descriptors import FieldDescriptor, FieldInfo
 
 log = logging.getLogger(__name__)
 

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/core/models.py

@@ -9,8 +9,8 @@ from datetime import datetime
 from enum import Enum
 from typing import Any, ClassVar, dataclass_transform
 
-from runic.orm.core.descriptors import Field, FieldDescriptor, FieldInfo
-from runic.orm.core.types import (
+from runic.ogm.core.descriptors import Field, FieldDescriptor, FieldInfo
+from runic.ogm.core.types import (
     DatetimeConverter,
     EnumConverter,
     GeoLocation,
@@ -232,7 +232,7 @@ class Node:
         _apply_auto_converters(cls, cls._fields)
         cls.__init__ = _make_init(cls._fields)  # ty:ignore[invalid-assignment]
 
-        from runic.orm.core.metadata import metadata
+        from runic.ogm.core.metadata import metadata
 
         metadata.register_node(cls)
         log.debug("Node subclass registered: %s", cls.__name__)
@@ -292,7 +292,7 @@ class Edge:
         _apply_auto_converters(cls, cls._fields)
         cls.__init__ = _make_init(cls._fields)  # ty:ignore[invalid-assignment]
 
-        from runic.orm.core.metadata import metadata
+        from runic.ogm.core.metadata import metadata
 
         metadata.register_edge(cls)
         log.debug("Edge subclass registered: %s", cls.__name__)

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/driver/__init__.py

@@ -1,11 +1,11 @@
-"""runic.orm.driver — database driver and dialect Protocols (ISP-compliant)."""
+"""runic.ogm.driver — database driver and dialect Protocols (ISP-compliant)."""
 
 from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any, Protocol, runtime_checkable
 
 if TYPE_CHECKING:
-    from runic.orm.core.descriptors import FieldInfo
+    from runic.ogm.core.descriptors import FieldInfo
 
 
 class GraphNode(Protocol):
@@ -91,7 +91,7 @@ class TransactionalGraphDriver(Protocol):
     """Sync driver that supports explicit ACID transactions.
 
     Drivers that implement this protocol (BoltDriver, AGEDriver) allow the
-    ORM Session to wrap multi-query operations in a single database transaction.
+    OGM Session to wrap multi-query operations in a single database transaction.
 
     Drivers without native transaction support (FalkorDB) do NOT implement
     this protocol — each query is individually atomic at the DB level.

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/driver/age.py

@@ -22,7 +22,7 @@ import re
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
-    from runic.orm.core.descriptors import FieldInfo
+    from runic.ogm.core.descriptors import FieldInfo
 
 log = logging.getLogger(__name__)
 
@@ -440,14 +440,14 @@ class AGEDriver:
     ``cypher()``, making them accessible inside Cypher as ``$param_name``.
 
     Supports explicit ACID transactions via
-    :class:`~runic.orm.driver.TransactionalGraphDriver`.  psycopg3 starts an
+    :class:`~runic.ogm.driver.TransactionalGraphDriver`.  psycopg3 starts an
     implicit ``BEGIN`` on the first statement after each commit/rollback
     (``autocommit=False`` default); this driver's ``commit()`` / ``rollback()``
     map directly to ``conn.commit()`` / ``conn.rollback()``.  ``begin()`` is a
     documented no-op because psycopg3 manages the implicit transaction start
     automatically.
 
-    The ORM :class:`~runic.orm.session.session.Session` drives this lifecycle:
+    The OGM :class:`~runic.ogm.session.session.Session` drives this lifecycle:
     the first query in a Session opens a transaction implicitly; ``commit()`` /
     ``rollback()`` finalise it.
 
@@ -488,8 +488,8 @@ class AGEDriver:
     def begin(self) -> None:
         """No-op: psycopg3 starts an implicit BEGIN on the first statement.
 
-        Exists to satisfy the :class:`~runic.orm.driver.TransactionalGraphDriver`
-        protocol so the ORM Session can detect transaction support via
+        Exists to satisfy the :class:`~runic.ogm.driver.TransactionalGraphDriver`
+        protocol so the OGM Session can detect transaction support via
         ``isinstance`` checks.
         """
 

{runic_py-0.3.3/runic/orm → runic_py-0.3.4/runic/ogm}/driver/arcadedb.py

@@ -9,10 +9,10 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
 
-from runic.orm.driver.bolt import BoltDriver, BoltEdge, BoltNode
+from runic.ogm.driver.bolt import BoltDriver, BoltEdge, BoltNode
 
 if TYPE_CHECKING:
-    from runic.orm.core.descriptors import FieldInfo
+    from runic.ogm.core.descriptors import FieldInfo
 
 
 class ArcadeDBNode(BoltNode):
@@ -86,7 +86,7 @@ def create_arcadedb_driver(
     username: str,
     password: str,
 ) -> BoltDriver:
-    """Create a :class:`~runic.orm.driver.bolt.BoltDriver` configured for ArcadeDB."""
+    """Create a :class:`~runic.ogm.driver.bolt.BoltDriver` configured for ArcadeDB."""
     return BoltDriver.from_params(
         host=host,
         port=port,