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

This version
History Node

0.2

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
DjangoS3Browser-0.2.tar.gz (392.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page