Skip to main content

S3 browser for django

Project description

Django S3 File Browser
============


:Info: S3 File Browser For Django.
:Author: Mehmet KAYKISIZ (http://github.com/mkaykisiz)


Django S3 File Browser is a simple web-based object browser for cloud-based blob datastores. Just add as an application
to a Django project, add some settings, and you'll be able to browse cloud containers and implied subdirectories, as
well as view / download objects.


Be sure to check out the following project resources:

* `GitHub page`_.

.. _`GitHub page`: https://github.com/mkaykisiz/DjangoS3Browser
.. toc


Quick Start
-----------
First, download library:

.. code-block:: sh


pip install djangoS3Browser


Then, make the necessary configurations for the `Boto 3 <https://github.com/boto/boto3>`_ library:

.. code-block:: python


AWS_ACCESS_KEY_ID = "AWS_ACCESS_KEY_ID"
AWS_SECRET_ACCESS_KEY = "AWS_SECRET_ACCESS_KEY"
AWS_STORAGE_BUCKET_NAME = "AWS_STORAGE_BUCKET_NAME"
AWS_AUTO_CREATE_BUCKET = True
AWS_QUERYSTRING_AUTH = False


# AWS cache settings, don't change unless you know what you're doing:
AWS_EXPIRY = 60 * 60 * 24 * 7

# Revert the following and use str after the above-mentioned bug is fixed in
# either django-storage-redux or boto
control = 'max-age=%d, s-maxage=%d, must-revalidate' % (AWS_EXPIRY, AWS_EXPIRY)
AWS_HEADERS = {
'Cache-Control': bytes(control, encoding='latin-1')
}


Next, do to Django S3 File Browser configuration:

.. code-block:: python


S3_BROWSER_SETTINGS = "djangoS3Browser"


Next, add to TEMPLATES['OPTIONS'] in settings.py:

.. code-block:: python


'libraries': {
's3-load': 'djangoS3Browser.templatetags.s3-tags',
},


Then, add to urls.py:

.. code-block:: python


url(r'^' + settings.S3_BROWSER_SETTINGS + '/', include('djangoS3Browser.s3_browser.urls')),


Then, add this to the top of the page you want to add:

.. code-block:: python


{% load s3-tags %}


Finally, add this to the content of the page you want to add:

.. code-block:: python


{% load_s3 %}



.. image:: https://user-images.githubusercontent.com/5642113/30087574-225e38a8-92aa-11e7-8bf4-4da7a5048812.png

Project details


Release history Release notifications | RSS feed

This version

0.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for DjangoS3Browser, version 0.2
Filename, size File type Python version Upload date Hashes
Filename, size DjangoS3Browser-0.2.tar.gz (392.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page