This package is a set of field and widget that improves the images and files field behaviour
Project description
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:
History
0.1.0 (2022-01-17)
First release on PyPI.
0.1.1 (2022-01-24)
0.1.2 (2022-01-24)
0.1.5 (2022-01-24)
Update requirements and readme.