FactoryBoy/factory_boy

Features

• Automated Test Data Generation - Provides a dynamic alternative to static fixtures by generating complex test objects and records.
• Object Blueprints - Implements programmable blueprints to ensure consistent instantiation of complex Python objects and database models.
• Test Object Factories - Provides a programmable system to generate complex Python objects and database models as dynamic replacements for static test fixtures.
• Model Instantiation - Instantiates database model objects by mapping programmable factory declarations to specific data models.
• Test Object Associations - Automatically links related objects during test data generation through factory associations.
• ORM Integrations - Integrates with various Object Relational Mappers to handle persistence and instantiation logic automatically.
• Realistic Data Generators - Produces plausible random attribute values using providers to help uncover edge-case bugs during testing.
• Random Provider Integrations - Integrates external provider libraries to inject realistic randomized fake data into object attributes.
• Test Data Generators - System for producing random and realistic test data in Python using providers and stateful sequences.
• Custom Object Instantiation - Uses a set of default attributes within a factory to ensure consistent object instantiation across tests.
• Nested Factory Composition - Builds complex object graphs by triggering nested factory calls to resolve dependent related objects.
• Test Object Graph Generation - Enables the creation of complex object graphs using sub-factories and automatic circular dependency resolution.
• ORM Adapters - Uses specialized adapters to handle database session management and object mapping across different ORMs.
• Database Object Mocking - Generates persisted or in-memory database objects with complex associations for testing.
• ORM Fixture Management - Generates complex database model instances and related object hierarchies for testing ORM-based applications.
• Random Value Generators - Creates random integers, floats, decimals, and dates using fuzzy declarations to vary object attributes.
• Dynamic Fixture Frameworks - Serves as a dynamic replacement for static fixtures, generating object hierarchies with programmable attributes.
• Test Data Blueprinting - Defines reusable templates for object creation with default attributes and conditional logic for consistent test setups.
• Test Sequence Generation - Produces unique incrementing values for fields and supports resetting the counter for new cycles.
• Test Object Persistence Management - Manages database sessions and implements get-or-create behavior for data models during object generation.
• Object Generation Hooks - Runs custom logic or method calls on an object immediately after the instantiation process completes.
• Lazy Evaluation - Allows field values to be computed at runtime using functions that reference other attributes on the same object.
• Dynamic Attribute Management - Defines attribute values that are computed at runtime using lazy functions or cross-references to other fields.
• Computed Attribute Derivation - Calculates attribute values at runtime using functions or by referencing other existing attributes on the object.
• Batch Object Generation - Enables the generation of multiple object instances in a single call to create varied datasets.
• Post-Instantiation Hooks - Executes custom methods or logic on objects immediately after they have been instantiated.
• Random Number Generation - Manages random seeds to ensure that generated test data and failing tests are reproducible.
• Edge Case Test Suites - Produces realistic but random data values to uncover bugs and boundary conditions missed by static data.
• Test Instantiation Strategies - Provides strategies to determine if objects are persisted to a database, built in memory, or returned as stubs.
• Test Sequence Generators - Provides stateful counters to generate unique incrementing values for object attributes.
• Testing Tools - Listed in the “Testing Tools” section of the Awesome Python awesome list.

Star history