nafiesl/SimpleCrudGenerator nafiesl/SimpleCrudGenerator

  • Stars
    star
    169
  • Rank 224,453 (Top 5 %)
  • Language
    PHP
  • License
    MIT License
  • Created over 7 years ago
  • Updated 8 months ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
nafiesl/SimpleCrudGenerator
github

nafiesl

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Faster test-driven development for CRUD feature in Laravel project.

Laravel Simple CRUD Generator

Build Status Total Downloads

Need faster TDD in Laravel project? This is a simple CRUD generator complete with automated testing suite.

Documentation

For installation instructions and usage, please take a look at the official documentation.

About this package

This package contains artisan make:crud commands to create a simple CRUD feature with test classes on our Laravel 5.5 (and later) application. This package is fairly simple, to boost test-driven development method on our laravel application.

With this package installed on local environment, we can use (e.g.) php artisan make:crud Vehicle command to generate some files :

  • App\Models\Vehicle.php eloquent model
  • xxx_create_vehicles_table.php migration file
  • VehicleController.php
  • index.blade.php and forms.blade.php view file in resources/views/vehicles directory
  • resources/lang/vehicle.php lang file
  • VehicleFactory.php model factory file
  • VehiclePolicy.php model policy file in app/Policies directory
  • ManageVehiclesTest.php feature test class in tests/Feature directory
  • VehicleTest.php unit test class in tests/Unit/Models directory
  • VehiclePolicyTest.php unit test class in tests/Unit/Policies directory

It will update some file :

  • Update routes/web.php to add vehicles resource route
  • Update app/providers/AuthServiceProvider.php to add Vehicle model Policy class in $policies property

It will also create this file if it not exists :

  • resources/lang/app.php lang file if it not exists
  • tests/BrowserKitTest.php base Feature TestCase class if it not exists

Main purpose

The main purpose of this package is for faster Test-driven Development, it generates model CRUD scaffolds complete with Testing Classes which will use Laravel Browserkit Testing package and PHPUnit.


How to install

For Laravel 10x

# Get the package
$ composer require luthfi/simple-crud-generator:^4.0 --dev

For Laravel 9.x

# Get the package
$ composer require luthfi/simple-crud-generator:^3.0 --dev

For Laravel 8.x

# Get the package
$ composer require luthfi/simple-crud-generator:^2.0 --dev

For Laravel 5.6 to 7.x

# Get the package
$ composer require luthfi/simple-crud-generator:^1.0 --dev

For Laravel 5.5

To use this package on laravel 5.5, we need to add the package (with browserkit) within require-dev in composer.json file, like so :

# Install required package for laravel/browser-kit-testing
$ composer require symfony/css-selector:^3.0

# Get the package
$ composer require luthfi/simple-crud-generator 1.2.* --dev

The package will auto-discovered.


How to use

Just type in terminal $ php artisan make:crud ModelName command, it will create simple Laravel CRUD files of given model name completed with tests.

For example we want to create CRUD for 'App\Models\Vehicle' model.

$ php artisan make:crud-simple Vehicle

Vehicle resource route generated on routes/web.php.
Vehicle model generated.
Vehicle table migration generated.
VehicleController generated.
Vehicle index view file generated.
Vehicle form view file generated.
lang/app.php generated.
vehicle lang files generated.
Vehicle model factory generated.
Vehicle model policy generated.
AuthServiceProvider class has been updated.
BrowserKitTest generated.
ManageVehiclesTest generated.
VehicleTest (model) generated.
VehiclePolicyTest (model policy) generated.
CRUD files generated successfully!

Make sure we have set database credential on .env file, then :

$ php artisan migrate
$ php artisan serve

Then visit our application url: http://localhost:8000/vehicles.


Usage on Fresh Install Laravel 8.x

In this example, we are using the laravel installer package to install new laravel project.

# This is example commands for Ubuntu users.
$ laravel new project-directory
$ cd project-directory
$ composer require laravel/ui
$ php artisan ui bootstrap --auth
$ npm install && npm run dev # Might need to run twice, minimum requirement: NodeJS v12.x
$ vim .env # Edit your .env file to update database configuration

# Install the package
$ composer require luthfi/simple-crud-generator:^2.0

# I really suggest "git commit" your project right before you run the make:crud command
$ php artisan make:crud Vehicle # Model name in singular

$ php artisan migrate
$ php artisan serve
# Visit your route http://127.0.0.1:8000
# Register as a new user
# Visit your route http://127.0.0.1:8000/vehicles

# Run the unit tests
$ vim phpunit.xml # Remove comments on the DB_CONNECTION and DB_DATABASE lines
$ vendor/bin/phpunit

Available Commands

# Create Full CRUD feature with tests
$ php artisan make:crud ModelName

# Create Full CRUD feature with tests and Bootstrap 3 views
$ php artisan make:crud ModelName --bs3

# Create Simple CRUD feature with tests
$ php artisan make:crud-simple ModelName

# Create Simple CRUD feature with tests and Bootstrap 3 views
$ php artisan make:crud-simple ModelName --bs3

# Create API CRUD feature with tests
$ php artisan make:crud-api ModelName

Model Attribute/column

The Model and table will only have 2 pre-definded attributes or columns : title and description on each generated model and database table. You can continue working on other column on the table.


Bootstrap 4 Views

The generated view files use Bootstrap 4 by default (for Laravel 5.6 and later).


Bootstrap 3 Views

We can also generates views that use Bootstrap 3 with --bs3 command option, eg for Laravel version 5.5.


