This consists in API interface for Uploadcare, and a couple of Django goodies.

To install it, just run

pip install pyuploadcare

(or easy_install pyuploadcare if you're into vintage)

First of all, you'll need API keys: public and private. You can get them at the Uploadcare website.

As soon as you get your API keys, add them to your Django settings file:

UPLOADCARE = {
    'pub_key': '***',
    'secret': '***',
}

If you don't want to use hosted assets (from fastatic.uploadcare.com) you should add 'pyuploadcare.dj' to INSTALLED_APPS setting and add

PYUPLOADCARE_USE_HOSTED_ASSETS = False

to django settings file. (Kudos to Sławek Ehlert for the feature!)

If you want to provide custom url for widget, you should add 'pyuploadcare.dj' to INSTALLED_APPS setting and add

PYUPLOADCARE_USE_HOSTED_ASSETS = False
PYUPLOADCARE_WIDGET_URL = 'http://path.to.asset'

to django settings file.

Uploadcare widget will use default upload handler url, unless you specify PYUPLOADCARE_UPLOAD_BASE_URL django settings

PYUPLOADCARE_UPLOAD_BASE_URL = 'http://path.to.your.upload.handler'

You're all set now!

Adding a Uploadcare file field to your model is really simple. Like that:

from django.db import models

from pyuploadcare.dj import FileField


class Photo(models.Model):
    title = models.CharField(max_length=255)
    photo = FileField()

FileField doesn't require any arguments, file paths or whatever. It just works. That's the point of it all.

It looks nice in the admin interface

It's really simple, just use your Uploadcare-enabled models as any other models:

for p in Photo.objects.all():

    # p.photo contains pyuploadcare.file.File object

    print p.photo.cdn_url

    print p.photo.resized(200, 400) # returns the url of resized version of the image
    print p.photo.resized(height=400)
    print p.photo.cropped(150, 150)

To make your life easier, Uploadcare file objects understand some 'magic' properties.

{{ p.photo.cropped_120x200 }}
{{ p.photo.resized_120 }}
{{ p.photo.resized_x120 }}
{{ p.photo.resized_600x120 }}

These are most useful in Django templates, which are somewhat limited in calling functions with arguments. Or you can contruct url manually:

{{ p.photo.cdn_url }}-/resize/400x300/-/effect/flip/-/effect/grayscale/

Keep in mind that Uploadcare authentication will fail if computer clock is not synchronized.