ferrum-orm 0.1.1__tar.gz → 0.1.3__tar.gz

{ferrum_orm-0.1.1 → ferrum_orm-0.1.3}/Cargo.lock

@@ -223,7 +223,7 @@ checksum = "9f1f227452a390804cdb637b74a86990f2a7d7ba4b7d5693aac9b4dd6defd8d6"
 
 [[package]]
 name = "ferrum-core"
-version = "0.1.1"
+version = "0.1.3"
 dependencies = [
  "criterion",
  "proptest",
@@ -234,7 +234,7 @@ dependencies = [
 
 [[package]]
 name = "ferrum-migrate"
-version = "0.1.1"
+version = "0.1.3"
 dependencies = [
  "ferrum-core",
  "serde",
@@ -243,23 +243,26 @@ dependencies = [
 
 [[package]]
 name = "ferrum-pyo3"
-version = "0.1.1"
+version = "0.1.3"
 dependencies = [
  "ferrum-core",
  "ferrum-sql",
  "pyo3",
+ "rmp-serde",
  "serde_json",
  "thiserror",
 ]
 
 [[package]]
 name = "ferrum-sql"
-version = "0.1.1"
+version = "0.1.3"
 dependencies = [
  "criterion",
  "ferrum-core",
  "proptest",
+ "rmp-serde",
  "serde",
+ "serde_json",
  "thiserror",
 ]
 
@@ -380,15 +383,6 @@ dependencies = [
  "serde_core",
 ]
 
-[[package]]
-name = "indoc"
-version = "2.0.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
-dependencies = [
- "rustversion",
-]
-
 [[package]]
 name = "is-terminal"
 version = "0.4.17"
@@ -456,15 +450,6 @@ version = "2.8.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "88904434abc2901f197fe8cc55f0445e7ded921dba5911dad2e2b39b48e663c4"
 
-[[package]]
-name = "memoffset"
-version = "0.9.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
-dependencies = [
- "autocfg",
-]
-
 [[package]]
 name = "num-traits"
 version = "0.2.19"
@@ -575,37 +560,32 @@ dependencies = [
 
 [[package]]
 name = "pyo3"
-version = "0.22.6"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f402062616ab18202ae8319da13fa4279883a2b8a9d9f83f20dbade813ce1884"
+checksum = "cd274650b21d4bfc26a0a47587962c1edb425f69287324355cd040c3ea66071c"
 dependencies = [
- "cfg-if",
- "indoc",
  "libc",
- "memoffset",
  "once_cell",
  "portable-atomic",
  "pyo3-build-config",
  "pyo3-ffi",
  "pyo3-macros",
- "unindent",
 ]
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.22.6"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b14b5775b5ff446dd1056212d778012cbe8a0fbffd368029fd9e25b514479c38"
+checksum = "c5e2a7d2f0d013342f295c048ad19237add5154a55b1c5a254c0ec93d4109078"
 dependencies = [
- "once_cell",
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.22.6"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ab5bcf04a2cdcbb50c7d6105de943f543f9ed92af55818fd17b660390fc8636"
+checksum = "ca85c467da1bbc8d866eea5deff9cf29ea5f7785054a17da36e65bda9c05845b"
 dependencies = [
  "libc",
  "pyo3-build-config",
@@ -613,9 +593,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros"
-version = "0.22.6"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0fd24d897903a9e6d80b968368a34e1525aeb719d568dba8b3d4bfa5dc67d453"
+checksum = "9ac53762fd065daa3194dd09337a38bd793a188100fd1a9304c4ab312d901771"
 dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
@@ -625,13 +605,12 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros-backend"
-version = "0.22.6"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "36c011a03ba1e50152b4b394b479826cad97e7a21eb52df179cd91ac411cbfbe"
+checksum = "4ca3a1557399783172dc5bf39cfca835157732532cba56b71d2292161e53b362"
 dependencies = [
  "heck",
  "proc-macro2",
- "pyo3-build-config",
  "quote",
  "syn",
 ]
@@ -750,6 +729,25 @@ version = "0.8.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
 
+[[package]]
+name = "rmp"
+version = "0.8.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ba8be72d372b2c9b35542551678538b562e7cf86c3315773cae48dfbfe7790c"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "rmp-serde"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72f81bee8c8ef9b577d1681a70ebbc962c232461e397b22c208c43c04b67a155"
+dependencies = [
+ "rmp",
+ "serde",
+]
+
 [[package]]
 name = "rustix"
 version = "1.1.4"
@@ -858,9 +856,9 @@ dependencies = [
 
 [[package]]
 name = "target-lexicon"
-version = "0.12.16"
+version = "0.13.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
 
 [[package]]
 name = "tempfile"
@@ -923,12 +921,6 @@ version = "0.2.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ebc1c04c71510c7f702b52b7c350734c9ff1295c464a03335b00bb84fc54f853"
 
-[[package]]
-name = "unindent"
-version = "0.2.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
-
 [[package]]
 name = "wait-timeout"
 version = "0.2.1"

{ferrum_orm-0.1.1 → ferrum_orm-0.1.3}/Cargo.toml

@@ -3,7 +3,7 @@ members = ["crates/ferrum-core", "crates/ferrum-sql", "crates/ferrum-pyo3"]
 resolver = "2"
 
 [workspace.package]
-version = "0.1.1"
+version = "0.1.3"
 edition = "2021"
 authors = ["Ferrum Contributors"]
 license = "Apache-2.0"
@@ -12,11 +12,14 @@ rust-version = "1.85"
 
 [workspace.dependencies]
 # PyO3 — only ferrum-pyo3 depends on this; declared here to pin the version
-pyo3 = { version = "0.22", features = ["abi3-py311"] }
+pyo3 = { version = "0.29", features = ["abi3-py311"] }
 
 # Serialization
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
+# MessagePack wire format for the PyO3 boundary (always compiled; the Python
+# `[msgpack]` extra gates only the runtime `msgpack` package + selection).
+rmp-serde = "1"
 
 # Error handling
 thiserror = "2"

{ferrum_orm-0.1.1 → ferrum_orm-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ferrum-orm
-Version: 0.1.1
+Version: 0.1.3
 Classifier: Development Status :: 3 - Alpha
 Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
@@ -17,6 +17,8 @@ Requires-Dist: pydantic>=2.0
 Requires-Dist: ferrum-orm[pg] ; extra == 'all'
 Requires-Dist: ferrum-orm[mysql] ; extra == 'all'
 Requires-Dist: ferrum-orm[sqlite] ; extra == 'all'
+Requires-Dist: ferrum-orm[mssql] ; extra == 'all'
+Requires-Dist: ferrum-orm[msgpack] ; extra == 'all'
 Requires-Dist: ferrum-orm[cli] ; extra == 'all'
 Requires-Dist: ferrum-orm[dotenv] ; extra == 'all'
 Requires-Dist: typer>=0.12 ; extra == 'cli'
@@ -33,7 +35,10 @@ Requires-Dist: import-linter>=2 ; extra == 'dev'
 Requires-Dist: testcontainers[postgres]>=4 ; extra == 'dev'
 Requires-Dist: pip-audit>=2 ; extra == 'dev'
 Requires-Dist: python-dotenv>=1.0 ; extra == 'dotenv'
+Requires-Dist: msgpack>=1.0 ; extra == 'msgpack'
+Requires-Dist: aioodbc>=0.5 ; extra == 'mssql'
 Requires-Dist: asyncmy>=0.2 ; extra == 'mysql'
+Requires-Dist: opentelemetry-api>=1.20 ; extra == 'otel'
 Requires-Dist: asyncpg>=0.29 ; extra == 'pg'
 Requires-Dist: aiosqlite>=0.19 ; extra == 'sqlite'
 Requires-Dist: uuid6>=2024.1 ; extra == 'uuid7'
@@ -42,13 +47,16 @@ Provides-Extra: cli
 Provides-Extra: dev
 Provides-Extra: dotenv
 Provides-Extra: fastapi
+Provides-Extra: msgpack
+Provides-Extra: mssql
 Provides-Extra: mysql
+Provides-Extra: otel
 Provides-Extra: pg
 Provides-Extra: sqlite
 Provides-Extra: uuid7
 License-File: LICENSE
 Summary: Next-generation async ORM for Python with a Rust-powered core
-Keywords: orm,async,postgresql,mysql,sqlite,pydantic,rust
+Keywords: orm,async,postgresql,mysql,sqlite,mssql,pydantic,rust
 License: Apache-2.0
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
@@ -83,7 +91,7 @@ Ferrum aims to provide all four.
 - Pydantic-first models
 - Django-inspired ORM experience
 - Rust-powered query engine
-- PostgreSQL-first architecture (MySQL and SQLite via optional extras)
+- PostgreSQL-first architecture (MySQL, SQLite, and SQL Server via optional extras)
 - Type-safe query construction
 - Automatic migrations
 - High-performance result hydration
@@ -115,6 +123,10 @@ users = await (
     .limit(10)
     .all(conn)
 )
+
+async with conn.transaction() as tx:
+    user = await User.objects.create(tx, email="jane@example.com")
+    await AuditLog.objects.create(tx, user_id=user.id, action="signup")
 ```
 
 ---
@@ -195,34 +207,41 @@ This allows Ferrum to maintain a Pythonic API without sacrificing performance.
 
 ## Roadmap
 
-### v0.1
-
-- [ ] PostgreSQL support
-- [ ] Basic CRUD operations
-- [ ] Async query execution
-- [ ] Pydantic models
-- [ ] Query builder
-- [ ] Type-safe filters
-
-### v0.2
-
-- [ ] Relationships
-- [ ] Transactions
-- [ ] Query optimization
-- [ ] Bulk operations
-
-### v0.3
-
-- [ ] Migrations
-- [ ] Schema diff engine
-- [ ] CLI tools
+### v0.1 (complete)
+
+- [x] PostgreSQL support
+- [x] Basic CRUD operations
+- [x] Async query execution
+- [x] Pydantic models
+- [x] Query builder
+- [x] Type-safe filters
+- [x] Transactions and savepoints
+- [x] Bulk operations (`bulk_create`, `bulk_update`, `bulk_delete`)
+- [x] Migrations (schema diff, apply, revert, CLI)
+- [x] Relationships (ForeignKey, OneToOne, ManyToMany)
+- [x] pgvector KNN search and HNSW/IVFFLAT index DDL
+- [x] Full-text search (TSVector / `plainto_tsquery`)
+- [x] Observability hooks (Tier A/B/C)
+- [x] CLI (`makemigrations`, `migrate`, `revert`, `showmigrations`, `inspectdb`, `resetdb`)
+
+### v0.2 (in progress)
+
+- [x] Upsert API (`upsert`, `bulk_upsert` with conflict targets and `RETURNING`)
+- [x] Composite primary keys
+- [x] Array field types (`uuid[]`, `text[]`, scalar arrays)
+- [x] JSONB operators (`__contains`, `__has_key`)
+- [x] RLS / tenant session helpers (`set_config`, `tenant_session`)
+- [x] `call_function` for allowlisted stored-procedure calls
+- [x] Migration ops for extensions, RLS policies, and function DDL
+- [x] pgvector similarity score projection (`vector_search` helper)
+- [ ] Query optimization (deferred fields, prefetch tuning)
+- [ ] Advanced relationship loading
 
 ### v1.0
 
 - [ ] Production-ready stability
-- [ ] Advanced relationships
-- [ ] Performance benchmarking
-- [ ] Full documentation
+- [ ] Performance benchmarking suite
+- [ ] Full documentation site
 
 ## Project Status
 
@@ -245,6 +264,12 @@ pip install 'ferrum-orm[mysql]'
 # SQLite + migrations CLI (testing / local dev)
 pip install 'ferrum-orm[sqlite,cli]'
 
+# SQL Server (also needs a system ODBC driver, e.g. msodbcsql18)
+pip install 'ferrum-orm[mssql]'
+
+# Optional MessagePack wire format for the Python<->Rust boundary
+pip install 'ferrum-orm[msgpack]'
+
 # Everything (all drivers + CLI + dotenv)
 pip install 'ferrum-orm[all]'
 
@@ -253,7 +278,19 @@ pip install ferrum-orm
 ```
 
 Bare `ferrum-orm` installs Pydantic and the Rust core only. Choose a driver extra
-(`pg`, `mysql`, or `sqlite`) before calling `ferrum.connect()`.
+(`pg`, `mysql`, `sqlite`, or `mssql`) before calling `ferrum.connect()`.
+
+MySQL, SQLite, and SQL Server are **thin-parity** backends: they support core CRUD
+and migrations but not transactions, upsert, `bulk_update`, RLS, or pgvector
+(PostgreSQL only). SQL Server connects via `aioodbc`/`pyodbc` and requires a system
+ODBC driver such as `msodbcsql18`; DSNs use the `mssql://` or `sqlserver://` scheme.
+
+### Wire format (advanced)
+
+The Python↔Rust IR/hydration boundary defaults to JSON. Installing the `msgpack`
+extra lets you switch it to MessagePack, selected via the `FERRUM_WIRE_FORMAT`
+environment variable (`json` | `msgpack`) or the `[ferrum] wire_format` key in
+`ferrum.toml` / `pyproject.toml`. JSON remains the default; MessagePack is opt-in.
 
 From source, build the native extension with `maturin develop` (or `mise run dev`).
 
@@ -267,7 +304,8 @@ Runnable samples live under [`examples/`](examples/):
 
 ## Contributing
 
-Contributions are welcome.
+Contributions are welcome. Start with [`CONTRIBUTING.md`](CONTRIBUTING.md) for local setup,
+scoped verification, architecture rules, and pull request expectations.
 
 ## License
 

{ferrum_orm-0.1.1 → ferrum_orm-0.1.3}/README.md

@@ -24,7 +24,7 @@ Ferrum aims to provide all four.
 - Pydantic-first models
 - Django-inspired ORM experience
 - Rust-powered query engine
-- PostgreSQL-first architecture (MySQL and SQLite via optional extras)
+- PostgreSQL-first architecture (MySQL, SQLite, and SQL Server via optional extras)
 - Type-safe query construction
 - Automatic migrations
 - High-performance result hydration
@@ -56,6 +56,10 @@ users = await (
     .limit(10)
     .all(conn)
 )
+
+async with conn.transaction() as tx:
+    user = await User.objects.create(tx, email="jane@example.com")
+    await AuditLog.objects.create(tx, user_id=user.id, action="signup")
 ```
 
 ---
@@ -136,34 +140,41 @@ This allows Ferrum to maintain a Pythonic API without sacrificing performance.
 
 ## Roadmap
 
-### v0.1
-
-- [ ] PostgreSQL support
-- [ ] Basic CRUD operations
-- [ ] Async query execution
-- [ ] Pydantic models
-- [ ] Query builder
-- [ ] Type-safe filters
-
-### v0.2
-
-- [ ] Relationships
-- [ ] Transactions
-- [ ] Query optimization
-- [ ] Bulk operations
-
-### v0.3
-
-- [ ] Migrations
-- [ ] Schema diff engine
-- [ ] CLI tools
+### v0.1 (complete)
+
+- [x] PostgreSQL support
+- [x] Basic CRUD operations
+- [x] Async query execution
+- [x] Pydantic models
+- [x] Query builder
+- [x] Type-safe filters
+- [x] Transactions and savepoints
+- [x] Bulk operations (`bulk_create`, `bulk_update`, `bulk_delete`)
+- [x] Migrations (schema diff, apply, revert, CLI)
+- [x] Relationships (ForeignKey, OneToOne, ManyToMany)
+- [x] pgvector KNN search and HNSW/IVFFLAT index DDL
+- [x] Full-text search (TSVector / `plainto_tsquery`)
+- [x] Observability hooks (Tier A/B/C)
+- [x] CLI (`makemigrations`, `migrate`, `revert`, `showmigrations`, `inspectdb`, `resetdb`)
+
+### v0.2 (in progress)
+
+- [x] Upsert API (`upsert`, `bulk_upsert` with conflict targets and `RETURNING`)
+- [x] Composite primary keys
+- [x] Array field types (`uuid[]`, `text[]`, scalar arrays)
+- [x] JSONB operators (`__contains`, `__has_key`)
+- [x] RLS / tenant session helpers (`set_config`, `tenant_session`)
+- [x] `call_function` for allowlisted stored-procedure calls
+- [x] Migration ops for extensions, RLS policies, and function DDL
+- [x] pgvector similarity score projection (`vector_search` helper)
+- [ ] Query optimization (deferred fields, prefetch tuning)
+- [ ] Advanced relationship loading
 
 ### v1.0
 
 - [ ] Production-ready stability
-- [ ] Advanced relationships
-- [ ] Performance benchmarking
-- [ ] Full documentation
+- [ ] Performance benchmarking suite
+- [ ] Full documentation site
 
 ## Project Status
 
@@ -186,6 +197,12 @@ pip install 'ferrum-orm[mysql]'
 # SQLite + migrations CLI (testing / local dev)
 pip install 'ferrum-orm[sqlite,cli]'
 
+# SQL Server (also needs a system ODBC driver, e.g. msodbcsql18)
+pip install 'ferrum-orm[mssql]'
+
+# Optional MessagePack wire format for the Python<->Rust boundary
+pip install 'ferrum-orm[msgpack]'
+
 # Everything (all drivers + CLI + dotenv)
 pip install 'ferrum-orm[all]'
 
@@ -194,7 +211,19 @@ pip install ferrum-orm
 ```
 
 Bare `ferrum-orm` installs Pydantic and the Rust core only. Choose a driver extra
-(`pg`, `mysql`, or `sqlite`) before calling `ferrum.connect()`.
+(`pg`, `mysql`, `sqlite`, or `mssql`) before calling `ferrum.connect()`.
+
+MySQL, SQLite, and SQL Server are **thin-parity** backends: they support core CRUD
+and migrations but not transactions, upsert, `bulk_update`, RLS, or pgvector
+(PostgreSQL only). SQL Server connects via `aioodbc`/`pyodbc` and requires a system
+ODBC driver such as `msodbcsql18`; DSNs use the `mssql://` or `sqlserver://` scheme.
+
+### Wire format (advanced)
+
+The Python↔Rust IR/hydration boundary defaults to JSON. Installing the `msgpack`
+extra lets you switch it to MessagePack, selected via the `FERRUM_WIRE_FORMAT`
+environment variable (`json` | `msgpack`) or the `[ferrum] wire_format` key in
+`ferrum.toml` / `pyproject.toml`. JSON remains the default; MessagePack is opt-in.
 
 From source, build the native extension with `maturin develop` (or `mise run dev`).
 
@@ -208,7 +237,8 @@ Runnable samples live under [`examples/`](examples/):
 
 ## Contributing
 
-Contributions are welcome.
+Contributions are welcome. Start with [`CONTRIBUTING.md`](CONTRIBUTING.md) for local setup,
+scoped verification, architecture rules, and pull request expectations.
 
 ## License
 

{ferrum_orm-0.1.1 → ferrum_orm-0.1.3}/crates/ferrum-core/Cargo.toml

@@ -1,5 +1,6 @@
 [package]
 name = "ferrum-core"
+publish = false
 version.workspace = true
 edition.workspace = true
 authors.workspace = true

{ferrum_orm-0.1.1 → ferrum_orm-0.1.3}/crates/ferrum-core/benches/hydrate.rs

@@ -47,6 +47,7 @@ fn bench_metadata() -> ModelMetadata {
             },
         ],
         pk_index: 0,
+        pk_fields: vec![0],
     }
 }