pyfactories 2.0.0

Description:

pyfactories 2.0.0

PyFactories




🚀 Mock data generation for pydantic and dataclasses. 🚀













Documentation: https://pyfactories.tarsild.io 📚
Source Code: https://github.com/tarsil/pyfactories

Motivation
Pydantic Factories was initially created and used by a lot of people and it
is an extremely powerful package that was heavily tested by the same authors of Starlite, now,
Litestar. During their own evolution and development they felt the need to add more support to the
package that was no longer only pydantic and therefore they created the Polyfactory
and archived the Pydantic Factories.
PyFactories is a literal fork from the latest Pydantic Factories and aims to continue the same
work set by the previous creators with the difference that will be only maintaining the factories
for Pydantic and the upcoming Pydantic 2.0+.
The team behind Pydantic Factories did a fantastic job and the credit goes to them while
PyFactories continues its own fork path.
If you aim to use something more than just Pydantic, it is strongly recommended to visit
Polyfactory and migrate to it and of course, leave them a ⭐️.
In the meantime if you only want the Pydantic side of things, then you can use PyFactories in
the same fashion as its ancestor.
Installation
pip install pyfactories

Migrate from Pydantic Factories
It is actually straightforward, you simply need to replace pydantic_factories with pyfactories
in your imports and that is it.
Example
from datetime import date, datetime
from typing import List, Union

from pydantic import UUID4, BaseModel

from pyfactories import ModelFactory


class Person(BaseModel):
id: UUID4
name: str
hobbies: List[str]
age: Union[float, int]
birthday: Union[datetime, date]


class PersonFactory(ModelFactory):
__model__ = Person


result = PersonFactory.build()

And just its own ancestor, this is it. Almost no work, you are able to create mock data objects
that fits the Person Pydantic class model definition.
This is possible because of the typing information available on the pydantic model and model-fields,
which are used as a source of truth for data generation.
The factory parses the information stored in the pydantic model and generates a dictionary of kwargs
that are passed to the Person class' init method.
Features
Being initially the fork of Pydantic Factories, that also means:

✅ Supports both built-in and pydantic types
✅ Supports pydantic field constraints
✅ Supports complex field types
✅ Supports custom model fields
✅ Supports dataclasses
✅ Supports TypedDicts

Why This Library
This library was widely used before because of its powerfull features and therefore with the
upcoming Pydantic 2.0, it will be even more robust with the core done in Rust.

💯 Powerful
💯 Extensible
💯 Simple
💯 Rigorously tested

Contributing
This library is open to contributions. Please see the contribution guide!
Star the initial authors
Although the intial Pydantic Factories is no longer maintained, there is
always the Polyfactory that deserves a ⭐️.