deniskorbakov/laravel-data-scribe

A Scribe Plugin to generate API doc from spatie/laravel-data

v0.0.3 2025-08-04 16:31 UTC

This package is auto-updated.

Last update: 2025-08-05 11:32:42 UTC


README

GitHub Workflow Status GitHub Workflow Status Total Downloads Latest Version License

This package is intended for scribe business with laravel-data

By default, scribe cannot generate documentation from laravel-data, so I propose solutions in the form of this package with plugins

Scribe Support Description Plugin Name Status
Body Parameters Generate Body Params from laravel-data LaravelDataBodyParam โœ…
Responses Generate Response from laravel-data ๐Ÿšซ โŒ
Url Parameters Support Parameters along with laravel-data ๐Ÿšซ โŒ
Custom Validation Support Custom Rules in laravel-data ๐Ÿšซ โŒ

๐Ÿ“ Getting Started

Install the package via composer:

composer require deniskorbakov/laravel-data-scribe

Add the plugin in your config/scribe.php file to the very end of the array:

    'strategies' => [
        'bodyParameters'  => [
            ...Defaults::BODY_PARAMETERS_STRATEGIES,
            DenisKorbakov\LaravelDataScribe\LaravelDataBodyParam::class,
        ],
    ],

Run the command to generate documentation:

php artisan scribe:generate

โš’๏ธ Local Development

Clone this repository:

git clone https://github.com/deniskorbakov/laravel-data-scribe

Let's go to the cloned repository:

cd laravel-data-scribe

To start, initialize the project and use it:

make init

๐Ÿงช Testing

You can run the command for testing after the step with local installation

Run Lint and Analyze code(phpstan/rector/phpcs):

make lint

Run Unit tests:

make test

Run mutation tests:

make test-mutation

Run test coverage:

make test-coverage

๐Ÿค Feedback

We appreciate your support and look forward to making our product even better with your help!

@Denis Korbakov

๐Ÿ“ Generated from deniskorbakov/skeleton-php-docker