No project description provided
Project description
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 set DJANGO_DBFILE_TRACK_ACCESSED=True to track accessed times
# 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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_blob_storage-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9b024ab20115a197eabe4ae8e258a3dcdb939014fa29f86a7ccf525eee103289 |
|
MD5 | a30018be100db09751c246f19c0dd788 |
|
BLAKE2b-256 | d9b8dd589172a102388124dfcf152c2199b571a1a4ab1cadd2c0aac3454034a5 |
Hashes for django_blob_storage-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d03c1b99ee57e1e413f6492e83910b77d0e5803e3f2baf906663f7b57a578bca |
|
MD5 | 1a919f18d679b891806f0f4f29ef8fbf |
|
BLAKE2b-256 | 65b0c3ecc6813e46b5dbe3e599586b3ea09fb16d4732c15eadfc2e64dcbef1ba |