Skip to content

Automatically generates a ๐Ÿ“š README file with public API documentation for a PHP package, based on docblocks and package information from composer.json

License

Notifications You must be signed in to change notification settings

tomrf/readme-gen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

25 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

readme-gen - generates readme with public api documentation for php packages

PHP Version Require Latest Stable Version License

Automatically generates a ๐Ÿ“š README file with public API documentation for a PHP package, based on docblocks and package information from composer.json

Included formatters:

  • Markdown

๐Ÿ“” Go to documentation

Installation

Installation via composer:

composer require tomrf/readme-gen

Usage

$readmeGen = new \Tomrf\ReadmeGen\ReadmeGen('.'); // path to project directory

echo $readmeGen->generate(
    new Tomrf\ReadmeGen\Formatter\MarkdownFormatter(
        \phpDocumentor\Reflection\DocBlockFactory::createInstance(),
        new \phpDocumentor\Reflection\Types\ContextFactory()
    ),
    'resources/template.md'
);

Testing

composer test

License

This project is released under the MIT License (MIT). See LICENSE for more information.

Documentation


๐Ÿ“‚ Tomrf\ReadmeGen\ReadmeGen::class

ReadmeGen.

Very much a work in progress.

__construct()

public function __construct(
    string $projectRoot
): void

generate()

public function generate(
    Tomrf\ReadmeGen\Interface\ReadmeFormatterInterface $formatter,
    string $templateFilename
): string

Generated 2022-06-15T22:33:50+02:00 using ๐Ÿ“štomrf/readme-gen

About

Automatically generates a ๐Ÿ“š README file with public API documentation for a PHP package, based on docblocks and package information from composer.json

Topics

Resources

License

Stars

Watchers

Forks

Languages