async-factory-boy

What it is and what it does

async_factory_boy is a factory_boy extension that wraps asynchronous ORM operations, letting you define test fixtures for SQLAlchemy and Tortoise ORM using async/await syntax. Instead of blocking database calls in your test factories, you call `await TestModelFactory.create()` or `await TestModelFactory.build()` to generate test data asynchronously.

The package works by subclassing factory_boy's Factory and providing ORM-specific variants (AsyncSQLAlchemyFactory, AsyncTortoiseFactory) that handle async session management. It integrates with factory_boy's Faker support for generating realistic field values. The single runtime dependency is factory-boy itself, making installation straightforward.

Use it for:

• Generate test data in async test suites without blocking the event loop or wrapping factories in sync wrappers.
• Build SQLAlchemy async session fixtures for pytest-asyncio or similar async test frameworks.
• Create Tortoise ORM test models in async test code without falling back to synchronous factory patterns.
• Populate test databases in async integration tests where the application code is fully async.
• Reduce boilerplate in async test setup by reusing factory definitions across multiple test modules.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Extends factory_boy to generate test fixtures asynchronously for SQLAlchemy and Tortoise ORM, allowing async database operations in test factories.

Yes, if you are writing async tests for SQLAlchemy or Tortoise ORM and want to avoid sync-to-async bridging in your factories. The low install friction and permissive license are favorable. However, dormant maintenance (last release August 2023, last commit June 2024) means you should verify compatibility with your ORM versions and be prepared to fork or patch if issues arise. No known vulnerabilities.

Install

async-factory-boy on PyPI

pip install async-factory-boy

uv add async-factory-boy

poetry add async-factory-boy

Installing async-factory-boy

Before you install

Low install friction with a single dependency on factory-boy. Maintenance is dormant—last commit was 2024-06-12 and no releases since 2023-08-12—so expect no active bug fixes or feature updates, though the codebase is not archived.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal legal friction.

Quickstart

pip install async_factory_boy

from async_factory_boy.factory.sqlalchemy import AsyncSQLAlchemyFactory

class TestModelFactory(AsyncSQLAlchemyFactory):
    class Meta:
        model = TestModel
        session = session
    name = Faker("name")

test = await TestModelFactory.create()

Requires Python 3.8 or later; async/await syntax is mandatory for usage.

Verify before relying

• Whether the package works with current versions of SQLAlchemy's async API (sqlalchemy.ext.asyncio) or only legacy async patterns.
• Whether Tortoise ORM support is actively maintained or if breaking changes in Tortoise have introduced compatibility issues.
• Real-world test coverage and whether dormancy signals unresolved issues or simply stable, complete functionality.

Package facts

Evidence: async_factory_boy-1.0.1-py2.py3-none-any.whl

Keywords: factory_boy, factory, fixtures, async, SQLAlchemy, Tortoise, async_factory_boy

Tags

More Python Modules packages