Metadata-Version: 2.1
Name: django-unused-media
Version: 0.2.1
Summary: Delete unused media files from Django project
Home-page: https://github.com/akolpakov/django-unused-media
Author: Andrey Kolpakov
Author-email: aakolpakov@gmail.com
License: MIT
Description: Delete unused media files from Django project
        =============================================
        
        |build-status-image| |PyPI|
        
        Package provides management command ``cleanup_unused_media`` for Django
        applications.
        
        You can remove all not used media files (files without references from
        any Django model with ``FileField`` or ``ImageField`` fields or their
        inheritances).
        
        Installation
        ============
        
        1. Install ``django-unused-media``: ``pip install django-unused-media``
        
           Python ``2.7``, ``3.6``, ``3.7``, ``pypy`` are tested with tox.
        
           Django ``1.8``, ``1.9``, ``1.10``, ``1.11``, ``2.0``, ``2.1``,
           ``2.2``, ``3.0`` are tested with tox.
        
        2. Add ``django-unused-media`` to ``INSTALLED_APPS``:
           ``python     INSTALLED_APPS = (         ...         'django_unused_media',         ...     )``
        
        Usage
        =====
        
        To cleanup all unused media files, run management command:
        
        ::
        
           ./manage.py cleanup_unused_media
        
        By default command is running in interactive mode. List of files which
        are going to be removed will be displayed for confirmation. User has to
        confirm the action.
        
        Options
        ~~~~~~~
        
        ``--noinput``, ``--no-input``
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        Non interactive mode. Command will remove files without any confirmation
        from the user. Useful for scripts.
        
        ::
        
           ./manage.py cleanup_unused_media --noinput
        
        ``-e``, ``--exclude``
        ^^^^^^^^^^^^^^^^^^^^^
        
        To avoid operating on particular files you can use exclude option. -
        *``*`` as any symbol is supported.* - *Can use multiple options in one
        command.*
        
        For example, to keep ``.gitignore`` and ``*.png`` files you can use:
        
        ::
        
           ./manage.py cleanup_unused_media -e *.gitignore -e *.png
        
        Also you can exclude entire folder or some files in that folder (path
        should be relative to ``settings.MEDIA_ROOT``):
        
        ::
        
           ./manage.py cleanup_unused_media -e path/to/dir/* -e path/to/dir/my*.doc
        
        ``--minimum-file-age``, seconds
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        *Default = 60 (one minute)*
        
        Minimum file age to consider for cleanup. All files younger this age
        will be skipped.
        
        ``--remove-empty-dirs``
        ^^^^^^^^^^^^^^^^^^^^^^^
        
        By default script keeps empty dirs in media folder. But with this option
        all empty directories will be removed after cleaning process
        automatically.
        
        ``--dry-run``
        ^^^^^^^^^^^^^
        
        Dry run without any affect on your data
        
        ``--verbosity {0,1,2}``, ``-v {0,1,2}``
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        Verbosity level. - 0 - silent - 1 - normal output (default) - 2 -
        verbose output (list individual files)
        
        Tests
        =====
        
        At first make sure that you are in virtualenv if you use it.
        
        Install all dependencies:
        
        ::
        
           make setup
        
        To run tests:
        
        ::
        
           make test
        
        To run static analyser:
        
        ::
        
           make flake8
        
        License
        =======
        
        `MIT licence <./LICENSE>`__
        
        .. |build-status-image| image:: https://api.travis-ci.org/akolpakov/django-unused-media.svg?branch=master
           :target: http://travis-ci.org/akolpakov/django-unused-media?branch=master
        .. |PyPI| image:: https://img.shields.io/pypi/v/django-unused-media.svg
           :target: https://pypi.python.org/pypi/django-unused-media
        
Keywords: python django unused media remove delete
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Operating System :: OS Independent
Provides-Extra: tests
