Metadata-Version: 2.1
Name: api-automation-tools
Version: 1.0.0
Summary: Tools for API automation
Home-page: https://github.com/rakutentech/api-automation-tools
Author: Ashton Szabo
Author-email: ashton.szabo@rakuten.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# API automated testing in Python
This provides a starting point for automating API's in Python using the pytest and the aiohttp frameworks on macOS.

## Required dependencies
1. `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"`
2. `brew install --cask docker`
3. `brew install pyenv`
4. `PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install 3.8.12 && pyenv global 3.8.12 && echo export PATH="$(pyenv root)/shims:$PATH" >> ~/.bash_profile && . ~/.bash_profile && pip install pipenv`

## Pip Installation
1. In the terminal cd into the root of your main test project
2. In the terminal run [`pip install api-automation-tools`](https://pypi.org/project/api-automation-tools/)

## Local Setup
1. Clone this repo
2. In the terminal cd into the root of your main test project
3. In the terminal run `pip install -e path_to_apiautomationtools`

## Usage
### Helpers
```
import apiautomationtools.helpers.dictionary_helpers as dh
import apiautomationtools.helpers.directory_helpers as dh
import apiautomationtools.helpers.json_helpers as js
```

### Pytest
This class setup creates boilerplate data directories for tests and credentials. The teardown performs 
validations and organizational restructuring on any test generated data.
```
import pytest
from apiautomationtools.pytest import ApiPytestHelper

class SomeBasePytest(ApiPytestHelper):

    @pytest.fixture
    def test_app(self, ...):
        ...
```

### Aiohttp
This class wraps up an easy to use method for making async requests. All the standard requests request
arguments are still applicable. As requests are completed, their data is saved in two csv files. One 
csv file contains the actual data sent, while the other contains a scrubbed set of data. The scrubbed 
csv file can be stored and used for reference validation of subsequent runs.
```
from apiautomationtools.client import AsyncRequests

async_requests = AsyncRequests()
batch = {'method': 'get', 'headers': {...}, 'url': '...', ...any classic requests arguments}
or
batch = [{'method': 'get', ...}, ...]
response = async_requests.request(batch)
```

### Validations
This class performs a difference between scrubbed csv files of the stored and live data generated from 
the responses of the request method. Any mismatches can be raised as errors.
```
from apiautomationtools.validations import Validations

validations = Validations()
mismatches = validations.validate_references()
mismatches = validations.validate_references(actual_refs={...})
mismatches => [{'keys': ..., 'actual_refs': {...}, 'expected_refs': {...}, 'unscrubbed_refs': {...}}, ...]
```

### Examples
An example of a test illustrating single and batch style requests - 
[test_get_example.py](examples/test_get_example.py)

An example of a base class showing setups and teardowns - 
[api_base_pytest_example.py](examples/api_base_pytest_example.py)

An example of the csv report file generated from running the test - 
[get_example.csv](examples/run_info/run_logs/pass/get_example.csv)

An example of the scrubbed csv report file generated from running the test - 
[get_example_scrubbed.csv](examples/run_info/run_logs/pass/get_example_scrubbed.csv)

An example of the log file generated from running the test - 
[get_example.log](examples/run_info/run_logs/pass/get_example.log)

An example of the error csv report file generated from running the test - 
[get_example_errors.csv](examples/run_info/run_errors/get_example_errors.csv)

### Directory structure
This package requires the following base structure for the project.
```
.
├── credentials                         # Optional - credentials
│   └── credentials.json                # Optional - credentials as json
├── tests                               # Required - test files
│   ├── data                            # Optional - test data
│   │   └── data.json                   # Optional - test data as json
│   └── test_file.py                    # Required - pytest test
└── validations                         # Optional - validation data
    └── file.json                       # Optional - validation data as json (The validation file's are scrubbed files 
                                                     autogenerated from test runs. However, the validation files 
                                                     organizational structure much match the structure of the test 
                                                     files in the tests directory.)
```