For API

If we want to generate API Controller with feature tests, we use following command :

$ php artisan make:crud-api Vehicle

By default, we use Laravel Token Based Authentication, so we need to update our user model.

  1. Add api_token column on our users_table_migration.
  2. Add api_token as fillable property on User model.
  3. Add api_token field on our UserFactory.

API Usage

The generated API is a REST API, using GET and POST verbs, with a URI of /api/modelname.

Example code for calling the generated API, using Guzzle:

// Read data a specific Vehicle record...
$uri = 'http://your-domain.com/api/vehicles/'.$vehicleID;
$headers = ['Authorization' => 'Bearer '.$apiToken];

$client = new \GuzzleHttp\Client();
$res = $client->request('GET', $uri, ['headers' => $headers]);


// Create a new Vehicle record...
$uri = 'http://your-domain.com/api/vehicles';
$headers = ['Authorization' => 'Bearer '.$apiToken];
$payload = json_encode([
    'title' => 'Vehicle Name 1',
    'description' => 'Vehicle Description 1',
]);

$client = new \GuzzleHttp\Client();
$res = $client->request('POST', $uri, ['body' => $payload, 'headers' => $headers]);

The generated functional tests will give you examples of how to adapt this code for other call types.


Config file

You can configure your own by publishing the config file:

$ php artisan vendor:publish --provider="Luthfi\CrudGenerator\ServiceProvider" --tag=config

That will generate config/simple-crud.php file.

By default, this package have some configuration:

<?php

return [
    // The master view layout that generated views will extends
    'default_layout_view' => 'layouts.app',

    // The base test case class path for generated testing classes
    'base_test_path' => 'tests/BrowserKitTest.php',

    // The base test class full name
    'base_test_class' => 'Tests\BrowserKitTest',
];

Publishing Stub Files

Stub files is the templates which we use to generate the code for each model classes and files. We can customize the stub files as we needed by publishing them to our project directory.

$ php artisan vendor:publish --provider="Luthfi\CrudGenerator\ServiceProvider" --tag=stubs

That will generate stub files on stubs/simple-crud directory. Now we can change some stub files based on our project needs.


Attention

  • The package will creates the Model class file, the command will stop if the Model already exists.
  • You need a resources/views/layouts/app.blade.php view file, simply create one with php artisan make:auth command. You can change this configuration via the config/simple-crud.php file.

Screenshots

Visit your application in new resource route : http://127.0.0.1:8000/vehicles

Generated CRUD page by Simple CRUD Generator


Generated testing suite

Next, let us try the generated testing suite. To use the generated testing classes, we can set the database environment using in-memory database SQLite. Open phpunit.xml. Add two lines below on the env :

<phpunit>
    <!-- ..... -->
    <php>
        <!-- ..... -->
        <server name="DB_CONNECTION" value="sqlite"/>
        <server name="DB_DATABASE" value=":memory:"/>
    </php>
</phpunit>

Then run PHPUnit

$ vendor/bin/phpunit

All tests should be passed.

Generated Testing Suite on Simple CRUD Generator


Issue/Proposal

If you find any issue, or want to propose some idea to help this package better, please create an issue in this github repo.


License

This package is open-sourced software licensed under the MIT license.

More Repositories

1

silsilah

A genealogy/family tree application, built with Laravel.
PHP
597
star
2

free-pmo

Project management software for freelancers or agencies, built with Laravel.
PHP
436
star
3

grosir-obat

Sebuah sistem kasir dan manajemen produk obat untuk penjualan Grosir
PHP
224
star
4

dompet

A personal bookkeeping web application, built with Laravel.
PHP
147
star
5

uptime-monitor

A self-hosted web monitoring tool, built with laravel
PHP
130
star
6

laravel-leaflet-example

Laravel Leaflet JS project example.
PHP
106
star
7

arisan

Sistem pengelolaan grup arisan berbasis web yang dibangun dengan Laravel 5.
PHP
29
star
8

FormField

Laravel Form Field the extension of Laravelcollective Form
PHP
15
star
9

Mini-CRM

Mini CRM project, a challenge from Laravel Daily blog post.
PHP
14
star
10

Laravel-TDD

Source code laravel testing pada blog https://blog.nafies.id/tdd-laravel
PHP
10
star
11

laravel-backup-manager

Laravel 5.3 with Database Backup and Restore Example
PHP
10
star
12

mini-socmed

Sosial media mini untuk latihan notifikasi realtime laravel dengan pusher
PHP
9
star
13

product-stock

A product stock management web app example
PHP
6
star
14

Laravel-Starter-Kit

Laravel 5.2 starter kit
PHP
4
star
15

laravel-multi-table-auth

Example Laravel 5.6 application with multi table authentication.
PHP
4
star
16

radio-online

List radio online
HTML
3
star
17

simple-crud-generator-example

Laravel Simple CRUD Generator Usage Example
PHP
3
star
18

laravel-queue-notifier-example

Example for notifying users when a background (job) process has been completed.
PHP
2
star
19

simple-crud-generator-docs

Documentation for the SimpleCRUDGenerator package.
HTML
2
star
20

learning-hugo

Learning to use hugo, static site generators.
HTML
1
star
21

training-laravel-01

Training Laravel untuk Magang SMKN 3 Banjarbaru
PHP
1
star
22

panduan-penjualan

Panduan aplikasi kasir untuk toko obat
1
star
23

laravel-56-bootstrap3

Laravel 5.6 project using Bootstrap 3.3.7 frontend scaffolding.
PHP
1
star