README.md

django-s3-policy-sync

If your Django project relies on S3, for instance, file storage in S3, S3 policies can be a pain to manage.

django-s3-policy-sync provides a solution to put S3 policies under source control.

Install django-s3-policy-sync

$ pip django-s3-policy-sync

Set up django-s3-policy-sync

Add s3_policy_sync.middleware.S3PolicySyncMiddleware to your MIDDLEWARE_CLASSES.

For example:

MIDDLEWARE_CLASSES = (
    ...,
    's3_policy_sync.middleware.S3PolicySyncMiddleware',
    ...,
)

Configure 2 variables S3_POLICY_DIR and S3_BUCKETS

For example:

S3_POLICY_DIR = os.path.join(BASE_DIR, 'settings', 's3_policies')
S3_BUCKETS = (S3_MEDIA_BUCKET, S3_PRIVATE_BUCKET)

Put S3 policies in files named after the corresponding buckets. For example, the policy for bucket your_bucket should go in file S3_POLICY_DIR/your_bucket

Relaunch your django server and your S3 policies will be refreshed!

Questions and issues

Email me with any questions: [email protected].