Django File Field Utils

This package is a set of field and widget that improves the images and files field behaviour

Documentation

The full documentation is at https://django-file-field-utils.readthedocs.io.

Quickstart

Install Django File Field Utils:

pip install django-file-field-utils

You need to add easy_thumbnails to INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'easy_thumbnails',
    ...
)

Run

python manage.py migrate easy_thumbnails

Features

• A image-field that support also svg files

Example of usage

image = SVGAndImageField(_("Image"), blank=True)

• An admin widget that get the preview of image-field

Example of usage

from file_field_utils.db.widgets import ConfigurableImageWidget

class NewsAdminForm(forms.ModelForm):
    class Meta:
        model = News
        widgets = {
            'image': ConfigurableImageWidget()
        }

@admin.register(News)
class NewsAdmin(admin.ModelAdmin):
    form = NewsAdminForm

• Method for media file upload path support in file fields

Example of usage

image = ImageField(_("Image"), upload_to=UploadPath("example"), blank=True)

The image of model instance will be upload under directory:

/media/uploads/<instance_model_app_label>/<instance_model_name>/example/

image = ImageField(_("Image"), upload_to=UploadPathWithID("example"), blank=True)

The image of model instance will be upload under directory:

/media/uploads/<instance_model_app_label>/<instance_model_name>/example/<instance_id>/

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

Development commands

pip install -r requirements_dev.txt
invoke -l

Credits

Tools used in rendering this package:

• Cookiecutter

• cookiecutter-djangopackage