Skip to main content

Django application for image assets management

Project description

django-image-assets

Django application for image assets management.

Build Status codecov PyPI version

Use case

  • There are several content types on a web site
  • Each of them has a set of required or additional image assets
  • Every asset of same asset type must satisfy custom constraints on dimensions, format and file size.
  • The most important thing: these constraints and required asset type sets are updated often, along with web design evolves and more platforms are added.

Installation

pip install django-image-assets

Working example is in testproject.testapp.

  1. Add image_assets application to installed apps in django settings:

    INSTALLED_APPS.append('image_assets')
    
  2. Add generic relation to your content models:

    from django.contrib.contenttypes.fields import GenericRelation
    from django.db import models
    
    from image_assets.models import Asset
    
    
    class Video(models.Model):
        assets = GenericRelation(Asset, blank=True)
    
  3. Setup inlines for assets

    from django.contrib import admin
    
    from image_assets.admin import AssetsInline
    from testproject.testapp import models
    
    
    @admin.register(models.Video)
    class VideoAdmin(admin.ModelAdmin):
        inlines = (AssetsInline,)
    

Usage

  1. Create new asset type (i.e. "thumbnail")
  2. Add Video to allowed_for set: now you can add a thumbnail to a video. Or you may skip this asset.
  3. Add Article to required_for set: now you will able to create or edit an article with valid "thumbnail" asset only.
  4. When an asset is deleted, it's file is owned by DeletedAsset object and may be wiped later by manual or automatic cleanup.

Advanced

If you need to alter model fields i.e. for AssetType, you may subclass existing model and than change image_assets application settings.

  1. Subclass AssetType model
    from django.db import models
    from image_assets.models import AssetType
    
    
    class MyAssetType(AssetType):
        some_feature_flag = models.BooleanField(default=False)
    
  2. Change a reference to an asset type model in settings:
    IMAGE_ASSETS_CONFIG = {
        'ASSET_TYPE_MODEL': 'my_app.MyAssetType',
        'ASSET_MODEL': 'image_assets.Asset',
        'DELETED_ASSET_MODEL': 'image_assets.DeletedAsset'
    }
    
  3. image_assets.AssetType will be declared as abstract and MyAssetType will be returned as result of image_assets.models.get_asset_type_model()

Project details


Download files

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

Files for django-image-assets, version 0.0.11
Filename, size File type Python version Upload date Hashes
Filename, size django_image_assets-0.0.11-py3-none-any.whl (23.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size django-image-assets-0.0.11.tar.gz (16.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page