4b7738c0f2
* starting py3 upgrade * b64 not base64 * more progress, some more future things, and encoding * tox * update circle.yml * that version doesnt exist yet, oops * install? * sigh * Docker me? * update readme, requirements * fix for python3 * python35 * morgan remediations * does this work? * how about this? * one more time * no blank lines? * revert a bit * add future imports
84 lines
3.1 KiB
Markdown
84 lines
3.1 KiB
Markdown
# Django-dbfilestorage
|
|
|
|
[](https://circleci.com/gh/tyrelsouza/django-dbfilestorage) [](https://codecov.io/gh/tyrelsouza/django-dbfilestorage)
|
|
|
|
Custom file storage for Django that stores file data and content type in the database.
|
|
Easy to use for testing remote storages when you're in a transition stage between Local and something like Amazon S3.
|
|
|
|
Intended to be used in tests, never in production.
|
|
|
|
## TESTING
|
|
|
|
I use Pyenv and Tox to support Python2.7.13 and Python3.6.3
|
|
|
|
```
|
|
pip install -r requirements-dev.txt
|
|
pyenv install 2.7.13 3.5.4 3.6.3
|
|
tox
|
|
```
|
|
|
|
Or you can run individually with your shell python using `python setup.py test`
|
|
|
|
## INSTALLATION
|
|
|
|
```
|
|
pip install django-dbfilestorage
|
|
```
|
|
|
|
Then in your project's `settings.py` file, add `'dbfilestorage'` to your `INSTALLED_APPS`:
|
|
|
|
```python
|
|
INSTALLED_APPS = (
|
|
...
|
|
'dbfilestorage'
|
|
)
|
|
```
|
|
|
|
Next, if you want to set this globally, set the setting:
|
|
|
|
```python
|
|
DEFAULT_FILE_STORAGE='dbfilestorage.storage.DBFileStorage'
|
|
```
|
|
|
|
Or you can set it individually on a field: [Django Docs](https://docs.djangoproject.com/en/1.10/ref/models/fields/#django.db.models.FileField.storage)
|
|
|
|
```python
|
|
from dbfilestorage.storage import DBFileStorage
|
|
|
|
class SomeClass(models.Model):
|
|
file = models.FileField(upload_to=u'anywhere',
|
|
storage=DBFileStorage())
|
|
```
|
|
|
|
|
|
## TODO
|
|
|
|
- Test that this works on a fake model, not just the storage file.
|
|
- Different django versions.
|
|
|
|
## Signing Key
|
|
You can find my signing key at [TyrelSouza.com](https://tyrelsouza.com/koken/?/pages/pgp-keys/)
|
|
|
|
I will sign everything with 0x769A1BC78A2DDEE2
|
|
|
|
## CHANGELOG
|
|
|
|
- 2018-02-01 [Tyrel Souza] Bump versions to django 1.11 and testing with Python3
|
|
- 2017-05-10 [Pamela McA'Nulty] Have save overwrite existing files
|
|
- 2017-02-06 [Tyrel Souza] Set primary key to `id` not `name`, this involves a lot of migrations, so I've kept them in multiple files
|
|
- 2017-01-27 [Tyrel Souza] Get rid of filehash
|
|
- 2017-01-26 [Tyrel Souza] Check filehash and filename, not just hash when checking if it needs to be saved.
|
|
- 2017-01-25 [Tyrel Souza] Keeping Filename on upload.
|
|
- 2017-01-23 [Tyrel Souza] Add Modified Time to storage support
|
|
- 2017-01-23 [Tyrel Souza] Everything should return a "filename" even if it's generated. Make the filename be the hash + ext. (fall back to .txt)
|
|
- 2017-01-20 [Tyrel Souza] Make path return None if no file
|
|
- 2017-01-20 [Tyrel Souza] Make path return filename
|
|
- 2017-01-20 [Tyrel Souza] Add another migration, and redo all the initial migrations.
|
|
- 2017-01-20 [Tyrel Souza] Make sure migrations is actually there.
|
|
- 2017-01-20 [Tyrel Souza] Split filename and filehash.
|
|
- 2016-12-09 [Tyrel Souza] Add signing key to readme.
|
|
- 2016-12-09 [Tyrel Souza] Update Tests, add some cleanup.
|
|
- 2016-12-08 [Tyrel Souza] Add more documentation.
|
|
- 2016-12-07 [Tyrel Souza] Update Readme, move to github, gitlab wasn't functioning properly.
|
|
- 2016-12-07 [Tyrel Souza] Initial commits and basic project setup
|