Skip to content
This repository has been archived by the owner on Aug 11, 2022. It is now read-only.

Get a 📦 skeleton and all other `make` commands from laravel base for package development.

License

Notifications You must be signed in to change notification settings

Naoray/laravel-package-maker

Repository files navigation

laravel-package-maker

Software License Total Downloads

All the make commands you use in your daily Laravel app development workflow but for packages! This package was created solely for the purpose to make package development as fast and easy as possible. Creating a new package only takes one command (make:package) and you will end up with the following file structure:

.
└── package
    ├── .codecov.yml
    ├── composer.json
    ├── CONTRIBUTING.md
    ├── .gitignore
    ├── LICENSE.md
    ├── phpunit.xml
    ├── readme.md
    ├── src
    │   └── PackageServiceProvider.php
    ├── .styleci.yml
    ├── tests
    │   └── TestCase.php
    └── .travis.yml

Install

composer require naoray/laravel-package-maker --dev

Usage

php artisan make:package

make:package

php artisan make:nova

Inspired by Spatie's nova-skeleton-tool this command clones the repository, replaces all strings with your own and adds it to your own project.

make:nova

php artisan package:add

If you have already created a package or you want to add a modified version of a package which is currently only available locally, you can use the following command to add you package to your project. It does simply add your package to your project`s composer repositories and requires a local version of it.

This command is run by make:package automatically, so you have no need to execute it after creating a package!

php artisan package:save
				{namespace : Root namespace of the package (Vendor\Package_name)}
				{path : Relative path to the package's directory}

Every package:* command needs to know the package's namespace and the relative path to the location your package is stored. Because of that every package:* command comes with those two options by default. To avoid entering those two options every time a package:* command executed this command saves the credentials of your package in the cache.

php artisan package:delete

This one wipes all stored credentials from your cache.

php artisan package:clone
                {src : Source path of the package to clone}
                {target : Path where it should be cloned in}

The clone command clones a given repository or directory into the given target.

php artisan package:replace 
                {path : The path to a file or directory}
                {--O|old=* : Old strings which will be replaced}
                {--N|new=* : New strings which will be used as replacement}'

The replace command takes a path of a file or a directory and an indefinite number of 'old' options which will be replaced by the 'new' options.

All of these commands do have all arguments & options to which you are used to in a normal laravel app! To execute any of these commands simply add the prefix package:.

  • channel
  • console
  • event
  • exception
  • job
  • listener
  • mail
  • model
  • notification
  • observer
  • policy
  • provider
  • request
  • resource
  • rule
  • test
  • factory
  • migration
  • seeder
  • controller
  • middleware

All of the following routes only accept a name argument.

  • contract
  • interface (same as contract)
  • trait
  • package:basetest {provider : The package's provider name} - creates TestCase in tests folder
  • package:codecov - creates a .codecov.yml file
  • package:composer {--author : The author of the package.} {--email : The author's email.} - creates composer.json
  • package:contribution - creates CONTRIBUTING.md
  • package:gitignore - creates .gitignore file
  • package:license {--copyright : The company or vendor name to place it int the license file} - creates LICENSE.md file
  • package:phpunit - creates phpunit.xml
  • package:readme {--author : The author of the package.} {--email : The author's email.} - creates readme.md
  • package:styleci - creates .styleci.yml
  • package:travis - creates .travis.yml

Use a few make commands package:*

All arguments & options you know from the standard make commands are available. Create a model with all option. package:model --all

Testing

Run the tests with:

vendor/bin/phpunit

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Credits

Security

If you discover any security-related issues, please email krishan.koenig@googlemail.com instead of using the issue tracker.

License

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

About

Get a 📦 skeleton and all other `make` commands from laravel base for package development.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages