Package Development and Ecosystem

packages/isbn/
├── composer.json
├── config/isbn.php
├── resources/views/isbn.blade.php
├── src/Isbn.php                       validation, normalisation, ISBN-13 conversion, fixed-width formatting
├── src/IsbnServiceProvider.php
├── src/Facades/Isbn.php
├── src/View/IsbnComponent.php         <x-isbn value="…" />
├── src/Console/CheckIsbnCommand.php   php artisan isbn:check
├── tests/TestCase.php
└── tests/IsbnTest.php

{
    "name": "bookshelf/isbn",
    "require": {
        "php": "^8.3",
        "illuminate/console": "^12.0|^13.0",
        "illuminate/support": "^12.0|^13.0",
        "illuminate/view": "^12.0|^13.0"
    },
    "require-dev": { "orchestra/testbench": "^11.3", "phpunit/phpunit": "^12.5" },
    "autoload": { "psr-4": { "Bookshelf\\Isbn\\": "src/" } },
    "extra": {
        "laravel": {
            "providers": ["Bookshelf\\Isbn\\IsbnServiceProvider"],
            "aliases": { "Isbn": "Bookshelf\\Isbn\\Facades\\Isbn" }
        }
    }
}

<?php
// src/IsbnServiceProvider.php
namespace Bookshelf\Isbn;

use Illuminate\Support\Facades\Blade;
use Illuminate\Support\ServiceProvider;

class IsbnServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        $this->mergeConfigFrom(__DIR__.'/../config/isbn.php', 'isbn');      // the app's file overrides keys, not the whole array
        $this->app->singleton(Isbn::class, fn ($app) => new Isbn($app['config']->get('isbn.separator')));
    }

    public function boot(): void
    {
        $this->loadViewsFrom(__DIR__.'/../resources/views', 'isbn');        // isbn::isbn, overridable in resources/views/vendor/isbn
        Blade::component('isbn', View\IsbnComponent::class);                // <x-isbn value="…" />

        if ($this->app->runningInConsole()) {
            $this->commands([Console\CheckIsbnCommand::class]);
            $this->publishes([__DIR__.'/../config/isbn.php' => config_path('isbn.php')], 'isbn-config');
            $this->publishes([__DIR__.'/../resources/views' => resource_path('views/vendor/isbn')], 'isbn-views');
        }

        if (class_exists(\Illuminate\Foundation\Console\AboutCommand::class)) {   // laravel/framework, not illuminate/*
            \Illuminate\Foundation\Console\AboutCommand::add('ISBN', fn () => ['Separator' => config('isbn.separator')]);
        }
    }
}

$ composer config repositories.isbn '{"type": "path", "url": "../packages/isbn", "options": {"symlink": true}}'
$ composer require bookshelf/isbn:@dev
  - Installing bookshelf/isbn (dev-main): Symlinking from ../packages/isbn
 bookshelf/isbn ................................................ DONE
$ php -r '$m = require "bootstrap/cache/packages.php"; echo json_encode($m["bookshelf/isbn"]);'
{"providers":["Bookshelf\\Isbn\\IsbnServiceProvider"],"aliases":{"Isbn":"Bookshelf\\Isbn\\Facades\\Isbn"}}

$ php artisan isbn:check 978-0-8070-8305-4 0807083054 978-0-8070-8305-5 0-441-17271-X
+-------------------+-------+-------------------+
| Input             | Valid | ISBN-13           |
+-------------------+-------+-------------------+
| 978-0-8070-8305-4 | no    | -                 |
| 0807083054        | yes   | 978-0-8070-8305-5 |
| 978-0-8070-8305-5 | yes   | 978-0-8070-8305-5 |
| 0-441-17271-X     | no    | -                 |
+-------------------+-------+-------------------+
$ php artisan about --only=isbn
 ISBN ..........................................................
 Separator ................................................... -
$ php artisan vendor:publish --tag=isbn-config
 Copying file [../packages/isbn/config/isbn.php] to [config/isbn.php] ...... DONE
# with 'separator' => ' ' in config/isbn.php:
Blade::render('<x-isbn value="0807083054" />')   <span class="isbn" title="ISBN-13">978 0 8070 8305 5</span>
Isbn::format('0807083054')                       978 0 8070 8305 5

<?php
// tests/TestCase.php
namespace Bookshelf\Isbn\Tests;

use Bookshelf\Isbn\IsbnServiceProvider;
use Orchestra\Testbench\TestCase as Orchestra;

abstract class TestCase extends Orchestra
{
    protected function getPackageProviders($app): array
    {
        return [IsbnServiceProvider::class];
    }

    protected function defineEnvironment($app): void
    {
        $app['config']->set('isbn.separator', '-');
    }
}

<?php
// tests/IsbnTest.php
namespace Bookshelf\Isbn\Tests;

use Bookshelf\Isbn\Facades\Isbn;
use Illuminate\Support\Facades\Blade;
use PHPUnit\Framework\Attributes\DataProvider;

class IsbnTest extends TestCase
{
    public static function isbns(): array
    {
        return [
            'ISBN-10' => ['0807083054', true],
            'ISBN-10 with X' => ['080442957X', true],
            'ISBN-13' => ['978-0-8070-8305-5', true],
            'wrong check digit' => ['978-0-8070-8305-4', false],
            'too short' => ['12345', false],
        ];
    }

    #[DataProvider('isbns')]
    public function test_it_validates_lengths_and_checksums(string $isbn, bool $valid): void
    {
        $this->assertSame($valid, Isbn::isValid($isbn));
    }

    public function test_it_formats_with_the_configured_separator(): void
    {
        $this->assertSame('978-0-8070-8305-5', Isbn::format('0807083054'));

        config(['isbn.separator' => ' ']);
        $this->app->forgetInstance(\Bookshelf\Isbn\Isbn::class);
        Isbn::clearResolvedInstance(\Bookshelf\Isbn\Isbn::class);
        $this->assertSame('978 0 8070 8305 5', Isbn::format('0807083054'));
    }

    public function test_it_renders_the_blade_component(): void
    {
        $this->assertStringContainsString('978-0-8070-8305-5', Blade::render('<x-isbn value="0807083054" />'));
    }

    public function test_the_command_reports_invalid_input(): void
    {
        $this->artisan('isbn:check', ['isbn' => ['978-0-8070-8305-4']])->expectsOutputToContain('no')->assertSuccessful();
    }
}

$ vendor/bin/phpunit
OK (8 tests, 10 assertions)