Skip to main content

django-blob-storage

This is a fork from django-db-storage2

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.

.. _StackExchange post: http://programmers.stackexchange.com/questions/150669/is-it-a-bad-practice-to-store-large-files-10-mb-in-a-database

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
  • only db files need to be backed up

Requirements

  • Python (3.5+)
  • Django (3.2+)

Installation

Installation using pip::

$ pip install django-blob-storage

Update settings.py

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

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

    # Optionally for tracking file accesses (currently over view)
    # DJANGO_DBFILE_TRACK_ACCESSED=True
    # Optionally set another db than default
    # DJANGO_DBFILE_DB = "foo"

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

Update urls.py

    urlpatterns = [
        ...
        # dbstorage
        path("", include("dbstorage.urls")),
    ]

Run database migrations (done automatically, when included as app)

env DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH="." poetry run django-admin 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/devkral/django-blob-storage/issues

Metadata

Release files for django-blob-storage 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-blob-storage 0.2.2
File Size Uploaded
django_blob_storage-0.2.2.tar.gz 7.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-blob-storage 0.2.2
File Interpreter ABI Platform
django_blob_storage-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 16.0 kB

Release files / django_blob_storage-0.2.2.tar.gz

Download URL django_blob_storage-0.2.2.tar.gz
Size 7.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9169cea60749947426fa9f7fea462caf7689764b3e90b15a507bbba5bcdb9a2d
BLAKE2b-256 checksum
How to use checksums
2b214f62515414984d88521ef2216c5c94927efb01b4632c5cea9c3fa4af3c40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.4.2 CPython/3.11.3 Linux/6.3.2-arch1-1

Release files / django_blob_storage-0.2.2-py3-none-any.whl

Download URL django_blob_storage-0.2.2-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9f2eddb68d6b0dafb4a44c3fb1d8acdb5d35ebbc169dfec6a40e380be1941139
BLAKE2b-256 checksum
How to use checksums
6a136526f907c0f54f58d5228e7689b75ae2d569f85c09c67fc56f1eb2f9a4e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.4.2 CPython/3.11.3 Linux/6.3.2-arch1-1

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page