Skip to content

Commit

Permalink
Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Ferror committed Dec 31, 2023
1 parent c966d34 commit 960bd30
Showing 1 changed file with 36 additions and 0 deletions.
36 changes: 36 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Open API Coverage Calculator Symfony Bundle

The Open API Coverage Calculator Symfony Bundle enables you to track another system metric - The API Documentation Coverage.
The library extracts your application API endpoints via Symfony Routing and checks them against [NelmioAPIDocBundle](https://github.com/nelmio/NelmioApiDocBundle),
the most popular library for Open API Specification in the [Symfony](https://github.com/symfony) ecosystem.

## Installation

```bash
composer require --dev ferror/openapi-coverage
```

```php
// bundles.php

return [
Ferror\OpenapiCoverage\Symfony\Bundle::class => ['dev' => true, 'test' => true],
];
```

## usage

```bash
php bin/console ferror:check-openapi-coverage
```

## Example Result

```
Open API coverage: 75%
+- Missing documentation -+
| path | method |
+---------------+---------+
| /products/:id | get |
+---------------+---------+
```

0 comments on commit 960bd30

Please sign in to comment.