Metadata-Version: 2.1
Name: demapi
Version: 0.1.6
Summary: Make customizable demotivators and motivators through imgonline.com.ua API. Supports async-await style
Home-page: https://github.com/deknowny/demapi
License: MIT
Keywords: demotivators,imgonline,async,await,aio
Author: Yan Kurbatov
Author-email: deknowny@gmail.com
Requires-Python: >=3.7,<4.0
Classifier: Framework :: AsyncIO
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.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Provides-Extra: check
Provides-Extra: style
Provides-Extra: test
Requires-Dist: aiohttp (>=3.8.1,<4.0.0)
Requires-Dist: black (>=21.11b1,<22.0); extra == "style"
Requires-Dist: certifi (>=2021.10.8,<2022.0.0)
Requires-Dist: coverage (>=6.1.2,<7.0.0); extra == "test"
Requires-Dist: coveralls (>=3.3.1,<4.0.0); extra == "test"
Requires-Dist: isort (>=5.10.1,<6.0.0); extra == "style"
Requires-Dist: mypy (>=0.910,<0.911); extra == "check"
Requires-Dist: pre-commit (>=2.15.0,<3.0.0); extra == "style"
Requires-Dist: pytest (>=6.2.5,<7.0.0); extra == "test"
Requires-Dist: pytest-asyncio (>=0.16.0,<0.17.0); extra == "test"
Requires-Dist: pytest-cov (>=3.0.0,<4.0.0); extra == "test"
Requires-Dist: requests (>=2.26.0,<3.0.0)
Requires-Dist: types-certifi (>=2021.10.8,<2022.0.0); extra == "check"
Requires-Dist: types-requests (>=2.26.1,<3.0.0); extra == "check"
Project-URL: Documentation, https://github.com/deknowny/demapi/blob/main/GUIDE.md
Description-Content-Type: text/markdown

# DemAPI
> Make customizable demotivators and motivators through imgonline.com.ua API. Supports async-await style

![Example](https://raw.githubusercontent.com/deknowny/demapi/main/assets/example.png)
***
__Documentation__: Check out [GUIDE.md](https://github.com/deknowny/demapi/blob/main/GUIDE.md)

[![Coverage Status](https://coveralls.io/repos/github/deknowny/demapi/badge.svg?branch=main)](https://coveralls.io/github/deknowny/demapi?branch=main)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/demapi)
![PyPI - Downloads](https://img.shields.io/pypi/dm/demapi)
![PyPI](https://img.shields.io/pypi/v/demapi)
![PyPI - Implementation](https://img.shields.io/pypi/implementation/demapi)

# Features
* Sync and `async-await` style
* Customizable titles and explanation (size, colors etc.)
* Flexible output image (line breaks showed correctly)
* Not CPU-bound (through unlimited API)
* Full tests coverage
* Full typed

## Overview
Configure request params such as text, color, size etc.
And then download the image. Optionally save to disk otherwise
use `image.content` for raw bytes object
```python
import demapi


conf = demapi.Configure(
    base_photo="example.png",
    title="The first line",
    explanation="The second line"
)
image = conf.download()
image.save("example.png")
```

Or via `await` (based on `aiohttp`):

```python
image = await conf.coroutine_download()
```

# Installation
Install the latest version through `GitHub`:
```shell
python -m pip install https://github.com/deknowny/demapi/archive/main.zip
```
Or through `PyPI`
```shell
python -m pip install demapi
```

# Contributing
Check out [CONTRIBUTING.md](./CONTRIBUTING.md)


