django-db-storage

Custom Database Storage for Django


Keywords
django, metrics, analytics
License
BSD-3-Clause
Install
pip install django-db-storage==1.0.2

Documentation

django-db-storage

https://travis-ci.org/derekkwok/django-db-storage.svg?branch=master https://coveralls.io/repos/github/derekkwok/django-db-storage/badge.svg?branch=master

Overview

Warning: In many cases, storing files in the database is a BAD idea. Your database will easily become bloated and the performance can degrade rapidly. See this StackExchange post for more information.

This is a custom storage backend for storing files in the database instead of the file system and is a drop-in replacement for Django's FileSystemStorage. Some benefits of this application:

  • no changes needed to existing models, it just works (and if it doesn't, open a ticket!)
  • django-admin is implemented and can be used to search, upload, download and manage files
  • 100% code coverage with unit tests
http://i.imgur.com/4g9tmEZt.png http://i.imgur.com/A2F8xlrt.png

Requirements

  • Python (2.7, 3.4, 3.5)
  • Django (1.8, 1.9)

Installation

Installation using pip:

$ pip install django-db-storage

Update settings.py

# Add 'dbstorage' to INSTALLED_APPS
INSTALLED_APPS = [
    'dbstorage',
]

# Optionally set DEFAULT_FILE_STORAGE
DEFAULT_FILE_STORAGE = 'dbstorage.storage.DBStorage'

# Choose a root url for uploaded files
MEDIA_URL = '/media/'

Update urls.py

urlpatterns = [
    ...
    dbstorage_url(),
]

Run database migrations

$ python manage.py migrate

How to Use

No modification are needed for models to work properly.

def user_directory_path(instance, filename):
    return 'user_{0}/{1}'.format(instance.user.id, filename)

class MyModel(models.Model):

    file_field1 = models.FileField()
    file_field2 = models.FileField(upload_to='uploads/%Y/%m/%d/')
    file_field3 = models.FileField(upload_to=user_directory_path)

Bugs?

Create an issue at https://github.com/derekkwok/django-db-storage/issues