v1.0.2

Fixed

• Properly support pydantic 2.7 (#462 by @adriencaccia)

Internals

• chore(bench): update CodSpeed/action to v2 (#461 by @adriencaccia)

• fix: tweak dev container environment (#438 by @Kludex and @art049)

v1.0.1

Fixed

• Optional and Union generic types definition issues (#416 by @netomi)

• Remove continuously changing example for DateTime objects (#406 by @Mokto)

Added

• Support the examples property in Field descriptors (#404 by @Mokto)

Internals

• Fix Pydantic docs URLs (#366 by @aminalaee)

• Add a test with a model when defining multiple optional fields (#426 by @art049)

• Bump ruff and use ruff format (#425 by @art049)

v1.0.0

I'm excited to announce ODMantic v1.0.0, with Pydantic v2 support! 🎉

This release brings a range of changes that are aligned with the new Pydantic architecture.
Keeping a maintainable and healthy codebase was especially important.
Thus from now on, ODMantic will not support Python 3.7, Pydantic V1, and Motor 2.x anymore.

Overall, integrating with Pydantic v2 brings around 30% performance improvements on
common operations. ⚡️⚡️⚡️

We have a lot of room to improve the performance further now that we only support Pydantic v2.
There is also a 300% 👀 improvement on the bulk saves crafted by @tiangolo that will be merged soon! 🚀

Special thanks to @tiangolo for his help on this release and for saving me a lot of time
figuring out a particularly annoying bug!

Check out the migration guide to
upgrade your codebase and enjoy this new release!

Breaking changes

• Support for Python 3.7, Pydantic v1 and Motor 2.x has been dropped

• Optional[T] doesn't have a None implicit default value anymore

• Model.copy doesn't support the exclude and include kwargs anymore

• odmantic.Field doesn't accept extra kwargs anymore since it's slated to be removed in Pydantic

• The Config class is no longer supported and the model_config dict should be used instead

• DocumentParsingError is no longer a subclass of ValidationError

• The __bson__ class method is no longer supported to define BSON encoders on custom types. The new method to customize BSON encoding is to use the WithBSONSerializer annotation.

• Decimals (decimal.Decimal and bson.Decimal128) are now serialized as strings in JSON documents

• Custom JSON encoders(defined with the json_encoders config option) are no longer effective on odmantic.bson types. Annotated types with pydantic.PlainSerializer should be used instead.

Removals

• AIOEngineDependency has been removed since it was deprecated in v0.2.0 in favor of a global engine object

• Defining the collection with __collection__ has been removed since it was deprecated in v0.3.0 in favor of the collection config option

Deprecations

We comply with the new Pydantic method naming, prefixing them with model_

• Model.dict has been deprecated in favor of Model.model_dump

• Model.doc has been deprecated in favor of Model.model_dump_doc

• Model.parse_doc has been deprecated in favor of Model.model_validate_doc

• Model.update has been deprecated in favor of Model.model_update

• Model.copy has been deprecated in favor of Model.model_copy

---

Details

• Integrate with Pydantic V2(#361 and #377 by @art049)

• Update CI to use GitHub Actions matrix instead of tox, upgrade minimum Pydantic to 1.10.8 as needed by the tests (#376 by @tiangolo)

• Add benchmarks on common sync operations (#362 by @art049)

v0.9.2

Fixed

• Properly handle literals among generic types (#313 by @art049)

Internals

• Pin tox to fix CI (#308 by @tiangolo)

v0.9.1

Fixed

• Bump motor version (#296 by @valeriiduz)

Internals

• Migrate to ruff (#299 by @art049)

v0.9.0

Added

• Create new generic types to support generic collection types (#240 by @erny & @art049)

  Thus, it's now possible to define models like this in python 3.9+ 🚀:

  class User(Model):
      scopes: list[str]
      friendsIds: list[ObjectId]
      skills: set[str]

• Allow using generators with in_ and not_in (#270 by @art049)

Fixed

• Fix EmbeddedModel generics definition with a custom key_name (#269 by @art049)

• Raise a TypeError when defining a Reference in a generic(List, Dict, Tuple, ...) containing EmbeddedModels (#269 by @art049)

v0.8.0

Added

• Allow Index definition (feature documentation) (#255 by @art049)

• Allow using the Config.extra attribute from pydantic (#259 by @art049)

Fixed

• Fix embedded models parsing with custom key_name (#262 by @iXB3)

• Fix engine.save using an embedded model as a primary key (#258 by @art049)

• Fix engine creation typo in the documentation (#257 by @art049)

v0.7.1

Fixed

• Fix dataclass transform constructor type hints (#249 by @art049)

Internals

• Update Mongo version in the CI build matrix (#247 by @art049)

v0.7.0

Added

• Add new SyncEngine, support async and sync code (#231 by @tiangolo)

• Sync engine documentation (#238 by @art049)

• Friendly interface for session and transaction management (documentation) (#244 by @art049)

• Implement the engine.remove method to allow instance deletion from a query (#147 & #237 by @joeriddles & @art049)

Internals

• Remove unnecessary Python 3.6 type fixes (#243 by @art049)

• Switch Mongo action to art049/mongodb-cluster-action (#245 by @art049)

• Add Realworld API integrated test (#246 by @art049)

v0.6.0

Breaking Changes

• Drop support for Python 3.6 (#230 by @tiangolo)

Added

• Upgrade types and add support for instance autocompletion with dataclass_transform (VS Code autocompletion) (#230 by @tiangolo)

• Support Python 3.10 (#235 by @art049)

Fixed

• Fix using the shared session when updating a document (#227 by @tiangolo)

• Fix EmbeddedModel deep copy mutability (#239 by @art049)

• Allow models to contain string-based datetime fields that indicate UTC (#136 by @kfox)

• Fix Reference usage with non the non default primary key (#184 by @dynalz)

• Fix key_name use on EmbeddedModels (#195 by @jvanegmond)

Internals

• Support Python 3.10 in tox (#236 by @art049)

• Fix missing f string in an exception message (#222 by @voglster)

• Finalize flit migration (#232 by @art049)