ferro-orm 0.3.2__tar.gz → 0.3.4__tar.gz

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/.github/workflows/ci.yml

@@ -171,6 +171,60 @@ jobs:
           name: python-${{ matrix.python-version }}
         continue-on-error: true
 
+  test-python-backend-matrix:
+    name: Python backend matrix (SQLite + Postgres)
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_USER: ferro
+          POSTGRES_PASSWORD: ferro
+          POSTGRES_DB: ferro
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U ferro -d ferro"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      FERRO_SUPABASE_URL: postgresql://ferro:ferro@127.0.0.1:5432/ferro?sslmode=disable
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust build
+        uses: Swatinem/rust-cache@v2
+        with:
+          prefix-key: v1
+          cache-on-failure: true
+
+      - name: Install dependencies
+        run: |
+          uv sync --only-group ci-test --no-install-project --python 3.13
+
+      - name: Build Rust extension
+        run: |
+          uv run maturin develop
+
+      - name: Run backend matrix tests
+        run: |
+          uv run pytest -v -m "backend_matrix or postgres_only" --db-backends=sqlite,postgres
+
   check-conventional-commits:
     name: Check Conventional Commits
     runs-on: ubuntu-latest
@@ -220,7 +274,7 @@ jobs:
 
   all-checks:
     name: All Checks Passed
-    needs: [lint-and-format, test-python-pr, test-python-main, test-rust]
+    needs: [lint-and-format, test-python-pr, test-python-main, test-python-backend-matrix, test-rust]
     runs-on: ubuntu-latest
     if: always()
     steps:
@@ -232,6 +286,7 @@ jobs:
           if ! ok "${{ needs.lint-and-format.result }}"; then exit 1; fi
           if ! ok "${{ needs.test-python-pr.result }}"; then exit 1; fi
           if ! ok "${{ needs.test-python-main.result }}"; then exit 1; fi
+          if ! ok "${{ needs.test-python-backend-matrix.result }}"; then exit 1; fi
           if ! ok "${{ needs.test-rust.result }}"; then exit 1; fi
 
           echo "All checks passed!"

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/.gitignore

@@ -1,3 +1,6 @@
+# Local git worktrees (see: git worktree add)
+.worktrees/
+
 # Generated by Cargo
 # will have compiled files and executables
 debug

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/CHANGELOG.md

@@ -1,6 +1,91 @@
 # CHANGELOG
 
 
