Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Naoray/laravel-factory-prefill
Prefills factories with faker method suggestions to increase productivity
https://github.com/Naoray/laravel-factory-prefill
factory laravel package prefill
Last synced: about 1 month ago
JSON representation
Prefills factories with faker method suggestions to increase productivity
- Host: GitHub
- URL: https://github.com/Naoray/laravel-factory-prefill
- Owner: Naoray
- License: mit
- Archived: true
- Created: 2018-11-23T15:50:49.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-01-07T09:46:57.000Z (almost 4 years ago)
- Last Synced: 2024-11-13T10:16:08.136Z (about 1 month ago)
- Topics: factory, laravel, package, prefill
- Language: PHP
- Size: 207 KB
- Stars: 103
- Watchers: 4
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# laravel-factory-prefill
[](LICENSE.md)
[](https://packagist.org/packages/naoray/laravel-factory-prefill)
[](https://travis-ci.org/Naoray/laravel-factory-prefill)
**This repository has been archived! Use Shift's [Factory Generator](https://github.com/laravel-shift/factory-generator) to utilize the new class factories of Laravel 8.**
Factories are a great concept and I really love to use them for testing purposes, but it sucks to write every needed column name and associated faker methods by hand. This package aims to make the process less painful by providing a command to prefill your factories!
After creating a factory with the artisan cli you end up having something like this:
```php
define(Model::class, function (Faker $faker) {
return [
//
];
});
```
With `laravel-factory-prefill` you can just skip the previous command call and instead execute `php artisan factory:prefill Habit`.
## Install
`composer require naoray/laravel-factory-prefill --dev`
## Usage
After running `php artisan migrate` you are good to go. If you want the `factory:prefill` command to notice the model relations, you should implement the methods first!
*Tip: If you also want the realtionships to be loaded automatically, you have to define the methods in the models.*
### Fill all Factories
To generate factories for all models run
`php artisan factory:all`
#### Models in different directories
To prefill factories from models outside of the `app/` directory just add the `-P` flag and provide the path.
`php artisan factory:all --path=Some/Other/Path`
you can also append the `--realpath` option to indicate that the given path is a pre-resolved absolut path.
### Fill single Factory
To fill a single factory you can either run `php artisan factory:prefill model_name` or `php artisan factory:all model_name`.
#### Models with different namespace
To prefill factories from models outside of the `App/` namespace just add the `-O` flag and provide the full path in the model name.
`php artisan factory:prefill "Some\Other\Namespace\ModelName" -O`
### Nullable columns
By default `nullable` columns are ignored. If you want to also add `nullable` columns to your factory includ the flag `-N` or `--allow-nullable`.
`php artisan factory:prefill ModelName -N`
or
`php artisan factory:all -N`
## Testing
Run the tests with:
``` bash
vendor/bin/phpunit
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
## Security
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
## License
The MIT License (MIT). Please see [License File](/LICENSE.md) for more information.