Download the PHP package morrislaptop/popo-factory without Composer

Making it easy to mock your POPO's / Value Objects

This package supports mocking POPOs or Value Objects, it inspects your class properties and populates them with random data generated by Faker. You can create class-based mock factories to have a fluent interface to mock POPOs for different states.

This is a fork of Data Transfer Object Factory.

Installation

You can install the package via composer:

Usage

Which creates an object that looks like this:

The new method returns an instance of Morrislaptop\PopoFactory\PopoFactory which provides the following methods.

• count() - Allows you to specify how many POPOs to be generated. They will be returned in an array.
• make() - Called when you are ready to generate the POPO(s). Returns the generated object(s).
• random() - Generates a random number of POPOs
• sequence() - Alternates a specific state. (See below)
• state() - Manually sets properties based on the array of values passed.

Examples of these methods can be found below.

Creating Class Based Factories

It's useful to define specific factories for particular objects, which can easily be done by extending the PopoFactory class.

My specifying a typehint for the make() method you will also get typehints in your IDE for your mocked object.

Then using it in tests like so:

Extending

You can easily extend the factory to support other data types. You can do this through the static registerProvider() method on the PropertyFactory class. This method takes two arguments. The first should be the FQDN of the class you are providing (e.g. Carbon\Carbon) OR the built-in type (e.g. string). The second should be a callback that returns the generated value. This callback is passed two properties when called to assist in generating the value. The first is an instance of Anteris\FakerMap\FakerMap which can be used to help generate fake data. The second is an instance of ReflectionProperty which contains information about the property being generated.

For example, to support Carbon:

Plug

Want an easy way to persist your POPOs in Laravel? Check out laravel-popo-caster

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Craig Morris
• All Contributors

License

The MIT License (MIT). Please see License File for more information.