Metadata-Version: 1.1
Name: django-oss-storage
Version: 1.1.0
Summary: Django Aliyun OSS (Object Storage Service) storage
Home-page: https://www.aliyun.com/product/oss
Author: UNKNOWN
Author-email: UNKNOWN
License: UNKNOWN
Description-Content-Type: UNKNOWN
Description: Django AliCloud OSS Storage
        =========================
        
        **django-oss-storage** provides a Django AliCloud OSS file storage.
        
        
        Features
        ========
        
        - Django file storage for AliCloud OSS
        - Django static file storage for AliCloud OSS
        - Works in Python 2 & 3
        
        Installation
        ============
        
        * Install
        
        .. code-block:: bash
        
            $ pip install django-oss-storage
        
        - Add ``'django_oss_storage'`` to your ``INSTALLED_APPS`` setting
        - Set your ``DEFAULT_FILE_STORAGE`` setting to ``"django_oss_storage.backends.OssMediaStorage"``
        - Set your ``STATICFILES_STORAGE`` setting to ``"django_oss_storage.backends.OssStaticStorage"``
        - Configure your AliCloud OSS settings (Refer below).
        
        Use the following settings for file storage.
        
        .. code-block:: bash
        
            STATICFILES_STORAGE = 'django_oss_storage.backends.OssStaticStorage'
        
            DEFAULT_FILE_STORAGE = 'django_oss_storage.backends.OssMediaStorage'
        
        Authentication settings
        =======================
        
        Use the following settings to authenticate with AliCloud OSS.
        
        .. code-block:: bash
        
            # AliCloud access key ID
            OSS_ACCESS_KEY_ID = <Your Access Key ID>
        
            # AliCloud access key secret
            OSS_ACCESS_KEY_SECRET = <Your Access Key Secret>
        
        File storage settings
        =====================
        
        Use the following settings to configure AliCloud OSS file storage.
        
        .. code-block:: bash
        
            # The name of the bucket to store files in
            OSS_BUCKET_NAME = <Your bucket name>
        
            # The URL of AliCloud OSS endpoint
            # Refer https://www.alibabacloud.com/help/zh/doc-detail/31837.htm for OSS Region & Endpoint
            OSS_ENDPOINT = <Your access endpoint>
        
            # The default location for your files
            MEDIA_URL = '/media/'
        
        Staticfiles storage settings
        ============================
        
        All of the file storage settings are available for the staticfiles storage.
        
        .. code-block:: bash
        
            # The default location for your static files
            STATIC_URL = '/static/'
        
        staticfiles provides command 'collectstatic'. Run following command to collect all sub-folder 'static' of each app
        and upload to STATIC_URL.
        
        .. code-block:: bash
        
            $ python manage.py collectstatic
        
        
        Testing
        =======
        
        First set the required AccessKeyId, AccessKeySecret, endpoint and bucket information for the test through environment variables (**Do not use the bucket for the production environment**).
        Take the Linux system for example:
        
        .. code-block:: bash
        
            $ export OSS_ACCESS_KEY_ID=<AccessKeyId>
            $ export OSS_ACCESS_KEY_SECRET=<AccessKeySecret>
            $ export OSS_BUCKET_NAME=<bucket>
            $ export OSS_ENDPOINT=<endpoint>
        
        Support and announcements
        =========================
        
        Downloads and bug tracking can be found at the `main project website <http://github.com/aliyun/django-oss-storage>`_.
        
        License
        =======
        
        - `MIT <https://github.com/aliyun/django-oss-storage/blob/master/LICENSE>`_.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
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.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Framework :: Django
