Metadata-Version: 2.0
Name: django-gstorage
Version: 0.5.1
Summary: Allow easy integration with Google storage for Django projects
Home-page: http://github.com/fyndiq/django-gstorage/
Author: Pradip Caulagi
Author-email: caulagi@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.7
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Django
Requires-Dist: gcloud

django-gstorage
===============

.. image:: https://img.shields.io/pypi/v/django-gstorage.svg
   :alt: PyPi page
   :target: https://pypi.python.org/pypi/django-gstorage

.. image:: https://travis-ci.org/fyndiq/django-gstorage.svg?branch=master
    :alt: Travis CI Status
    :target: https://travis-ci.org/fyndiq/django-gstorage

.. image:: https://coveralls.io/repos/github/fyndiq/django-gstorage/badge.svg?branch=master
   :alt: Coverage status
   :target: https://coveralls.io/github/fyndiq/django-gstorage?branch=master

.. image:: https://readthedocs.org/projects/django-gstorage/badge/?version=latest&style=flat
   :alt: ReadTheDocs
   :target: https://django-gstorage.readthedocs.io/en/latest/

.. image:: https://img.shields.io/badge/license-MIT-blue.svg
   :alt: License MIT
   :target: https://github.com/fyndiq/django-gstorage/blob/master/LICENSE


This library is intended to be a 'plug-and-play' replacement
for `django.core.files.storage.FileSystemStorage` but reading
and writing files from Google storage. So there are two goals -

- It should be possible to use this library in projects already
  using local filesystem but which want to start using Google storage.
  In this case, we read from Google storage but if that fails, read
  from local filesystem and also update Google storage.

- Make it simpler to use newer features of Google storage like
  encrypting files with sensitive information

  .. code-block:: python

	order_pdf = FileField(encrypted=True)

Examples
++++++++

Using the module to upload some files

.. code-block:: python

    >>> from gstorage.bucket import Bucket

    >>> bucket = Bucket.get_default()
    >>> bucket.copydir('share/storage/2016/10/01')


.. :changelog:

Release history
---------------

0.5.1 (2016-11-04)
++++++++++++++++++++++

- ``gstorage.storage.Storage`` implements the interface expected from
  ``django.core.files.storage.Storage``.  The only **supported interface**
  at this point is ``storage._save``, and other methods are experimental.
- Support Python 3.4 for new Django (1.9 and 1.10)
- Added an example project showing use of django-gstorage

0.4.1 (2016-10-30)
++++++++++++++++++

- Updated docstrings to sphinx style
- Added documentation for gstorage.utils

0.4.0 (2016-10-30)
++++++++++++++++++

**Features**

- Refactored tests and added seperate test files for each module.
- Updated documentation on readthedocs.io to include section about
  bucket.

0.3.0 (2016-10-28)
++++++++++++++++++

**Features**

- ``gstorage.bucket.Bucket.get_default`` allowing easy access to
  default bucket.
- ``gstorage.bucket.Bucket.copydir`` allowing easy upload of files
  to Google cloud.


