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.
# 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
Release history Release notifications | RSS feed
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)
pyimgur-0.3.2.tar.gz
(23.2 kB
view details)
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | c0ab47ba64e4dbeb1f10732fb28e184f235f70722166f045bbd9def1b8457745 |
|
MD5 | debb31c7041e39daa9ea07dba650fb79 |
|
BLAKE2b-256 | 94f5c66ba182e928bef7f1a9338344094322905f5c11366ed849b15019cc70ec |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2e163da81bf9d83178fb0dceb05b34b5e5675395811d1e7fdb5dec7d7c4cfd64 |
|
MD5 | a8c2c0db98ec10d3aa60a64c68069bee |
|
BLAKE2b-256 | 870e9067b4581215292c500ef692648f74caa91f78966192f0a964597612d2a1 |