OpenAPI Initializer

 OpenAPI Initializer is a Laravel package that provides a straightforward command to scaffold an OpenAPI spec file.

Once you install the package, you can run the artisan command to walk you through various questions to make the OpenAPI specification.

You start by running the command:

1php artisan openapi:create

Then the plugin will walk you through a bunch of questions to construct the specification file:

Once you walk through the questions, OpenAPI Initializer will generate an openapi.yml specification file that will look similar to the following:

 1openapi: 3.0.3
 2info:
 3    title: ''
 4    version: 0.1.0
 5    description: 'Test API'
 6    contact: { name: 'Laravel News', email: user@example.com, url: null }
 7servers:
 8    - { url: 'http://openapi-demo.test', description: 'Local url for testing' }
 9tags: null
10paths: null
11components:
12    schemas: null
13    responses: null
14    headers: null
15    parameters: null
16    links: null
17    examples: null

You can learn more about this package, get full installation instructions, and view the source code on GitHub. If you’d like the know more about OpenAPI, I suggest an OpenAPI 3.0 Tutorial and the OpenAPI Specification (3.0.3) document.

Read More

Simplifying Service Providers With Laravel Package Tools

 Laravel Package Tools is a package by Spatie that provides an opinionated base service provider you can use to streamline the registration of your package’s config files, migrations, commands, and more.

Here’s how to simplify service providers in @laravelphp packageshttps://t.co/qKmIO7nUJY

Spoiler: I released a package for that https://t.co/URH2udPbiJ#php #laravel pic.twitter.com/tWCGuE8HG8

— Freek Van der Herten (@freekmurze) January 25, 2021

I think you’ll agree that this package can streamline common use-cases found in package service providers:

 1use Spatie\LaravelPackageTools\PackageServiceProvider;
 2use Spatie\LaravelPackageTools\Package;
 3 
 4class YourPackageServiceProvider extends PackageServiceProvider
 5{
 6    public function configurePackage(Package $package) : void
 7    {
 8        $package
 9            ->name('your-package-name')
10            ->hasConfigFile()
11            ->hasViews()
12            ->hasTranslations()
13            ->hasMigration('create_package_tables')
14            ->hasCommand(YourCoolPackageCommand::class);
15    }
16}

Spatie also provides a skeleton Laravel package you can use as a template for your next package project. The Laravel skeleton uses the package tools service provider out of the box.

Read More