Skip to main content

Field types for allowing file and image uploads to Amazon S3 (as well as default local storage) in Flask-Admin.

Example

For a complete, working Flask app that demonstrates flask-admin-s3-upload in action, have a look at flask-s3-save-example.

Usage

Use with a Flask-Admin ModelView by overriding field types, and by passing in special arguments to those fields:

from flask.ext.admin.contrib.sqla import ModelView

class MyView(ModelView):
    form_overrides = dict(
        some_image=S3ImageUploadField,
        some_file=S3FileUploadField)

    form_args = dict(
        some_image=dict(
            base_path='/some/folder/static',
            relative_path='some_image/',
            url_relative_path='uploads/',
            namegen=your_namegen_func_here,
            storage_type_field='some_image_storage_type',
            bucket_name_field='some_image_storage_bucket_name',
        ),
        some_file=dict(
            base_path='/some/folder/static',
            relative_path='some_file/',
            namegen=your_namegen_func_here,
            allowed_extensions=('pdf', 'txt'),
            storage_type_field='some_file_storage_type',
            bucket_name_field='some_file_storage_bucket_name',
        ))

    def scaffold_form(self):
        # Note: assuming that we have Flask-S3 config values to pass
        # to fields below. Flask-S3 is not required, you can pass
        # values from elsewhere if you want.
        from flask import current_app as app

        form_class = super(MyView, self).scaffold_form()
        static_root_parent = '/some/folder'

        if app.config['USE_S3']:
            form_class.some_image.kwargs['storage_type'] = 's3'
            form_class.some_file.kwargs['storage_type'] = 's3'

        form_class.some_image.kwargs['bucket_name'] = app.config['S3_BUCKET_NAME']
        form_class.some_image.kwargs['access_key_id'] = app.config['AWS_ACCESS_KEY_ID']
        form_class.some_image.kwargs['access_key_secret'] = app.config['AWS_SECRET_ACCESS_KEY']
        form_class.some_image.kwargs['static_root_parent'] = static_root_parent

        form_class.some_file.kwargs['bucket_name'] = app.config['S3_BUCKET_NAME']
        form_class.some_file.kwargs['access_key_id'] = app.config['AWS_ACCESS_KEY_ID']
        form_class.some_file.kwargs['access_key_secret'] = app.config['AWS_SECRET_ACCESS_KEY']
        form_class.some_file.kwargs['static_root_parent'] = static_root_parent

        return form_class

Release files for flask-admin-s3-upload 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for flask-admin-s3-upload 0.1.4
File Interpreter ABI Platform
flask_admin_s3_upload-0.1.4-py2.py3-none-any.whl Python 3, Python 2 none any Details

Release files / flask_admin_s3_upload-0.1.4-py2.py3-none-any.whl

Download URL flask_admin_s3_upload-0.1.4-py2.py3-none-any.whl
Size 6.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
7e38620dc84eaba2a21c8d1ec67acca1d4ab953d80c62c2c76733a18e2cda959
BLAKE2b-256 checksum
How to use checksums
77691c10570cd2908513baaa640524f5c67420bbd7cb3d672efed88418803cb6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.4 This release

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page