Skip to main content

The easy way of using Imgur.

Project description

The simple way of using Imgur with Python.


# Imgur API Python Wrapper

With this library you can abstract away the convoluted ways of sending API requests, instead you'll have clear and readable function calls. Want to upload an image? It's simple.

```python
import pyimgur

API_KEY = 'you api key here'
image_path = 'and the path to the image'

pyimgur.upload_image(image_path, API_KEY)
```

You don't have to work with urllib, oauth or spend time trying to figure out Imgur's API. Instead you can focus on what's importment to you. Your application.

## Development

A closed beta of Imgur's API ver 3.0 has begun, the new version greatly expands on what can be done with the API. Current development of pyimgur is with the closed beta and will remain closed-source until Imgur's API ver 3.0 becomes publicly accesable.

## What can I do with pyimgur?

You can do almost everything you can do through the web frontend.

* Upload images by url. Anonymously and authenticated.
* Upload images from the computer. Both anonymously and authenticated.
* Delete images. By deletehash or any your authenticated account has uploaded.
* Download images by image hash.
* Find out what todays/this weeks/this months most popular images were.
* Find out all sorts of information about images or albums.
* Get the oembed code for an image (json only at the moment).
* Easily use oauth authentication to log in as a specific user.
* Get information about the account.
* Get all the images uploaded to the account.
* Create and delete albums.
* Edit the albums settings to make them private, display in grid and more.
* Edit albums cover pictures.
* Edit an image uploaded to an authenticated account.
* Add images to albums.
* And more!

## What can't I do?

Some things aren't possible at all with the API, either due to limitations or upstream bugs.

* Find out user information.
* See comments on images.
* Change user settings like e-mail.
* Re-order images in an album.
* Remove images from an albums.
* Empty albums can neither have their settings altered nor add images.

## Where can I find out more?

All functions have an updated docstring. For quick information about what a function does, use the builtin help function. Eg, `help(pyimgur.upload_image)` reveals information about how to use the upload_image function and what it does.

For more indepth information, go to our [wiki](google.com) on github for more informations. Here you'll find tutorials, references and everything else you'll need to get started. If you find a bug then this is also the place to file bug reports.

## Installation and dependencies

Install using pip

```
pip install pyimgur
```

Alternatively, download the source from [Python Package Index](google.com), extract it and install using

```
python setup.py install
```

pyimgur works with Python 2.7. It has the dependencies decorator, requests and oauth2. Installing via pip automatically installs these dependencies. Installing via setup.py requires you to manually ensure that these modules are present.

## License

This library is licensed under GNU GPLv3. See COPYING for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

pyimgur-0.3.2.zip (29.5 kB view details)

Uploaded Source

pyimgur-0.3.2.tar.gz (23.2 kB view details)

Uploaded Source

File details

Details for the file pyimgur-0.3.2.zip.

File metadata

  • Download URL: pyimgur-0.3.2.zip
  • Upload date:
  • Size: 29.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyimgur-0.3.2.zip
Algorithm Hash digest
SHA256 c0ab47ba64e4dbeb1f10732fb28e184f235f70722166f045bbd9def1b8457745
MD5 debb31c7041e39daa9ea07dba650fb79
BLAKE2b-256 94f5c66ba182e928bef7f1a9338344094322905f5c11366ed849b15019cc70ec

See more details on using hashes here.

File details

Details for the file pyimgur-0.3.2.tar.gz.

File metadata

  • Download URL: pyimgur-0.3.2.tar.gz
  • Upload date:
  • Size: 23.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyimgur-0.3.2.tar.gz
Algorithm Hash digest
SHA256 2e163da81bf9d83178fb0dceb05b34b5e5675395811d1e7fdb5dec7d7c4cfd64
MD5 a8c2c0db98ec10d3aa60a64c68069bee
BLAKE2b-256 870e9067b4581215292c500ef692648f74caa91f78966192f0a964597612d2a1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page