+## v0.3.4 (2026-04-25)
+
+### Bug Fixes
+
+- Serialize UUID M2M query contexts
+  ([`f53b3ca`](https://github.com/syn54x/ferro-orm/commit/f53b3ca4219d3cd21174d1cb2215bda717c0ac3d))
+
+### Chores
+
+- Gitignore .worktrees/ for local worktrees
+  ([`142cd3f`](https://github.com/syn54x/ferro-orm/commit/142cd3fc1240e2e0ce5597b170455e4355ac98b9))
+
+- Update lock file
+  ([`fa1c003`](https://github.com/syn54x/ferro-orm/commit/fa1c003efd3960c4c7a647ddf0f8ba166c731e01))
+
+### Documentation
+
+- Add backend guide
+  ([`78f1e29`](https://github.com/syn54x/ferro-orm/commit/78f1e295052663416e37ce2bef81be06ec602ba0))
+
+### Refactoring
+
+- Replace Any backend with typed engine
+  ([`71628a7`](https://github.com/syn54x/ferro-orm/commit/71628a7281e7f6d8ec6a4640eb2512a7589a634d))
+
+### Testing
+
+- Add local Postgres test provider
+  ([`f8601a5`](https://github.com/syn54x/ferro-orm/commit/f8601a54b414baefd5f1078470c60b3ee85782db))
+
+- Harden bridge-boundary coverage
+  ([`f1a6064`](https://github.com/syn54x/ferro-orm/commit/f1a60647a799a17ad8adf75c86e9635dd192cc55))
+
+
+## v0.3.3 (2026-04-24)
+
+### Bug Fixes
+
+- Cast NULL and strings to ::uuid for Postgres using catalog
+  ([`f5cb4f0`](https://github.com/syn54x/ferro-orm/commit/f5cb4f08ceaf0763a29c3b78d4d077ca1119fc1c))
+
+- Catalog casts for date/timestamp columns on Postgres
+  ([`95ef5ca`](https://github.com/syn54x/ferro-orm/commit/95ef5cadc28eb26481c38b51dbca1b370a883d10))
+
+- Clean up rebase conflicts with main
+  ([`716511c`](https://github.com/syn54x/ferro-orm/commit/716511c829021ee6d2390bb85c877e670c1d7631))
+
+- Enum OIDs
+  ([`a9867be`](https://github.com/syn54x/ferro-orm/commit/a9867beac242a9d630aeb7e49b718a4234c541ec))
+
+- Postgres native enums on save and StrEnum schema registration
+  ([`44277e1`](https://github.com/syn54x/ferro-orm/commit/44277e1922182b020c17d9a7a2a9e99dd62061e5))
+
+- Use Postgres SQL dialect when connecting to postgres URLs
+  ([`c627ac8`](https://github.com/syn54x/ferro-orm/commit/c627ac8e4fa84555e0cc7250f73ce6f0858125a3))
+
+- **postgres**: Add dual-db ORM test matrix
+  ([`1fa657f`](https://github.com/syn54x/ferro-orm/commit/1fa657fe4335d41214fcb24b1eac5dcf3138273f))
+
+- **postgres**: Bind boolean writes as booleans
+  ([`346441a`](https://github.com/syn54x/ferro-orm/commit/346441a073a540c857a8aaa67bf4029cb4099535))
+
+- **postgres**: Cast uuid columns to text in SELECT for Any decode
+  ([`df957c0`](https://github.com/syn54x/ferro-orm/commit/df957c0202d32608843d6a24ae4c924ed5b9381d))
+
+- **postgres**: Cast UUID filter params for sqlx Any compatibility
+  ([`889cf8b`](https://github.com/syn54x/ferro-orm/commit/889cf8b61131c2d53e8414a76ca7b2dbc7868c23))
+
+- **postgres**: Decode native enum columns via text cast
+  ([`1270f9d`](https://github.com/syn54x/ferro-orm/commit/1270f9dcd1cc5aa19cf484c3d9c3bb3a82255a05))
+
+### Refactoring
+
+- Expand db matrix coverage and harden postgres paths
+  ([`b82f3ac`](https://github.com/syn54x/ferro-orm/commit/b82f3ac886459861cdfde122b99b880b85c09a61))
+
+- Multi db architecture with true sqlite and postgres support
+  ([`459a0c5`](https://github.com/syn54x/ferro-orm/commit/459a0c5f9c8a95ecacc9ba552137252d34de4824))
+
+### Testing
+
+- Expand schema constraints into db matrix
+  ([`24a7f0a`](https://github.com/syn54x/ferro-orm/commit/24a7f0ad38b90e98a41cf32fe2777d988ff7047f))
+
+
 ## v0.3.2 (2026-04-24)
 
 ### Bug Fixes

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/Cargo.lock

@@ -79,9 +79,9 @@ checksum = "1e748733b7cbc798e1434b6ac524f0c1ff2ab456fe201501e6497c8417a4fc33"
 
 [[package]]
 name = "cc"
-version = "1.2.60"
+version = "1.2.61"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43c5703da9466b66a946814e1adf53ea2c90f10063b86290cc9eb67ce3478a20"
+checksum = "d16d90359e986641506914ba71350897565610e87ce0ad9e6f28569db3dd5c6d"
 dependencies = [
  "find-msvc-tools",
  "shlex",
@@ -128,9 +128,9 @@ dependencies = [
 
 [[package]]
 name = "crc-catalog"
-version = "2.4.0"
+version = "2.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "19d374276b40fb8bbdee95aef7c7fa6b5316ec764510eb64b8dd0e2ed0d7e7f5"
+checksum = "217698eaf96b4a3f0bc4f3662aaa55bdf913cd54d7204591faa790070c6d0853"
 
 [[package]]
 name = "crossbeam-queue"
@@ -294,7 +294,7 @@ dependencies = [
 
 [[package]]
 name = "ferro"
-version = "0.3.2"
+version = "0.3.4"
 dependencies = [
  "dashmap",
  "once_cell",
@@ -1191,9 +1191,9 @@ dependencies = [
 
 [[package]]
 name = "rustls-pki-types"
-version = "1.14.0"
+version = "1.14.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be040f8b0a225e40375822a563fa9524378b9d63112f53e19ffff34df5d33fdd"
+checksum = "30a7197ae7eb376e574fe940d068c30fe0462554a3ddbe4eca7838e049c937a9"
 dependencies = [
  "zeroize",
 ]

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ferro"
-version = "0.3.2"
+version = "0.3.4"
 edition = "2024"
 readme = "README.md"
 

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ferro-orm
-Version: 0.3.2
+Version: 0.3.4
 Requires-Dist: pydantic>=2.0
 Requires-Dist: alembic>=1.18.1 ; extra == 'alembic'
 Requires-Dist: sqlalchemy>=2.0.46 ; extra == 'alembic'
@@ -54,6 +54,8 @@ pip install ferro-orm
 pip install "ferro-orm[alembic]"
 ```
 
+Ferro currently supports SQLite and PostgreSQL as runtime backends. Named multi-database routing and custom connection-pool kwargs are planned, but not part of the current public API.
+
 ## Quick Start
 
 ```python

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/README.md

@@ -41,6 +41,8 @@ pip install ferro-orm
 pip install "ferro-orm[alembic]"
 ```
 
+Ferro currently supports SQLite and PostgreSQL as runtime backends. Named multi-database routing and custom connection-pool kwargs are planned, but not part of the current public API.
+
 ## Quick Start
 
 ```python

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/docs/api/utilities.md

@@ -17,24 +17,19 @@ await connect("sqlite:example.db?mode=rwc")
 # PostgreSQL
 await connect("postgresql://user:password@localhost/dbname")
 
-# With options
-await connect(
-    "postgresql://localhost/dbname",
-    max_connections=20,
-    auto_migrate=True  # Development only
-)
+# Auto-migrate during development
+await connect("postgresql://localhost/dbname", auto_migrate=True)
 ```
 
 See [Database Setup Guide](../guide/database.md) for complete connection options.
 
 ### disconnect()
 
-Close the database connection.
+This function is not implemented yet.
 
 ```python
-from ferro import disconnect
-
-await disconnect()
+# Current pattern: connect once during startup
+await connect("sqlite:example.db?mode=rwc")
 ```
 
 ### create_tables()

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/docs/concepts/performance.md

@@ -137,14 +137,11 @@ for post in posts:
 posts = await Post.select().prefetch_related("author").all()
 ```
 
-### 6. Use Connection Pooling
+### 6. Reuse a Long-Lived Connection
 
 ```python
-await ferro.connect(
-    "postgresql://localhost/db",
-    max_connections=50,  # Tune for your load
-    min_connections=10
-)
+# Current API: connect once during startup and reuse it.
+await ferro.connect("postgresql://localhost/db")
 ```
 
 ### 7. Keep Transactions Short

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/docs/faq.md

@@ -137,7 +137,7 @@ Check your Ferro version's API for raw SQL support. Most versions provide an esc
 
 ### Does Ferro support multiple databases?
 
-Multi-database support varies by version. Check your version's documentation for `using()` or similar APIs.
+Not yet. Ferro currently supports a single active database connection per application process.
 
 See [How-To: Multiple Databases](howto/multiple-databases.md).
 
@@ -198,14 +198,11 @@ Check the error message for details.
 ### How do I reset the database?
 
 ```python
-# Drop all tables
-await ferro.drop_all_tables()
-
-# Recreate
-await ferro.create_tables()
+# Reconnect to a fresh SQLite test database
+await ferro.connect("sqlite::memory:", auto_migrate=True)
 ```
 
-Or use Alembic migrations:
+For persistent environments, use Alembic migrations:
 
 ```bash
 alembic downgrade base

{ferro_orm-0.3.2 → ferro_orm-0.3.4}/docs/getting-started/installation.md

@@ -4,7 +4,7 @@
 
 - Python 3.10 or higher
 - Supported platforms: macOS, Linux, Windows
-- Database: SQLite, PostgreSQL, or MySQL
+- Database: SQLite or PostgreSQL
 
 ## Install Ferro
 
@@ -30,7 +30,7 @@ This installs Alembic and SQLAlchemy (used only for migration generation, not at
 
 ## Database Drivers
 
-Ferro uses SQLx under the hood, which includes drivers for all supported databases. No additional database-specific packages are required.
+Ferro uses SQLx under the hood. SQLite and PostgreSQL support are built into Ferro's published packages, so no additional database-specific packages are required for those backends.
 
 ### SQLite
 
@@ -40,10 +40,6 @@ No additional setup needed. SQLite is embedded in Ferro.
 
 No additional setup needed. PostgreSQL support is built into Ferro.
 
-### MySQL
-
-No additional setup needed. MySQL/MariaDB support is built into Ferro.
-
 
 ## Optional Dependencies
 
@@ -52,10 +48,10 @@ No additional setup needed. MySQL/MariaDB support is built into Ferro.
 For running tests and linting:
 
 ```bash
-pip install "ferro-orm[dev]"
+uv sync --group dev
 ```
 
-This includes pytest, ruff, mypy, and other development tools.
+This workspace group includes pytest, maturin, docs tooling, and other development dependencies used in this repository.
 
 ## Building from Source