Metadata-Version: 2.1
Name: niceposter
Version: 0.1.4
Summary: Image Manipulation Tool - Used for creating & modifying image posters
License: GPL-3.0-or-later
Author: A.A.Isa
Author-email: aabdulmajeed.isa@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Pillow (>=8.0.1,<9.0.0)
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/amajai/niceposter/main/res/icon.png" width="180">
<p>

# Niceposter
A library that allows you to create your own image poster which you can use to share on social media. Implemented in Python using the PIL module.

<img src="https://raw.githubusercontent.com/amajai/niceposter/main/res/demo.gif">

## **Installation**
```elm
pip install niceposter
```
__Important:__ depending on your system, make sure to use `pip3` and `python3` instead.


**That's all! 🎉**   

>If you would like to install a specific version of Niceposter you may do so with:
>```elm
>pip install niceposter==0.1.1
>```
#### Using Niceposter

To start creating an image poster, you have to initialize it, like so: 
```python
from niceposter import Create

bg_image = Create.Poster() # default size of 500x500
```

Then use any one of the methods to make or add changes to an image. Examples:
```python
bg_image.add_image('cool-image.png', position='cc', scale=20) # added in center of the bg image and scaled down by 20%
bg_image.text('Interesting text!', position(50,50), color='red', align='center')
bg_image.frame(thickness=10)
bg_image.filter(rgb=(255,255,255), opacity=50)
```

#### Updating Niceposter
```elm
pip install niceposter -U
```
## Documentation
[**In progress**]

## Features in progress
[**In progress**]

## Documentation
Contributions are welcome, and they are greatly appreciated! Every little bit
helps, and credit will always be given.



