dagpipy 1.1.1
A Python API Wrapper for https://dagpi.xyz/, the fast and free image API.
License: MIT
Requires Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*

# dagpipy
A Python API Wrapper for https://dagpi.xyz/, the fast and free image API.<br>
[`dagpipy docs`](https://github.com/niztg/dagpipy/blob/master/DOCUMENTATION.md) • [`dagpi docs`](https://dagpi.docs.apiary.io/#reference) • [`examples`](https://github.com/niztg/dagpipy/blob/master/examples.py)

### Getting a token
- Go to https://dagpi.xyz/dashboard
- Sign up
- Create an app
- Wait for a few days/weeks
- Check back to see if you have your token. If so, you're free to continue!

### Instantiate a Client
```py
import dagpipy

client = dagpipy.Client(TOKEN)
```

## Image API

#### Where `url` is equal to:
<img src=https://www.gettyimages.ca/gi-resources/images/500px/983794168.jpg height=500></img>

```py
from PIL import Image

bad = client.get_image(
    option=dagpipy.ImageOptions.bad,
    url=url
)

bad_image = Image.open(bad)
bad_image.show()
```
##### Returns:<br>
<img src=https://i.imgur.com/9RILo9W.png height=500></img>

<hr>

```py
from PIL import Image

tweet = client.get_image(
    option=dagpipy.ImageOptions.tweet,
    url=url,
    username="dagpipy",
    text="amazing"
)

tweet_image = Image.open(tweet)
tweet_image.show()
```
##### Returns:<br>
<img src=https://i.imgur.com/37qSqod.png height=500></img>

<hr>

```py
from PIL import Image

whyareyougay = client.get_image(
    option=dagpipy.ImageOptions.whyareyougay,
    url=url,
    url2=url
)

whyareyougay_image = Image.open(whyareyougay)
whyareyougay_image.show()
```
##### Returns:<br>
<img src=https://i.imgur.com/NgfdJnT.png height=500></img>

<hr>

## Data/Games API

```py
wtp = client.get_game(
    option=dagpipy.Games.whos_that_pokemon
)
print(wtp.name)
print(wtp.question)
print(wtp.answer)
print(wtp.types)
print(wtp.abilities)
print(wtp.ascii)
```

##### Returns:<br>
```py
Kecleon
https://logoassetsgame.s3.us-east-2.amazonaws.com/wtp/pokemon/281q.png
https://logoassetsgame.s3.us-east-2.amazonaws.com/wtp/pokemon/281a.png
['normal']
['color change', 'protean']
@@@@@@@@@@@@@@@@@@@@@@@@,@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@:.?@@@+.%@,,:@@@@%:@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@.*+@@....?....,,:,:,:::%@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@:.........**,,,**%::::#+:,%@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@.*.....****,,,******,:::::@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@,,,...*.S:.,,:*******S:::.%?S@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@,,S,:::*#,,S*********:::::,@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@,,,:%,,,,,,,,,,::.****:::::,@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@S,@,,,,,%,.,+:::::.:,****:::::,@@@@@@@@@@@@@@@@@@@@@@
@@@@@@%,,,,,:::::%,S::S?::*:,***S::,.@@@@@@@@@@@@@@@@@@@@@@@
@@@@@S,,,#:::::::.,:**#??**#:***.@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@*,,,::::::::::*:.**.***%:***,@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@.::*:,,,,:S%:***?::+.***:S***,@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@+****:..:::S+::::S?+*****@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@,#:********%*::******%@,.@@@.@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@:.:*************?******,@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@.......*:****.***%.@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@#::*%****::******+.%,,@@@@@@@@@@@@@@@@@@@@@@@
@@@@:?%.:,,:::::***:*.:::***?..*#:,,@@@@@@,#:::**:::?@@@@@@@
@,%*******+?*::::::::::****+.**SSSS+@@@@::*.***...*******@@@
@@.@@@..#****************:*.SSSSS#+SS*@%:**.#*******+***.%@@
@@@@@@@@@@@@@@:#+******:+S#SSSSS%***+*?********...***..***%@
@@@@@@@@@@@@@@@@@@@*.+SSSSSSS**+:#*****?**.**.****.***.****@
@@@@@@@@@@@@@@@@@@@?...+**.+***:,#:::*****?****S**..**..***+
@@@@@@@@@@@@@@@@@@@:**S**********::::%**%**.*****.****.****@
@@@@@@@@@@@@@@@@@@@::%*************?.****************%****#@
@@@@@@@@@@@@@@@@@@@?::::%*************?.....*****...*****#@@
@@@@@@@@@@@@@@@@@@@@*::::*****+,@,?......**************:@@@@
@@@@@@@@@@@@@@@@@@@@@@+*******.@@@@@@.:**************.@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@:****#@@@@@@@@@@@@@@..S,,@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@#?,*??@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
```

<hr>

```py
joke = client.get_game(
    option=dagpipy.Games.joke
)
print(joke.id)
print(joke.joke)
```

##### Returns:<br>
```py
41914
What do you call a midget physic that has escaped from prison?? A small medium at large
```

Consult the docs for more information on how to use this module!