xtr-orm 5.0.0__tar.gz → 5.1.0__tar.gz

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xtr-orm
-Version: 5.0.0
+Version: 5.1.0
 Summary: Databases for async applications: engines, sessions and versioned schema migrations, configured once per connection.
 Keywords: orm,database,migrations,sqlalchemy,alembic,asyncio
 Author: Xterr
@@ -203,15 +203,15 @@ removing it undoes.
   those databases. Install xtr-console beside it for the `orm:*` commands, and xtr-messenger for
   the [message bus middleware](#message-bus-middleware).
 - **Recipe** — `uv run xtr-recipes recipes:sync` does the *Activate*, *Configure* and
-  *Environment* steps below: it lists `OrmBundle`, writes a starting `<app>/config/orm.py` with the
+  *Environment* steps below: it lists `OrmBundle`, writes a starting `<app>/config/packages/orm.py` with the
   `default` connection, and `DATABASE_URL` in `.env`. It prints the middleware step, which a recipe
   cannot make for you.
-- **Activate** — `OrmBundle: {"all": True}` in `BUNDLES` in `<app>/bundles.py`, imported from
+- **Activate** — `OrmBundle: {"all": True}` in `BUNDLES` in `<app>/config/bundles.py`, imported from
   `xtr_orm.bundle`.
 - **Brings along** — the logging and console bundles, when those packages are installed.
   With the messenger bundle active too, the [middleware](#message-bus-middleware) are
   registered for a bus to list.
-- **Configure** — the recipe writes a starting `<app>/config/orm.py` with the `default`
+- **Configure** — the recipe writes a starting `<app>/config/packages/orm.py` with the `default`
   connection reading `DATABASE_URL`, its revisions in `migrations` in the project directory and
   diffs against the models advanced-alchemy registers. Add connections, replicas and table
   definitions to that `@configure` function returning `OrmConfig` — see
@@ -221,7 +221,7 @@ removing it undoes.
   [Options in the URL](#options-in-the-url).
 - **Ignore** — nothing: commit `migrations/`.
 - **Remove** — take the `orm_*` entries out of every bus's `middleware`, drop the `BUNDLES`
-  entry, delete `<app>/config/orm.py`, then `uv remove xtr-orm`.
+  entry, delete `<app>/config/packages/orm.py`, then `uv remove xtr-orm`.
 - **Check** — `debug:bundles` shows `orm` as `listed` and `active`, and
   `orm:migrations:status` reaches the database.
 
@@ -232,14 +232,14 @@ not a dependency, and nothing outside `xtr_orm.bundle` needs it — list the bun
 connections:
 
 ```python
-# app/bundles.py
+# app/config/bundles.py
 from xtr_orm.bundle import OrmBundle
 
 BUNDLES = {OrmBundle: {"all": True}}
 ```
 
 ```python
-# app/config/orm.py
+# app/config/packages/orm.py
 from xtr_dependency_injection import configure, env
 from xtr_orm.bundle import ConnectionConfig, OrmConfig
 
@@ -479,7 +479,7 @@ class NotifyAccounting:
 ```
 
 ```python
-# app/config/messenger.py
+# app/config/packages/messenger.py
 MessageBusConfig(
     middleware=[
         "orm_close_connection",

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/README.md

@@ -171,15 +171,15 @@ removing it undoes.
   those databases. Install xtr-console beside it for the `orm:*` commands, and xtr-messenger for
   the [message bus middleware](#message-bus-middleware).
 - **Recipe** — `uv run xtr-recipes recipes:sync` does the *Activate*, *Configure* and
-  *Environment* steps below: it lists `OrmBundle`, writes a starting `<app>/config/orm.py` with the
+  *Environment* steps below: it lists `OrmBundle`, writes a starting `<app>/config/packages/orm.py` with the
   `default` connection, and `DATABASE_URL` in `.env`. It prints the middleware step, which a recipe
   cannot make for you.
-- **Activate** — `OrmBundle: {"all": True}` in `BUNDLES` in `<app>/bundles.py`, imported from
+- **Activate** — `OrmBundle: {"all": True}` in `BUNDLES` in `<app>/config/bundles.py`, imported from
   `xtr_orm.bundle`.
 - **Brings along** — the logging and console bundles, when those packages are installed.
   With the messenger bundle active too, the [middleware](#message-bus-middleware) are
   registered for a bus to list.
-- **Configure** — the recipe writes a starting `<app>/config/orm.py` with the `default`
+- **Configure** — the recipe writes a starting `<app>/config/packages/orm.py` with the `default`
   connection reading `DATABASE_URL`, its revisions in `migrations` in the project directory and
   diffs against the models advanced-alchemy registers. Add connections, replicas and table
   definitions to that `@configure` function returning `OrmConfig` — see
@@ -189,7 +189,7 @@ removing it undoes.
   [Options in the URL](#options-in-the-url).
 - **Ignore** — nothing: commit `migrations/`.
 - **Remove** — take the `orm_*` entries out of every bus's `middleware`, drop the `BUNDLES`
-  entry, delete `<app>/config/orm.py`, then `uv remove xtr-orm`.
+  entry, delete `<app>/config/packages/orm.py`, then `uv remove xtr-orm`.
 - **Check** — `debug:bundles` shows `orm` as `listed` and `active`, and
   `orm:migrations:status` reaches the database.
 
@@ -200,14 +200,14 @@ not a dependency, and nothing outside `xtr_orm.bundle` needs it — list the bun
 connections:
 
 ```python
-# app/bundles.py
+# app/config/bundles.py
 from xtr_orm.bundle import OrmBundle
 
 BUNDLES = {OrmBundle: {"all": True}}
 ```
 
 ```python
-# app/config/orm.py
+# app/config/packages/orm.py
 from xtr_dependency_injection import configure, env
 from xtr_orm.bundle import ConnectionConfig, OrmConfig
 
@@ -447,7 +447,7 @@ class NotifyAccounting:
 ```
 
 ```python
-# app/config/messenger.py
+# app/config/packages/messenger.py
 MessageBusConfig(
     middleware=[
         "orm_close_connection",

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "xtr-orm"
-version = "5.0.0"
+version = "5.1.0"
 description = "Databases for async applications: engines, sessions and versioned schema migrations, configured once per connection."
 readme = "README.md"
 requires-python = ">=3.11"

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "xtr-orm"
-version = "5.0.0"
+version = "5.1.0"
 description = "Databases for async applications: engines, sessions and versioned schema migrations, configured once per connection."
 readme = "README.md"
 requires-python = ">=3.11"

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/src/xtr_orm/.agents/skills/xtr-orm/SKILL.md

@@ -14,7 +14,7 @@ connection's name. Everything is async; there is no sync counterpart.
 
 - Inject `Injected[AsyncSession]` for the default connection;
   `Annotated[AsyncSession, Target("reports")]` for another. Never build a session yourself.
-- Name databases in `<app>/config/orm.py` with a `@configure` function returning `OrmConfig`.
+- Name databases in `<app>/config/packages/orm.py` with a `@configure` function returning `OrmConfig`.
 - Set `DATABASE_URL` with an async driver: `postgresql+asyncpg://`, `mysql+asyncmy://`,
   `sqlite+aiosqlite:///`. Engine and session options may ride on its query.
 - Write a revision from your models: `orm:migrations:diff --message "add invoices"`. Apply:
@@ -225,14 +225,14 @@ migrate = MigrationsMigrateCommand(registry)
 ## Use in an application
 
 `uv run xtr-recipes recipes:sync` applies the recipe shipped with this package: it lists `OrmBundle`,
-writes a starting `config/orm.py` with the `default` connection, and `DATABASE_URL` in `.env`. That
+writes a starting `config/packages/orm.py` with the `default` connection, and `DATABASE_URL` in `.env`. That
 is the steps below a recipe can do; the middleware it prints for you to add.
 
 1. **Install** — `uv add "xtr-orm[postgres]" xtr-dependency-injection`: the bundle needs the
    container installed beside it, never as an extra; `mysql` or `sqlite` instead of `postgres`.
    Install xtr-console beside it for the `orm:*` commands, and xtr-messenger for the bus
    middleware.
-2. **Activate** — `OrmBundle: {"all": True}` in `BUNDLES` in `<app>/bundles.py`
+2. **Activate** — `OrmBundle: {"all": True}` in `BUNDLES` in `<app>/config/bundles.py`
    (`from xtr_orm.bundle import OrmBundle`).
 3. **Brings along** — the logging and console bundles when those packages are installed, each
    optional. With the logging bundle active an `orm` channel is added and every migrator logs the
@@ -242,7 +242,7 @@ is the steps below a recipe can do; the middleware it prints for you to add.
    advanced-alchemy registers.
 
    ```python
-   # <app>/config/orm.py
+   # <app>/config/packages/orm.py
    from xtr_dependency_injection import configure, env
    from xtr_orm.bundle import ConnectionConfig, MigrationsConfig, OrmConfig
 
@@ -274,7 +274,7 @@ is the steps below a recipe can do; the middleware it prints for you to add.
 8. **Check** — `debug:bundles` shows `orm` as `listed` and `active`, and
    `orm:migrations:status` reaches the database.
 9. **Remove** — take the `orm_*` entries out of every bus's `middleware`, drop the `BUNDLES`
-   entry, delete `<app>/config/orm.py`, then `uv remove xtr-orm`.
+   entry, delete `<app>/config/packages/orm.py`, then `uv remove xtr-orm`.
 
 `OrmConfig` has two fields: `default_connection` (`"default"`) and `connections`
 (`{"default": ConnectionConfig()}`). Two connections may not keep their revisions in one
@@ -287,7 +287,7 @@ With xtr-messenger installed beside it and both bundles active, three middleware
 by name. Nothing is added to a bus by itself — the bus lists what it wants, and order matters.
 
 ```python
-# <app>/config/messenger.py
+# <app>/config/packages/messenger.py
 MessageBusConfig(
     middleware=[
         "orm_close_connection",  # outermost: closes after the transaction ended

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/src/xtr_orm/.agents/skills/xtr-orm/references/messenger.md

@@ -16,7 +16,7 @@ configuration, so an untouched connection is left alone.
 ## Order
 
 ```python
-# <app>/config/messenger.py
+# <app>/config/packages/messenger.py
 MessageBusConfig(
     middleware=[
         "orm_close_connection",

{xtr_orm-5.0.0 → xtr_orm-5.1.0}/src/xtr_orm/recipe/manifest.toml

@@ -9,7 +9,7 @@
 # Destination under the application package = template under this recipe.
 # The default connection on DATABASE_URL, written out so the application has
 # one place to add replicas, connections and its models' metadata.
-"config/orm.py" = "files/config/orm.py.tmpl"
+"config/packages/orm.py" = "files/config/orm.py.tmpl"
 
 [env]
 # Read when a connection is first used — engine, session, migrator or command —