Skip to main content

Delete unused media files from Django project

build-status-image PyPI

This package provides management command cleanup_unused_media for Django applications. With help of this management command you can remove all media files which are no longer used (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.5, 3.6, PyPy are tested with tox.

    Django 1.6, 1.7, 1.8, 1.9, 1.10, 1.11 are tested with tox.

  2. Add django-unused-media to INSTALLED_APPS:

    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 have to confirm the action.

Options

--noinput, --no-input

Non interactive mode. Command will remove files without any confirmation from 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

--remove-empty-dirs

Buy default script keep empty dirs in media folder. But with this option empty directories will be removed after cleaning process automatically.

--dry-run

Dry run without any affect on your data

Tests

At first make sure that you are in virtualenv.

Install all dependencies:

make setup

To run tests:

make test

To run static analyser:

make flake8

License

MIT licence

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-unused-media-0.1.11.tar.gz (8.3 kB view details)

Uploaded Source

File details

Details for the file django-unused-media-0.1.11.tar.gz.

File metadata

File hashes

Hashes for django-unused-media-0.1.11.tar.gz
Algorithm Hash digest
SHA256 9c4386340849406a271a1b2edf992523a071172eee9d2461b93a090895c72955
MD5 2d0f4a4f27ab89166012b8913750bced
BLAKE2b-256 cf728f7425d421db5d15b40f35382508f5568e59df77935d8dbfcf0ec10c9c88

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page