Metadata-Version: 2.1
Name: redgifs
Version: 1.8.2
Summary: Async and Sync Python Wrapper for the RedGIFs API.
Home-page: https://github.com/scrazzz/redgifs
Author: scrazzz
License: MIT
Project-URL: Documentation, https://redgifs.rtfd.io
Project-URL: Issue tracker, https://github.com/scrazzz/redgifs/issues
Requires-Python: >=3.8.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: aiohttp<4,>=3.6.0
Provides-Extra: docs
Requires-Dist: Sphinx==4.4.0; extra == "docs"
Requires-Dist: furo==2022.2.23; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest==7.3.1; extra == "test"

<h1 align="center"> <code>redgifs</code> </h1>

<div align="center">
    <a href="https://pypi.org/project/redgifs">
        <img src="https://img.shields.io/pypi/v/redgifs.svg" alt="pypi">
    </a>
    <a href="https://github.com/scrazzz/redgifs/actions/workflows/test.yml">
        <img src="https://github.com/scrazzz/redgifs/actions/workflows/test.yml/badge.svg" alt="pytest">
    </a>
</div>

<p align="center"> Async and Sync Python Wrapper for the RedGIFs API. </p>

-----

> ⭐ _Please star this repo to support the developer and to encourage the development of this project!_

-----

### Installation
```
pip install -U redgifs
```

#### Development version
```
pip install -U git+https://github.com/scrazzz/redgifs
```

`redgifs` works on Python versions 3.8 and above.

-----

### Quickstart
Command Line usage:
```console
redgifs [url]
```
See `redgifs -h` for help.

Synchronous usage:
```py
import redgifs

api = redgifs.API()
api.login() # Login with temporary token
response = api.search('3D')
print(response)
api.close()
```

Asynchronous usage:
```py
import asyncio
from redgifs.aio import API

async def main():
    api = API()
    await api.login() # Login with teporary token
    response = await api.search('3D')
    print(response)
    await api.close()

loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```

More examples can be found in the examples directory.

-----

### Links
- [Documentation](https://redgifs.readthedocs.io)
- [Discord](https://discord.gg/yNsUTuXvzn)
