Skip to content

valdergallo/django-compress-field

Repository files navigation

Django Compress Storage

Build Status Latest Version BSD License Pypi Download

Custom ZipFileField for Django that auto compact file uploaded

    PROJECT RENAMED django-compress-storage to django-compress-field

Install

    pip install django-compress-field

or by source code

    git clone https://github.com/valdergallo/django-compress-field/
    python setup.py install

or

    pip install git+https://github.com/valdergallo/django-compress-field.git

Features

  • Compress FileUpload storage file with Zip
  • Delete old file that was compressed on zip
  • Support for South Migrations
  • Support Django 1.2+
  • Celery 2.5+ support - async compress file with Celery
  • Windows Support
  • Linux support
  • OSx support
  • Support for Python3+
  • Support for Python2.6+

Motivation

On my job we need save all upload files for 5 year. Losing a lot space on server with this files, because this I created this application.

Django Settings Configurations

FILE_COMPRESS_DELETE_OLD_FILE = True # to delete old files after compressed
FILE_COMPRESS_DELETE_OLD_FILE = False # to not delete old files after compressed

# Feature only for version v9.0+
FILE_COMPRESS_QUEUE = 'Celery' # by default queue is Celery, but you can change this with this var on settings


INSTALLED_APPS = (
    ...
    ...
    'compress_field',
)

Usage

# example model.py

from django.db import models
from compress_field import ZipFileField

class MyContent(models.Model):
    name = models.CharField(max_length=150)
    create_date = models.DateTimeField(auto_now=True)
    upload_file = ZipFileField(upload_to='mycontent/')

    def __unicode__(self):
        return self.name

Shell

>>> from example.core import MyContent
>>> m = MyContent.objects.get(id=2)
>>> m.upload_file
<ZipCompressFieldFile: mycontent/test.txt>
>>> m.upload_file.compress()
>>> m.upload_file
<ZipCompressFieldFile: mycontent/test.zip>

Using with Celery

If Celery are installed on Site Packages. You just need create one post_save on your model to use async compress.

# listeners.py file

from django.db.models.signals import post_save

def auto_compress_file_on_post_save(sender, instance, **kargs):
    instance.upload_file.compress()

post_save.connect(auto_compress_file_on_post_save, sender=MyContent)

If you don´t wanna use Celery async compress:

def auto_compress_file_on_post_save(sender, instance, **kargs):
    instance.upload_file.compress(async=False)

post_save.connect(auto_compress_file_on_post_save, sender=MyContent)

Developer

# download code
git clone https://github.com/valdergallo/django-compress-field

# install developer packages
setup.py develop

# test project
pytest .

#clean extra content
setup.py clean