Pontus 0.2.1

Signed POST request

Creating form fields for a signed Amazon S3 POST request

import boto
from flask import current_app
from pontus import AmazonS3SignedRequest

connection = boto.s3.connection.S3Connection(
    aws_access_key_id=current_app.config.get('AWS_ACCESS_KEY_ID'),
    aws_secret_access_key=current_app.config.get('AWS_SECRET_ACCESS_KEY')
)
bucket = connection.get_bucket('testbucket')

signed_request = AmazonS3SignedRequest(
    key_name=u'my/file.jpg',
    mime_type=u'image/jpeg',
    bucket=bucket,
)

signed_request.form_fields

# {
#     'AWSAccessKeyId': 'your-aws-access-key-id',
#     'success_action_status': '201',
#     'acl': 'public-read',
#     'key': u'f6c157e1-1a1a-4418-99fe-3362dcf7b1ea/images/my-image.jpg',
#     'Signature': 'generated-signature',
#     'Policy': 'generated-policy-document'
# }

These form fields can be used to POST files to Amazon S3 as described in Amazon’s documentation.

Amazon S3 file validation

Validating that an image file is less than 2MB and is of image/jpeg MIME type.

import boto
from flask import current_app
from pontus import AmazonS3FileValidator
from pontus.validators import FileSize, MimeType

connection = boto.s3.connection.S3Connection(
    aws_access_key_id=current_app.config.get('AWS_ACCESS_KEY_ID'),
    aws_secret_access_key=current_app.config.get('AWS_SECRET_ACCESS_KEY')
)
bucket = connection.get_bucket('testbucket')

validator = AmazonS3FileValidator(
    key_name='images/my-image.jpg',
    bucket=bucket,
    validators=[FileSize(max=2097152), MimeType('image/jpeg')]
)

if validator.validate():
    # File is <2MB image/jpeg
    pass
else:
    # File was invalid, printing errors
    print validator.errors

Validators can either be instances of a class inheriting pontus.validators.BaseValidator or callable functions that take one parameter key, which is a boto.s3.key.Key instance.

from pontus.exceptions import ValidationError
from pontus.validators import BaseValidator

def name_starts_with_images(key):
    if not key.name.startswith('images/'):
        raise ValidationError()

# OR

class NameStartsWith(BaseValidator):
    def __init__(self, starts_with_str):
        self.starts_with_str = starts_with_str

    def __call__(self, key):
        if not key.name.startswith(starts_with_str):
            raise ValidationError()

name_starts_with_images = NameStartsWith('images/')