deprofundis1 / flask-imgur

Send images to imgur from your flask app

Flask-Imgur

A simple module implementing automatic image upload into Imgur image hosting service. Imgur does have rather big and convoluted API, this library is meant for those who simply want to upload and delete images from their service with no additional hassle. Compatible with Python 2.6+ and 3.x.

For Flask-Imgur to work properly you need client id API key, see Imgur API documentation for information on how to obtain it.

client id can either be provided to your app via Flask config file (with IMGUR_ID key) or passed during Imgur class initialization

Installation

Install using pip:

pip install Flask-Imgur

Usage:

from flask import Flask
from flask_imgur import Imgur

app = Flask(__name__)
imgur_handler = Imgur(app)

Then inside a function:

@app.route("/image_upload", methods=["GET","POST"])
def get_img():
	if request.method == "POST":
		image = request.files.get("my_image")
		image_data = imgur_handler.send_image(image)

		image_data["success"] # True
		image_data["data"]["height"] # 200
		image_data["data"]["link"] # "http://imgur.com/SbBGk.jpg"
		image_data["data"]["deletehash"] # "eYZd3NNJHsbreD1"

Refer to Official model reference for info about available fields.

Another thing you might wanna do is to delete the image, this requires deletehash created when image been uploaded. Example:

	delete_info = imgur_handler.delete_image(delete_hash="eYZd3NNJHsbreD1")
	delete_info["success"] # True

Reference

send_image(image, send_params, additional_headers)

Send Werkzeug file object containing image to Imgur.

• image (image object) -- Werkzeug image object obtained through request.files dictionary (required)
• send_params (dict) -- Any additional data to be added to POST request (optional)
• additional_headers (dict) -- Additional headers to be passed along with request (optional)

delete_image(delete_hash, additional_headers)

Delete the image from Imgur.

• delete_hash (string) -- Pass deletehash obtained when sending image to Imgur
• additional_headers (dict) -- any additional headers to be added to request