schenke-io/laravel-relation-manager

Allow to plan, document and test model relations in Laravel

v1.0.2 2024-10-19 10:54 UTC

README

Latest Version on Packagist GitHub Tests Action Status Total Downloads Coverage

Developing complex Laravel applications with many models can be difficult. Laravel Relation Manager helps by bringing all your model relationships together. It creates tests to make sure they work and documents them for easy reference. This saves you time, improves code quality, and keeps your project organized.

Installation

You can install the package via composer:

composer require schenke-io/laravel-relation-manager

Install the config file of the package:

php artisan relation-manager:install

Usage

This package's core functionality is provided by two components:

  1. Configuration File: The config/relation-manager.php file allows you to define directories, files and namespaces of your project.
  2. Custom Relation Manager Command: This command, which extends the RelationManagerCommand class, facilitates the configuration process.

In the command file:

  • define models and their relations
  • decide if you want to add reverse relations
  • add BackedEnum classes used in $casts array of models as a special relation
  • after the model-relation definition:
    • write the test file
    • run the test file (only)
    • write text and graphical documentation
    • echo tables
# app/Console/Commands/RelationWriteCommand

use SchenkeIo\LaravelRelationManager\Console\RelationManagerCommand;

class RelationWriteCommand extends RelationManagerCommand 
{
    
    public function handle(): void
    {       
        
        $this->relationManager->model('Country')
            ->hasOne('Capital', true)
            ->hasMany('Region', true);
            
        $this->relationManager->model('Region')
            ->hasMany('City', true);
            
                        
        // repeat this for any model    

        // finally 
        $this->relationManager
            ->writeMarkdown()
            ->showTables()
            ->writeTest(strict: true)
            ->runTest();
                   
        
    }    
}

This command is called by default with php artisan relation-manager:run.

The following methods can be used inside handle():

Configuration

The configuration file config/relation-manager.php has the following keys available.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

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