Download the PHP package irazasyed/docgen without Composer
On this page you can find all versions of the php package irazasyed/docgen. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download irazasyed/docgen
More information about irazasyed/docgen
Files in irazasyed/docgen
Package docgen
Short Description Streamline your Laravel package development with automatic facade documentation using Docgen for Laravel
License MIT
Homepage https://github.com/irazasyed/docgen
Informations about the package docgen
Docgen for Laravel Facade
📖 Streamline your Laravel package development with automatic facade documentation using Docgen for Laravel Facade.
Introduction
Docgen for Laravel packages, the ultimate solution for Laravel package developers.
This heroic package automatically generates documentation for your Laravel package facade, eliminating the tedious task of maintaining it yourself.
With this package, IDEs will provide you and the developers using your package with method suggestions, making your development journey a breeze.
Installation
You can install the package via composer:
Usage
There are a number of ways to use the CLI tool.
Basic
Let's start with the basic usage.
Call the command with the name of the facade:
Advanced
Create a new config file in your package's root directory named docgen.php
and add the following code:
Run the following command to generate the documentation and apply it to the facade:
You can also store the config file elsewhere and provide the path using the -c
or --config
option.
Example:
Generate Docs for Multiclass Facade
If your Laravel facade is linked to a chain of classes that require documentation, you can provide an array of class names. Additionally, if you want to exclude certain methods from the documentation of a specific class, you can pass an array containing the names of those methods.
To illustrate, consider the following example which demonstrates how to use this approach with the Telegram Bot SDK's Laravel Facade:
Call the command to generate and apply the docs.
API
generate(string|array $classes, array $globalExcludedMethods = [])
Generate the documentation for given classes.
Parameters
$classes
- The class name or an array of[class => (optional) [excluded methods]]
to generate documentation using its methods.$globalExcludedMethods
- (optional) An array of methods to be excluded when generating docs.
Returns
Docgen
- The Docgen instance.
Example
getDocBlock()
Get the generated documentation.
Returns
string
- The generated documentation.
apply(string $className = '')
Apply the generated documentation to the given class name or defaults to the class used to generate docs.
Parameters
$className
- (optional) The class name to apply the generated documentation to.
Returns
bool
- True if it was successful, false otherwise.
TODO
- [ ] Add github action to automatically maintain docs.
Resources
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Irfaq Syed
- All Contributors
License
The MIT License (MIT). Please see License File for more information.