Metadata-Version: 2.4
Name: imgur_python
Version: 0.2.1
Summary: A Python client for the Imgur API
Home-page: https://github.com/faustocarrera/imgur-python/wiki
Download-URL: https://github.com/faustocarrera/imgur-python
Author: Fausto Carrera
Author-email: fausto.carrera@gmx.com
License: GPLv3+
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Requires-Python: >=3.1
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.0
Requires-Dist: fleep>=1.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

imgur-python
============

A Python client for the Imgur API.

The original imgurpython project is no longer supported, so, I decided to create my own python client for the [Imgur API](https://apidocs.imgur_client.com/?version=latest).

__Disclaimer:__ This is a work in progress. In this first version, I'm not gonna implement all the API calls, only the necessary ones to interact with imgur and be able to create albums, upload images and share them on the site.

For more information, check the [project wiki](https://github.com/faustocarrera/imgur-python/wiki)

## Requirements

* Python 3.5
* [requests](https://2.python-requests.org/en/master/)
* [fleep](https://github.com/floyernick/fleep-py)

## Links

* [imgur API documentation](https://apidocs.imgur.com/?version=latest#intro)
* [API client wiki](https://github.com/faustocarrera/imgur-python/wiki)

## Install

```
$ python setup.py install
```

with pip

```
$ pip install imgur-python
```

## How to publish something and share it with the community?

* upload a bunch of images
* add them to an album
* share it

```
from os import path
from imgur_python import Imgur

imgur_client = Imgur({'client_id': 'cf8c57ca8......'})
image = imgur_client.image_upload(path.realpath('./image.png'), 'Untitled', 'My first image upload')
image_id = image['response']['data']['id']
album =  imgur_client.album_create([image_id], 'My first album', 'Something funny', 'public')
album_id = album['response']['data']['id']
response = imgur_client.gallery_album(album_id, 'This is going down on the sub', 0, 'funny,midly_interesting')
print(response)
```
