django-cloud-storage 1.0.7

Custom storage backend tailored for a proprietary cloud storage service.

Django Cloud Storage

Django Cloud Storage is a Python package that provides a custom storage backend designed for seamless integration with proprietary cloud storage service.

Installation

pip install django-cloud-storage

Configuration

In your Django settings file, set the following values:

CLOUD_STORAGE_URL = 'https://your-cloud-service.com'
CLOUD_STORAGE_API_TOKEN = 'your-api-token'
CLOUD_STORAGE_PROJECT_ALIAS = 'myproject'

Optional settings

Setting	Default	Description
CLOUD_STORAGE_VERIFY	True	TLS verification, passed to Requests: use False only for local development with self-signed certificates, or a string path to a CA bundle for private CAs.
CLOUD_STORAGE_TIMEOUT	30	Request timeout in seconds (or a (connect, read) tuple as supported by Requests).

The client reuses HTTP connections via a requests.Session, and opening a file for reading ('rb' / 'r') performs a single download instead of a separate existence check followed by a read.

Security: Setting CLOUD_STORAGE_VERIFY = False disables certificate validation and exposes you to man-in-the-middle attacks. Prefer installing your CA or pointing CLOUD_STORAGE_VERIFY at a PEM bundle when using internal certificate authorities.

# Example: internal CA (recommended over verify=False)
CLOUD_STORAGE_VERIFY = '/etc/ssl/certs/my-org-ca.pem'

# Example: local dev only (insecure)
CLOUD_STORAGE_VERIFY = False

Usage

To integrate the Cloud Storage with a Django model, follow these steps:

• Import the required models and CloudStorage:

  from django_cloud_storage.storage import CloudStorage
  

• Define your Django model, using CloudStorage as the storage backend for a FileField:

  class MyModel(models.Model):
      file_field = models.FileField(storage=CloudStorage)
  
      def __str__(self):
          return self.file_field.name