django-dummy-thumbnails 0.2.5

Prerequisites

• Django 1.8, 1.9, 1.10, 1.11, 2.0, 2.1, 2.2

• Python 2.7, 3.5, 3.6, 3.7

Although django-dummy-thumbnails is not being tested against older versions of Django, tests do pass with Django versions 1.5, 1.6 and 1.7.

Installation

1. Install in your virtual environment

   Latest stable version from PyPI:

   pip install django-dummy-thumbnails

   or latest stable version from GitHub:

   pip install https://github.com/barseghyanartur/django-dummy-thumbnails/archive/stable.tar.gz

   or latest stable version from BitBucket:

   pip install https://bitbucket.org/barseghyanartur/django-dummy-thumbnails/get/stable.tar.gz

2. Add dummy_thumbnails to your INSTALLED_APPS in the global settings.py.

   INSTALLED_APPS = (
       # ...
       'dummy_thumbnails',
       # ...
   )

3. Collect the statics:

   ./manage.py collectstatic --noinput

4. Specify a custom path to your images directory in settings:

   DUMMY_THUMBNAILS_IMAGES_PATH = '/home/path/to/images/'

   This should be a directory inside your media directory of your Django project. Otherwise Django would raise a SuspiciousOperation exception. In order not to duplicate tons of files for each project, you are advised to create symlinks to the images directory in the media directory of your Django project.

   ln -s /home/path/to/images /home/repos/your-django-project/media

   If you prefer to use included public domain images, run the following management command:

   ./manage.py dummy_thumbnails_symlink_dummy_images

   And specify the following path in settings:

   DUMMY_THUMBNAILS_IMAGES_PATH = os.path.join(MEDIA_ROOT, 'mixed')

Usage

Common usage examples.

Dealing with broken or invalid dummy images

Of course, it’s always better to have a good working set of dummy images. However, it might happen that for some reason one of your dummy images is broken.

The recommended approach is to use a management command dummy_thumbnails_verify_dummy_images, which has been written in order to verify the dummy images and identify possible problems. It also lets you remove broken/invalid dummy images.

To remove broken/invalid dummy images with confirmation, type:

./manage.py dummy_thumbnails_verify_dummy_images

To remove broken/invalid dummy images without confirmation, type:

./manage.py dummy_thumbnails_verify_dummy_images --noinput

To just list broken/invalid dummy images without removal, type:

./manage.py dummy_thumbnails_verify_dummy_images --list

Another way to avoid failures is to set the value of DUMMY_THUMBNAILS_VERIFY_IMAGES to True in your project settings. Beware, that this slows down the start up time of your Django project, although does not slow down further rendering of the images.

Importing images from feed

Imports images from feeds, that support enclosures.

INSTALLED_APPS = (
    # ...
    'dummy_thumbnails.contrib.image_importers.feed',
    # ...
)

./manage.py dummy_thumbnails_import_from_feed

./manage.py dummy_thumbnails_import_from_feed \
    "https://api.flickr.com/services/feeds/groups_pool.gne?id=36256495@N00" \
    --limit=100

DUMMY_THUMBNAILS_FEED_DEFAULT_FEED_URL = "https://api.flickr.com/" \
                                         "services/feeds/groups_pool.gne" \
                                         "?id=36256495@N00"

Demo

Run demo locally

In order to be able to quickly evaluate the django-dummy-thumbnails, a demo app (with a quick installer) has been created (works on Ubuntu/Debian, may work on other Linux systems as well, although not guaranteed). Follow the instructions below to have the demo running within a minute.

Grab the latest dummy_thumbnails_demo_installer.sh:

wget -O - https://raw.github.com/barseghyanartur/django-dummy-thumbnails/stable/examples/dummy_thumbnails_demo_installer.sh | bash

Open your browser and test the app.

• URL: http://127.0.0.1:8001/

If quick installer doesn’t work for you, see the manual steps on running the example project.

Testing

Simply type:

./runtests.py

or use tox:

tox

or use tox to check specific env:

tox -e py37

or run Django tests:

./manage.py test dummy_thumbnails --settings=settings.testing

License

GPL-2.0-only OR LGPL-2.1-or-later

Support

For any issues contact me at the e-mail given in the Author section.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>