Metadata-Version: 2.3
Name: pyarr
Version: 6.5.1
Summary: Synchronous Sonarr, Radarr, Lidarr, Prowlarr, Bazarr, Dispatcharr and Readarr API's for Python
Keywords: sonarr,radarr,readarr,lidarr,prowlarr,dispatcharr,bazarr,api,wrapper,plex
Author: Steven Marks
Author-email: Steven Marks <marksie1988@users.noreply.github.com>
License: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: requests>=2.28.2
Requires-Dist: types-requests>=2.28.11.17
Requires-Dist: overrides>=7.3.1
Requires-Dist: yarl>=1.9.4
Requires-Dist: backoff>=2.2.1
Requires-Dist: httpx>=0.28.1
Requires-Python: >=3.12
Project-URL: homepage, https://github.com/totaldebug/pyarr
Project-URL: repository, https://github.com/totaldebug/pyarr
Project-URL: documentation, https://docs.totaldebug.uk/pyarr
Description-Content-Type: text/markdown

<a name="readme-top"></a>

[![Release][release-shield]][release-url]
[![Stargazers][stars-shield]][stars-url]
![codecov][codecov-shield]

![GitHub last release date][gh-last-release-date]
![GitHub last commit][gh-last-commit]

[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Issues][issues-shield]][issues-url]

[![Lines of code][lines]][lines-url]
![Code size][code-size]

[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]

<!-- PROJECT LOGO -->
<br />
<div align="center">
  <a href="https://github.com/totaldebug/pyarr">
    <img src=".github/img/logo.png" alt="Logo">
  </a>

  <h3 align="center">Pyarr</h3>

  <p align="center">
    A Python library for interacting with the `arr` API's
  </p>
    <br />
    <br />
    <a href="https://github.com/totaldebug/pyarr/issues/new?assignees=&labels=type%2Fbug&template=bug_report.yml">Report Bug</a>
    ·
    <a href="https://github.com/totaldebug/pyarr/issues/new?assignees=&labels=type%2Ffeature&template=feature_request.yml">Request Feature</a>

</div>

<!-- TABLE OF CONTENTS -->
<details>
  <summary>Table of Contents</summary>
  <ol>
    <li>
      <a href="#about-the-project">About The Project</a>
      <ul>
        <li><a href="#built-with">Built With</a></li>
      </ul>
    </li>
    <li><a href="#getting-started">Getting Started</a></li>
    <li><a href="#features">Features</a></li>
    <li><a href="#compatibility">Compatibility</a></li>
    <li><a href="#roadmap">Roadmap</a></li>
    <li><a href="#sponsor">Sponsor</a></li>
    <li><a href="#contributing">Contributing</a></li>
    <li><a href="#license">License</a></li>
    <li><a href="#contact">Contact</a></li>
    <li><a href="#acknowledgments">Acknowledgments</a></li>
  </ol>
</details>

<!-- ABOUT THE PROJECT -->
## About The Project

A Python library for the following `arr` API's:

* Sonarr
* Radarr
* Readarr
* Lidarr
* Prowlarr
* Dispatcharr
* Bazarr
* Whisparr

The library supports both **Synchronous** and **Asynchronous** (asyncio) usage, providing a consistent API for both. It returns results in JSON format for ease of use, this also reduces the risk of failue when the arr APIs are updated.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### Built With

[![python][python]][python-url]

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- GETTING STARTED -->
## Getting Started

* [QuickStart Guide](https://docs.totaldebug.uk/pyarr/quickstart.html)
* [Full Documentation](https://docs.totaldebug.uk/pyarr)
* [Release Notes](https://github.com/totaldebug/pyarr/releases)

<p align="right">(<a href="#readme-top">back to top</a>)</p>

## Features

* Support for multiple Arr APIs
* Sonarr
* Radarr
* Readarr
* Lidarr
* Type checking

## Compatibility

The below versions are based on our last tests, This will be updated as tests fail and updates are published.

| Version | Sonarr | Radarr | Readarr | Lidarr |
| ------- | ------ | ------ | ------- | ------ |
| v5.0.0 | from: v3.0.10.1567 | from: v4.3.2.6857 | from: v0.1.4.1596 | from: v1.0.2.2592 |

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- ROADMAP -->
## Roadmap

See the [feature requests](https://github.com/totaldebug/pyarr/labels/type%2Ffeature) for a full list of requested features.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

## Sponsor

My projects arent possible without the support of the community, please consider donating a small amount to keep these projects alive.

[![Sponsor][Sponsor]][Sponsor-url]

<!-- CONTRIBUTING -->
## Contributing

Got something you would like to add? check out the contributing guide in the [documentation](https://docs.totaldebug.uk/pyarr/contributing.html)

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- LICENSE -->
## License

[![CC BY-NC-SA 4.0][license-shield]][license-url]

* Copyright © [Total Debug](https://totaldebug.uk).

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- CONTACT -->
## Contact

* [Discord](https://discord.gg/6fmekudc8Q)
* [Discussions](https://github.com/totaldebug/pyarr/discussions)
* [Project Link](https://github.com/totaldebug/pyarr)

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- ACKNOWLEDGMENTS -->
## Acknowledgments

Below are a list of resources that I used to assist with this project.

* None at this time

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- MARKDOWN LINKS & IMAGES -->
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
[release-shield]: https://img.shields.io/github/v/release/totaldebug/pyarr?color=ff7034&label=Release&sort=semver&style=flat-square
[release-url]: https://github.com/totaldebug/pyarr/releases
[contributors-shield]: https://img.shields.io/github/contributors/totaldebug/pyarr.svg?style=flat-square
[contributors-url]: https://github.com/totaldebug/pyarr/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/totaldebug/pyarr.svg?style=flat-square
[forks-url]: https://github.com/totaldebug/pyarr/network/members
[stars-shield]: https://img.shields.io/github/stars/totaldebug/pyarr.svg?style=flat-square
[stars-url]: https://github.com/totaldebug/pyarr/stargazers
[issues-shield]: https://img.shields.io/github/issues/totaldebug/pyarr.svg?style=flat-square
[issues-url]: https://github.com/totaldebug/pyarr/issues
[license-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-orange.svg?style=flat-square
[license-url]: https://creativecommons.org/licenses/by-nc-sa/4.0/
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/marksie1988
[codecov-shield]: https://img.shields.io/codecov/c/github/totaldebug/pyarr?style=flat-square

[gh-last-release-date]: https://img.shields.io/github/release-date/totaldebug/pyarr?style=flat-square&label=Last%20Release%20Date&logo=github&logoColor=white
[gh-last-commit]: https://img.shields.io/github/last-commit/totaldebug/pyarr.svg?style=flat-square&logo=github&label=Last%20Commit&logoColor=white

[lines]: https://img.shields.io/tokei/lines/github/totaldebug/pyarr?style=flat-square
[lines-url]: https://github.com/totaldebug/pyarr
[code-size]: https://img.shields.io/github/languages/code-size/totaldebug/pyarr?style=flat-square

[Sponsor]: https://img.shields.io/badge/sponsor-000?style=flat-square&logo=githubsponsors&logoColor=red
[Sponsor-url]: https://github.com/sponsors/marksie1988

[python]: https://img.shields.io/badge/Python-blue?style=flat-square&logo=Python&logoColor=white
[python-url]: https://www.python.org/
