Metadata-Version: 2.1
Name: imgflippy
Version: 0.0.3
Summary: An open source Python wrapper for the imgflip RESTful API (https://api.imgflip.com).
Home-page: https://github.com/theceebee/pyimgflip
Author: Caleb Bell
Author-email: caleb@theceebee.com
License: UNKNOWN
Keywords: imgflip meme API
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Requires-Python: >=2.7
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: six

# imgflippy
An open source Python interface for the [imgflip RESTful API](https://api.imgflip.com) `imgflippy` has been developed
to remain true to the original API while offering the conveniences that Python allows.

### Quickstart
`imgflippy` has been written with the intention of allowing for meme generation from either a command line
interface *or* an interpreted environment.

#### Command Line

##### get_memes
Print a table of the popular memes that may be captioned with this API:

From the imgflip API documentation:
> The size of this array and the order of memes may change at any time. When this description was written, it returned
> 100 memes ordered by how many times they were captioned in the last 30 days. Additional properties other than those
> listed below may be added in the future without warning, so do not assume the JSON structure of each meme will never
> have new properties.

```
$ python -m imgflippy get_memes
Template ID |                      Name                      |               URL
------------+------------------------------------------------+---------------------------------
112126428   | Distracted Boyfriend                           | https://i.imgflip.com/1ur9b0.jpg
181913649   | Drake Hotline Bling                            | https://i.imgflip.com/30b1gx.jpg
87743020    | Two Buttons                                    | https://i.imgflip.com/1g8my4.jpg
...
```

##### add_caption

From the imgflip API documentation:
> Add a caption to an Imgflip meme template. Images created with this API will be publicly accessible by anyone through
> the url in the response - there is no "private" option. This does not mean these memes will be posted publicly though,
> one still needs to know the exact URL to find the image. If the image hangs around on Imgflip servers for a while and
> gets very few views (direct image views and image page views both count), it will be auto-deleted to save space.


