Skip to content

Latest commit

 

History

History
93 lines (71 loc) · 3.66 KB

README.md

File metadata and controls

93 lines (71 loc) · 3.66 KB
Raw

Alice - Expressive fixtures generator Build Status

Relying on fzaninotto/Faker, Alice allows you to create a ton of fixtures/fake data for use while developing or testing your project. It gives you a few essential tools to make it very easy to generate complex data with constraints in a readable and easy to edit way, so that everyone on your team can tweak the fixtures if needed.

Table of Contents

  1. Installation
  2. Example
  3. Getting Started
  4. Basic Usage
  5. Detailed Usage
  6. Complete Reference
  7. Creating Fixtures
  8. Fixture Ranges
  9. Calling Methods
  10. Specifying Constructor Arguments
  11. Custom Setter
  12. Optional Data
  13. Handling Unique Constraints
  14. Handling Relations
  15. References
  16. Multiple References
  17. Self reference
  18. Passing references to providers
  19. Keep Your Fixtures Dry
  20. Fixture Inheritance
  21. Including files
  22. Variables
  23. Parameters
  24. Customize Data Generation
  25. Faker Data
  26. Reuse generated data using objects value
  27. Custom Faker Data Providers
  28. Event handling with Processors

Installation

This is installable via Composer as nelmio/alice:

composer require nelmio/alice

Example

Here is a complete example of entity declaration:

Nelmio\Entity\User:
    user{1..10}:
        username: <username()>
        fullname: <firstName()> <lastName()>
        birthDate: <date()>
        email: <email()>
        favoriteNumber: 50%? <numberBetween(1, 200)>

Nelmio\Entity\Group:
    group1:
        name: Admins
        owner: @user1
        members: <numberBetween(1, 10)>x @user*
        created: <dateTimeBetween('-200 days', 'now')>
        updated: <dateTimeBetween($created, 'now')>

You can then load them easily with:

$objects = \Nelmio\Alice\Fixtures::load(__DIR__.'/fixtures.yml', $objectManager);

For more information, refer to the documentation.

Third-party libraries

License

Released under the MIT License.