Blacksmith

Blacksmith is a code generation tool which automates the creation of common files that you'd typically create for each entity in your application.

Blacksmith works nicely with the Laravel PHP framework but does not actually depend on Laravel or extend an Artisan task, it is stand alone. This allows you to use it for code generation from a template anywhere on your filesystem. In fact, while some of the generator specific template variables and post-generation tasks of the Intelligent Laravel Generators are Laravel specific; if the code you want to generate uses studly case and snake case naming, you could generate any code you wanted: Java, JavaScript etc.

Out of the box for the 1.0.0 release Blacksmith ships with a Laravel hexagonal architecture configuration and templates. Why? Because this is what I needed first.

Note: If you want to get started with the hexagonal architecture referenced above for a new app. Use Foreman with this example config (changing the 'from' paths appropriatley).

If you don't like the templates + configuration shipped with Blacksmith, don't worry you can make your own custom templates tell Blacksmith how to load them with a JSON config file. Then you just pass that config file's path as an optional argument to Blacksmith's generate command and presto, your custom templates and config are used.

Attribution: Blacksmith was inspired by, and even borrows some code from Jeffrey Way's fantastic MIT licensed Laravel-4-Generators package

README Contents

• What does it do
• Installation
  • Download the PHAR
  • Compile from source
  • Updating Blacksmith
• Usage
• Getting Started
• The Config File
• Templates
• Template Variables
  • Standard Variables
  • Generator Specific Variables
• Intelligent Laravel Generators

See optional move and permissions above.

blacksmith generate {entity} {generator} [config_file] --fields="field1:type, field2:type"

In the example above the config_file argument and --fields option are both optional. {entity} is the name of the entity in your use case that you are generating code for, and {generator} is the generator you want to run.

To declare fields, use a comma-separated list of key:value:option sets, where key is the name of the field, value is the column type, and option is a way to specify indexes or other things like unique or nullable. Here are some examples:

• --fields="first:string, last:string"
• --fields="age:integer, yob:date"
• --fields="username:string:unique, age:integer:nullable"
• --fields="name:string:default('John'), email:string:unique:nullable"
• --fields="username:string[30]:unique, age:integer:nullable"

Please make note of the last example, where we specify a character limit: string[30]. This will produce $table->string('username', 30)->unique();

An example without placeholders might look like this:

blacksmith generate User scaffold ~/blksmth/cfg.json --fields="username:string:unique, age:integer:nullable"

Note: Blacksmith works from your current working directory, so if you have a template that gets written to a releative path, that will be relative to your current directory when you run Blacksmith. For Laravel this directory should be the application root.

While Blacksmith comes packaged with templates and base configuration file, it's likely you'll want to download the templates and customize them to suit your needs. This will also require you create your own config file which you can read more about in the Config File section.

As you begin to generate you may notice some interfaces and classes referenced in templates that were not generated. This is not a mistake. Any classes you only create one time are not generated by Blacksmith and can be obtained from Blacksmith-contracts.

Here is a partial view of the template, for a full template checkout the default here:

{
    "config_type": "hexagonal",

    "model": {
        "template": "model.txt",
        "directory": "app/models",
        "filename": "{{Entity}}.php"
    },
    "controller": {
        "template": "controller.txt",
        "directory": "app/controllers",
        "filename": "{{Entities}}Controller.php"
    },
    "migration_create": {
        "template": "migration_create.txt",
        "directory": "app/database/migrations",
        "filename": "{{migration_timestamp}}_create_{{collection}}_table.php"
    },
    "view_show": {
        "template": "view_show.txt",
        "directory": "app/views/{{collection}}",
        "filename": "show.blade.php"
    },
}

    "migration_create": false,

You can also see in the partial config file example that you can use template variables provided by the generator in both the directory and filename values of the configuration.

Blacksmith templates use Mustache syntax, otherwise they are just plain text files. See below for the available variables that can be used.

The variables made available for each generator can be used in the generator template file or within the JSON config file in the directory, and filename values.

[
    [
        'label' => "{{ Form::label('name', 'Name:') }}",
        'element' => "{{ Form::text('name') }}"
    ]
]