Merge branch 'release/4.0'

* release/4.0:
  Bump version to 4.0
  Universal wheels!
  Replaces #301 autodiscover works with AppConfig
  Ignore autogenerated CTags file
  Do not try south modelinspector when not needed
  Make it possible to configure IMAGEKIT_CACHE_TIMEOUT
  Test against Django 1.11
  Close the file only if it has been opened locally
  Cleanup caching configuration
  updated readme.rst with a svg badge
  honor post_save's update_fields and only fire the source_saved signal when needed
  Ignore VSCode workspace config files
  Fixed #350: Error when trying to access width/height after url
  Fixes #382: Tests no longer leave junk
  Fixes #379 Support for Django 1.10
  Ignore .idea from git
  Include the test suite in the sourcetarball but do not install it.
  Make travis happy
  Drop support for older Django and Python versions
  Replace Lenna image in tests with a truly free alternative.
  Move compat module outside of templatetags package
  Fix test requirements for django 1.9 and Python3.5

Author: vstoykov

.gitignore

@@ -4,11 +4,14 @@
 *.pyc
 .DS_Store
 .tox
+.idea
+.vscode
 MANIFEST
 build
 dist
 /tests/media/*
-!/tests/media/lenna.png
+!/tests/media/reference.png
 /venv
 /venv3
 /.env
+/tags

.travis.yml

@@ -1,46 +1,62 @@
+
 language: python
-python: "2.7"
+
 sudo: false
 
-env:
-  - TOX_ENV=py26-django12
-  - TOX_ENV=py26-django13
-  - TOX_ENV=py26-django14
-  - TOX_ENV=py26-django15
-  - TOX_ENV=py26-django16
-  - TOX_ENV=py27-django12
-  - TOX_ENV=py27-django13
-  - TOX_ENV=py27-django14
-  - TOX_ENV=py27-django15
-  - TOX_ENV=py27-django16
-  - TOX_ENV=py27-django17
-  - TOX_ENV=py27-django18
-  - TOX_ENV=py27-django19
-  - TOX_ENV=py32-django15
-  - TOX_ENV=py32-django16
-  - TOX_ENV=py32-django17
-  - TOX_ENV=py32-django18
-  - TOX_ENV=py33-django15
-  - TOX_ENV=py33-django16
-  - TOX_ENV=py33-django17
-  - TOX_ENV=py33-django18
-  - TOX_ENV=py34-django16
-  - TOX_ENV=py34-django17
-  - TOX_ENV=py34-django18
-  - TOX_ENV=py34-django19
-  - TOX_ENV=py35-django19
+install:
+  - pip install tox
+
+script:
+  - tox
 
 matrix:
-  # Python 3.5 not yet available on travis, watch this to see when it is.
   fast_finish: true
-  allow_failures:
-    - env: TOX_ENV=py35-django19
-
-install:
-  - pip install tox --use-mirrors
+  include:
+    - env: TOXENV=py27-django14
+      python: 2.7
+    - env: TOXENV=py27-django15
+      python: 2.7
+    - env: TOXENV=py27-django16
+      python: 2.7
+    - env: TOXENV=py27-django17
+      python: 2.7
+    - env: TOXENV=py27-django18
+      python: 2.7
+    - env: TOXENV=py27-django19
+      python: 2.7
+    - env: TOXENV=py27-django110
+      python: 2.7
+    - env: TOXENV=py27-django111
+      python: 2.7
+    - env: TOXENV=py33-django15
+      python: 3.3
+    - env: TOXENV=py33-django16
+      python: 3.3
+    - env: TOXENV=py33-django17
+      python: 3.3
+    - env: TOXENV=py33-django18
+      python: 3.3
+    - env: TOXENV=py34-django16
+      python: 3.4
+    - env: TOXENV=py34-django17
+      python: 3.4
+    - env: TOXENV=py34-django18
+      python: 3.4
+    - env: TOXENV=py34-django19
+      python: 3.4
+    - env: TOXENV=py34-django110
+      python: 3.4
+    - env: TOXENV=py34-django111
+      python: 3.4
+    - env: TOXENV=py35-django18
+      python: 3.5
+    - env: TOXENV=py35-django19
+      python: 3.5
+    - env: TOXENV=py35-django110
+      python: 3.5
+    - env: TOXENV=py35-django111
+      python: 3.5
 
-script:
-  - tox -e $TOX_ENV
 
 notifications:
   irc: "irc.freenode.org#imagekit"

MANIFEST.in

@@ -1,6 +1,18 @@
 include AUTHORS
 include LICENSE
 include README.rst
-recursive-include docs *
-recursive-include imagekit/templates *
-prune tests
+include testrunner.py
+include setup.cfg
+include tests/*.py
+include tests/assets/Lenna.png
+include tests/assets/lenna-*.jpg
+include tests/media/lenna.png
+prune tests/media/CACHE
+prune tests/media/b
+prune tests/media/photos
+include docs/Makefile
+include docs/conf.py
+include docs/make.bat
+include docs/*.rst
+recursive-include docs/_themes LICENSE README.rst flask_theme_support.py theme.conf *.css_t *.css *.html
+recursive-include imagekit/templates *.html

README.rst

@@ -1,6 +1,6 @@
 |Build Status|_
 
-.. |Build Status| image:: https://travis-ci.org/matthewwithanm/django-imagekit.png?branch=develop
+.. |Build Status| image:: https://travis-ci.org/matthewwithanm/django-imagekit.svg?branch=develop
 .. _Build Status: https://travis-ci.org/matthewwithanm/django-imagekit
 
 ImageKit is a Django app for processing images. Need a thumbnail? A

docs/caching.rst

@@ -100,13 +100,21 @@ ImageKit. Each has its own pros and cons.
 Caching Data About Generated Files
 ----------------------------------
 
-The easiest, and most significant improvement you can make to improve the
-performance of your site is to have ImageKit cache the state of your generated
-files. The default cache file backend will already do this (if ``DEBUG`` is
-``False``), using your default Django cache backend, but you can make it way
-better by setting ``IMAGEKIT_CACHE_BACKEND``. Generally, once a file is
-generated, you will never be removing it; therefore, if you can, you should set
-``IMAGEKIT_CACHE_BACKEND`` to a cache backend that will cache forever.
+Generally, once a file is generated, you will never be removing it, so by
+default ImageKit will use default cache to cache the state of generated
+files "forever" (or only 5 minutes when ``DEBUG = True``).
+
+The time for which ImageKit will cache state is configured with
+``IMAGEKIT_CACHE_TIMEOUT``. If set to ``None`` this means "never expire"
+(default when ``DEBUG = False``). You can reduce this timeout if you want
+or set it to some numeric value in seconds if your cache backend behaves
+differently and for example do not cache values if timeout is ``None``.
+
+If you clear your cache durring deployment or some other reason probably
+you do not want to lose the cache for generated images especcialy if you
+are using some slow remote storage (like Amazon S3). Then you can configure
+seprate cache (for example redis) in your ``CACHES`` config and tell ImageKit
+to use it instead of the default cache by setting ``IMAGEKIT_CACHE_BACKEND``.
 
 
 Pre-Generating Images

docs/configuration.rst

@@ -55,6 +55,15 @@ Settings
 .. _`Django cache section`: https://docs.djangoproject.com/en/1.8/topics/cache/#accessing-the-cache
 
 
+.. attribute:: IMAGEKIT_CACHE_TIMEOUT
+
+    :default: ``None``
+
+    Use when you need to override the timeout used to cache file state.
+    By default it is "cache forever".
+    It's highly recommended that you use a very high timeout.
+
+
 .. attribute:: IMAGEKIT_CACHE_PREFIX
 
     :default: ``'imagekit:'``

imagekit/cachefiles/backends.py

@@ -2,6 +2,7 @@
 import warnings
 from copy import copy
 from django.core.exceptions import ImproperlyConfigured
+from django.conf import settings
 
 
 class CacheFileState(object):
@@ -52,8 +53,7 @@ class CachedFileBackend(object):
     @property
     def cache(self):
         if not getattr(self, '_cache', None):
-            from django.conf import settings
-            self._cache = get_cache(settings.IMAGEKIT_CACHE_BACKEND)
+            self._cache = get_cache()
         return self._cache
 
     def get_key(self, file):
@@ -75,7 +75,7 @@ def set_state(self, file, state):
         if state == CacheFileState.DOES_NOT_EXIST:
             self.cache.set(key, state, self.existence_check_timeout)
         else:
-            self.cache.set(key, state)
+            self.cache.set(key, state, settings.IMAGEKIT_CACHE_TIMEOUT)
 
     def __getstate__(self):
         state = copy(self.__dict__)

imagekit/templatetags/compat.py renamed to imagekit/compat.py

@@ -1,5 +1,6 @@
 from appconf import AppConf
 from django.conf import settings
+from django.core.exceptions import ImproperlyConfigured
 
 
 class ImageKitConf(AppConf):
@@ -13,32 +14,24 @@ class ImageKitConf(AppConf):
 
     CACHE_BACKEND = None
     CACHE_PREFIX = 'imagekit:'
+    CACHE_TIMEOUT = None
     USE_MEMCACHED_SAFE_CACHE_KEY = True
 
     def configure_cache_backend(self, value):
         if value is None:
-            # DEFAULT_CACHE_ALIAS doesn't exist in Django<=1.2
-            try:
-                from django.core.cache import DEFAULT_CACHE_ALIAS as default_cache_alias
-            except ImportError:
-                default_cache_alias = 'default'
-
-            caches = getattr(settings, 'CACHES', None)
-            if caches is None:
-                # Support Django<=1.2 there is no default `CACHES` setting
-                try:
-                    from django.core.cache.backends.dummy import DummyCache
-                except ImportError:
-                    dummy_cache = 'dummy://'
-                else:
-                    dummy_cache = 'django.core.cache.backends.dummy.DummyCache'
-                return dummy_cache
-
-            if default_cache_alias in caches:
-                value = default_cache_alias
-            else:
-                raise ValueError("The default cache alias '%s' is not available in CACHES" % default_cache_alias)
+            from django.core.cache import DEFAULT_CACHE_ALIAS
+            return DEFAULT_CACHE_ALIAS
 
+        if value not in settings.CACHES:
+            raise ImproperlyConfigured("{0} is not present in settings.CACHES".format(value))
+
+        return value
+
+    def configure_cache_timeout(self, value):
+        if value is None and settings.DEBUG:
+            # If value is not configured and is DEBUG set it to 5 minutes
+            return 300
+        # Otherwise leave it as is. If it is None then valies will never expire
         return value
 
     def configure_default_file_storage(self, value):

imagekit/conf.py

@@ -56,7 +56,18 @@ def _get_size(self):
 
     def open(self, mode='rb'):
         self._require_file()
-        self.file.open(mode)
+        try:
+            self.file.open(mode)
+        except ValueError:
+            # if the underlaying file can't be reopened
+            # then we will use the storage to try to open it again
+            if self.file.closed:
+                # clear cached file instance
+                del self.file
+                # Because file is a property we can acces it after
+                # we deleted it
+                return self.file.open(mode)
+            raise
 
     def _get_closed(self):
         file = getattr(self, '_file', None)