Home

Awesome

Wagtail Makeup

tests codecov

Tired of having no images locally when you need them? Don't want to fill your computer up with images? Use Wagtail Makeup ;)

Installation

Wagtail makeup depends on python unsplash:

pip install python-unsplash wagtailmakeup

Configuration

Sign up for an Unsplash api key and add this to your settings:

# settings.py
WAGTAIL_UNSPLASH = {
    "CLIENT_ID": "",
    "CLIENT_SECRET": ""
}

The API is rate limited to 50 request/hour... you can apply for a higher rate limit.

Using

You probably don't want this in your production settings, so add the following to you local.py settings:

INSTALLED_APPS.append('wagtailmakeup')

Wagtail Makeup works by providing a new management command:

python manage.py make_up [search query] [amount of images]

So you want to replace all your broken images on your site with dogs (who wouldn't) you can do it like this:

python manage.py make_up dogs 10

Note: the amount value is the number of images to download, the higher this is, the more variance you will get 😎

Contributing

Contributions are welcome, please see our contributing guide for more details.