mjczz/blueprint_ex

An expressive, human readable code generation tool modify by laravel-shift/blueprint

v1.12 2020-08-04 05:16 UTC

Requires

• doctrine/dbal: ^2.9
• illuminate/console: ^6.0|^7.0
• illuminate/filesystem: ^6.0|^7.0
• illuminate/support: ^6.0|^7.0
• symfony/yaml: ^4.3|^5.0

Requires (Dev)

• mockery/mockery: ^1.3
• orchestra/testbench: ^4.0|^5.0
• phpunit/phpunit: ^8.0|^9.0

Suggests

• jasonmccreary/laravel-test-assertions: Required to use additional assertions in generated tests (^1.0).

MIT

• framework
• laravel

README

This package is copied from laravel-shift/blueprint, and i make a littil modify, hahaha

Requirements

Blueprint requires a Laravel application running version 6.0 or higher.

Installation

You can install Blueprint via composer using the following command:

composer require --dev mjczz/blueprint_ex

Blueprint will automatically register itself using package discovery.

Basic Usage

Blueprint comes with a set of artisan commands. The one you'll use the most is the blueprint:build command to generate the Laravel components:

php artisan blueprint:build [draft]

The draft file contains a definition of the components to generate.

Let's review the following, example draft file to generate some blog components:

models:
  Post:
    title: string:400
    content: longtext
    published_at: nullable timestamp
    author_id: id:user

controllers:
  Post:
    index:
      query: all
      render: post.index with:posts

    store:
      validate: title, content, author_id
      save: post
      send: ReviewPost to:post.author.email with:post
      dispatch: SyncMedia with:post
      fire: NewPost with:post
      flash: post.title
      redirect: post.index

From these simple 20 lines of YAML, Blueprint will generate all of the following Laravel components:

• A model class for Post complete with fillable, casts, and dates properties, as well as relationships methods.
• A migration to create the posts table.
• A factory intelligently setting columns with fake data.
• A controller class for PostController with index and store actions complete with code generated for each statement.
• Routes for the PostController actions.
• A form request of StorePostRequest validating title and content based on the Post model definition.
• A mailable class for ReviewPost complete with a post property set through the constructor.
• A job class for SyncMedia complete with a post property set through the constructor.
• An event class for NewPost complete with a post property set through the constructor.
• A Blade template of post/index.blade.php rendered by PostController@index.

Note: This example assumes features within a default Laravel application such as the User model and `app.blade.php layout. Otherwise, the generated test may have failures.

Documentation

Browse the Blueprint Docs for full details on defining models, defining controllers, advanced configuration, and extending Blueprint.