cherrypulp/laravel-package-generator

A laravel package generator

2.1.0 2019-10-04 00:34 UTC

Requires

• php: >=7.0
• illuminate/console: >=5.5.0
• illuminate/container: >=5.5.0
• illuminate/filesystem: >=5.5.0
• illuminate/support: >=5.5.0
• illuminate/view: >=5.5.0

MIT

• Daniel Sum
• Alexander Melihov

• generator
• package
• laravel

README

Simple package to quickly generate basic structure for other laravel packages forked from Alexander Melihov Laravel Package generator.

Install

Install via composer

composer require --dev cherrypulp/laravel-package-generator

Add service provider to config/app.php in providers section (it is optional step if you use laravel>=5.5 with package auto discovery feature)

Cherrypulp\LaravelPackageGenerator\ServiceProvider::class,

Publish package config if you want customize default values

php artisan vendor:publish --provider="Cherrypulp\LaravelPackageGenerator\ServiceProvider" --tag="config"

Available commands

php artisan package:new vendor package

Create new package.

Example: php artisan package:new Cherrypulp SomeAwesomePackage

This command will:

• Create workbench/cherrypulp/some-awesome-package folder
• Register package in app composer.json
• Copy package skeleton from skeleton folder to created folder (you can provide your custom skeleton path in config)
• Run git init packages/cherrypulp/some-awesome-package
• Run composer update cherrypulp/some-awesome-package
• Run composer dump-autoload

I recommend to run this command with interactive -i flag:

php artisan package:new Cherrypulp SomeAwesomePackage -i

This way you will be prompted for every needed value.

php artisan package:remove

Remove the existing package.

Example: php artisan package:remove Cherrypulp SomeAwesomePackage

This command will:

• Run composer remove cherrypulp/some-awesome-package
• Remove packages/cherrypulp/some-awesome-package folder
• Unregister package in app composer.json
• Run composer dump-autoload

Interactive mode also possible.

php artisan package:clone

Clone the existing package.

Example: php artisan package:clone https://github.com/cherrypulp/laravel-env-validator Cherrypulp LaravelEnvValidator --src=src/LaravelEnvValidator

This command will:

• Clone specified repo in workbench/cherrypulp/laravel-env-validator folder
• Register package in app composer.json
• Run composer update cherrypulp/laravel-env-validator
• Run composer dump-autoload

Interactive mode also possible. If you need you can specify which branch to clone with -b flag.

Custom skeleton

This package will copy all folders and files from specified skeleton path to package folder. You can use templates in your skeleton. All files with tpl extension will be provided with some variables available to use in them. tpl extension will be stripped.

Available variables to use in templates:

• vendor (e.g. Cherrypulp)
• package (e.g. SomeAwesomePackage)
• vendorFolderName (e.g. cherrypulp)
• packageFolderName (e.g. some-awesome-package)
• packageHumanName (e.g. Some awesome package)
• composerName (e.g. cherrypulp/some-awesome-package)
• composerDesc (e.g. A some awesome package)
• composerKeywords (e.g. some,awesome,package)
• licence (e.g. MIT)
• phpVersion (e.g. >=7.0)
• aliasName (e.g. some-awesome-package)
• configFileName (e.g. some-awesome-package)
• year (e.g. 2017)
• name (e.g. Alexander Melihov)
• email (e.g. [e-mail])
• githubPackageUrl (e.g. https://github.com/cherrypulp/some-awesome-package)

Things you need to to manually:

• Service provider and alias registration (if you use laravel <5.5)
• In README.md:
  • StyleCI repository identifier
  • Sensio Insight repository identifier
  • Package description
  • Usage section

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Alexander Melihov
• Daniel Sum
• All contributors