Metadata-Version: 2.1
Name: vedro-spec-compare
Version: 0.0.2
Summary: OpenAPI spec compare
Home-page: https://github.com/kvs8/vedro-spec-compare
Author: Konstantin Shefer
Author-email: kostya.shefer.999@gmail.com
License: Apache-2.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jinja2<4.0.0,>=3.1.4
Requires-Dist: schemax-openapi<1.0.0,>=0.0.5
Requires-Dist: PyYAML<7.0.0,>=6.0.2
Requires-Dist: requests<3.0.0,>=2.32.3

# vedro-spec-compare

[![PyPI](https://img.shields.io/pypi/v/vedro-spec-compare.svg?style=flat-square)](https://pypi.org/project/vedro-spec-compare/)
[![Python Version](https://img.shields.io/pypi/pyversions/vedro-spec-compare.svg?style=flat-square)](https://pypi.org/project/vedro-spec-compare/)

# Description

`vedro-spec-compare` is a tool to compare two OpenAPI specs and generate a coverage report

# Installation

```bash
pip3 install vedro-spec-compare
```


# Usage

## Help
```bash
vsc -h
```
```
usage: vsc [-h] {coverage} ...

vedro-spec-compare commands

positional arguments:
  {coverage}  Available commands
    coverage  Generate coverage report

options:
  -h, --help  show this help message and exit
```

## Coverage
```bash
vsc coverage -h
```
```
usage: vsc coverage [-h] [--report-path REPORT_PATH] golden_spec_path testing_spec_path

positional arguments:
  golden_spec_path      Path to the golden OpenAPI spec
  testing_spec_path     Path to the testing OpenAPI spec

options:
  -h, --help            show this help message and exit
  --report-path REPORT_PATH
                        The path of the coverage report
```

### Examples
#### From yml files
```bash
vsc coverage golden_spec.yml testing_spec.yml
```
```bash
google-chrome coverage.html 
```

#### With report path
```bash
vsc coverage golden_spec.yml testing_spec.yml --report-path coverage_report.html
```
```bash
google-chrome coverage_report.html 
```

#### From urls
```bash
vsc coverage https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore-expanded.yaml https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.yaml
```
```bash
google-chrome coverage.html 
```
