Metadata-Version: 2.3
Name: aiorequestful
Version: 0.6.0
Summary: An asynchronous HTTP and RESTful API requests framework for asyncio and Python
Project-URL: Documentation, https://geo-martino.github.io/aiorequestful/
Project-URL: Release Notes, https://geo-martino.github.io/aiorequestful/release-history.html
Project-URL: Contribute, https://geo-martino.github.io/aiorequestful/contributing.html
Project-URL: Source code, https://github.com/geo-martino/aiorequestful
Project-URL: Issues, https://github.com/geo-martino/aiorequestful/issues
Author-email: George Martin Marino <gm.engineer+aiorequestful@pm.me>
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: aiohttp~=3.9
Provides-Extra: all
Requires-Dist: aiosqlite~=0.20; extra == 'all'
Provides-Extra: build
Requires-Dist: hatch; extra == 'build'
Requires-Dist: versioningit; extra == 'build'
Provides-Extra: dev
Requires-Dist: aioresponses~=0.7; extra == 'dev'
Requires-Dist: aiosqlite~=0.20; extra == 'dev'
Requires-Dist: autodocsumm~=0.2; extra == 'dev'
Requires-Dist: faker~=26.0; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: graphviz~=0.20; extra == 'dev'
Requires-Dist: grip; extra == 'dev'
Requires-Dist: hatch; extra == 'dev'
Requires-Dist: ipywidgets; extra == 'dev'
Requires-Dist: jupyterlab; extra == 'dev'
Requires-Dist: matplotlib~=3.9; extra == 'dev'
Requires-Dist: pytest-asyncio~=0.23; extra == 'dev'
Requires-Dist: pytest-mock~=3.14; extra == 'dev'
Requires-Dist: pytest-xdist~=3.6; extra == 'dev'
Requires-Dist: pytest~=8.2; extra == 'dev'
Requires-Dist: pyyaml~=6.0; extra == 'dev'
Requires-Dist: renku-sphinx-theme; extra == 'dev'
Requires-Dist: sphinx-autodoc-typehints~=2.2; extra == 'dev'
Requires-Dist: sphinxext-opengraph~=0.9; extra == 'dev'
Requires-Dist: sphinx~=7.3; extra == 'dev'
Requires-Dist: versioningit; extra == 'dev'
Provides-Extra: docs
Requires-Dist: autodocsumm~=0.2; extra == 'docs'
Requires-Dist: graphviz~=0.20; extra == 'docs'
Requires-Dist: hatch; extra == 'docs'
Requires-Dist: matplotlib~=3.9; extra == 'docs'
Requires-Dist: renku-sphinx-theme; extra == 'docs'
Requires-Dist: sphinx-autodoc-typehints~=2.2; extra == 'docs'
Requires-Dist: sphinxext-opengraph~=0.9; extra == 'docs'
Requires-Dist: sphinx~=7.3; extra == 'docs'
Requires-Dist: versioningit; extra == 'docs'
Provides-Extra: sqlite
Requires-Dist: aiosqlite~=0.20; extra == 'sqlite'
Provides-Extra: test
Requires-Dist: aioresponses~=0.7; extra == 'test'
Requires-Dist: aiosqlite~=0.20; extra == 'test'
Requires-Dist: faker~=26.0; extra == 'test'
Requires-Dist: pytest-asyncio~=0.23; extra == 'test'
Requires-Dist: pytest-mock~=3.14; extra == 'test'
Requires-Dist: pytest-xdist~=3.6; extra == 'test'
Requires-Dist: pytest~=8.2; extra == 'test'
Requires-Dist: pyyaml~=6.0; extra == 'test'
Description-Content-Type: text/markdown

# aiorequestful

[![PyPI Version](https://img.shields.io/pypi/v/aiorequestful?logo=pypi&label=Latest%20Version)](https://pypi.org/project/aiorequestful)
[![Python Version](https://img.shields.io/pypi/pyversions/aiorequestful.svg?logo=python&label=Supported%20Python%20Versions)](https://pypi.org/project/aiorequestful/)
[![Documentation](https://img.shields.io/badge/Documentation-red.svg)](https://geo-martino.github.io/aiorequestful/)
</br>
[![PyPI Downloads](https://img.shields.io/pypi/dm/aiorequestful?label=Downloads)](https://pypi.org/project/aiorequestful/)
[![Code Size](https://img.shields.io/github/languages/code-size/geo-martino/aiorequestful?label=Code%20Size)](https://github.com/geo-martino/aiorequestful)
[![Contributors](https://img.shields.io/github/contributors/geo-martino/aiorequestful?logo=github&label=Contributors)](https://github.com/geo-martino/aiorequestful/graphs/contributors)
[![License](https://img.shields.io/github/license/geo-martino/aiorequestful?label=License)](https://github.com/geo-martino/aiorequestful/blob/master/LICENSE)
</br>
[![GitHub - Validate](https://github.com/geo-martino/aiorequestful/actions/workflows/validate.yml/badge.svg?branch=master)](https://github.com/geo-martino/aiorequestful/actions/workflows/validate.yml)
[![GitHub - Deployment](https://github.com/geo-martino/aiorequestful/actions/workflows/deploy.yml/badge.svg?event=release)](https://github.com/geo-martino/aiorequestful/actions/workflows/deploy.yml)
[![GitHub - Documentation](https://github.com/geo-martino/aiorequestful/actions/workflows/docs_publish.yml/badge.svg)](https://github.com/geo-martino/aiorequestful/actions/workflows/docs_publish.yml)

### An asynchronous HTTP and RESTful API requests framework for asyncio and Python

## Contents
* [Getting Started](#quick-guides)
* [Currently Supported](#currently-supported)
* [Release History](#release-history)
* [Contributing](#contributing)
* [Motivation & Aims](#aims)
* [Author Notes](#notes)

> **NOTE:**  
> This readme provides a brief overview of the program. 
> [Read the docs](https://geo-martino.github.io/aiorequestful/) for full reference documentation.


## Installation
Install through pip using one of the following commands:

```bash
pip install aiorequestful
```
```bash
python -m pip install aiorequestful
```

There are optional dependencies that you may install for optional functionality. 
For the current list of optional dependency groups, [read the docs](https://geo-martino.github.io/aiorequestful/howto.install.html)


## Getting Started

These quick guides will help you get set up and going with aiorequestful in just a few minutes.
For more detailed guides, check out the [documentation](https://geo-martino.github.io/aiorequestful/).

***Coming soon...***


## Currently Supported

- **Cache Backends**: `SQLiteCache`
- **Basic Authorisation**: `BasicAuthoriser`
- **OAuth2 Flows**: `AuthorisationCodeFlow` `AuthorisationCodePKCEFlow` `ClientCredentialsFlow`


## Release History

For change and release history, 
check out the [documentation](https://geo-martino.github.io/aiorequestful/release-history.html).


## Contributing

For info on how to contribute to aiorequestful, 
check out the [documentation](https://geo-martino.github.io/aiorequestful/contributing.html).


<a id="aims"></a>
## Motivations & Aims

***Coming soon...***


<a id="notes"></a>
## Author notes, contributions, and reporting issues

***Coming soon...***