tomrf / readme-gen
为 PHP 包生成带有公共 API 文档的说明文件
0.0.9
2022-11-11 00:10 UTC
Requires
- php: ^8.0
- haydenpierce/class-finder: ^0.4.3
- phpdocumentor/reflection-docblock: ^5.3
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.8
- phpmd/phpmd: ^2.12
- phpstan/phpstan: ^1.6
- phpunit/phpunit: ^9.5
- roave/security-advisories: dev-latest
README
自动生成带有公共 API 文档的 📚 README 文件,基于 composer.json 中的 docblocks 和包信息
包含的格式化工具
- Markdown
📔 前往文档
安装
通过 composer 安装
composer require tomrf/readme-gen
使用方法
$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' );
测试
composer test
许可证
本项目采用 MIT 许可证 (MIT) 发布。更多信息请参见 LICENSE
文档
📂 Tomrf\ReadmeGen\ReadmeGen::class
ReadmeGen.
这是一个非常正在进行中的工作。
__construct()
public function __construct( string $projectRoot ): void
generate()
public function generate( Tomrf\ReadmeGen\Interface\ReadmeFormatterInterface $formatter, string $templateFilename ): string
使用 📚 tomrf/readme-gen 生成,时间为 2022-06-15T22:33:50+02:00