{
"info": {
"author": "Johannes Hoppe",
"author_email": "info@johanneshoppe.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 6 - Mature",
"Environment :: Web Environment",
"Framework :: Django",
"Framework :: Django :: 1.11",
"Framework :: Django :: 2.2",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7",
"Programming Language :: Python :: 3 :: Only",
"Topic :: Software Development"
],
"description": "=============\ndjango-s3file\n=============\n\nA lightweight file upload input for Django and Amazon S3.\n\nDjango-S3File allows you to upload files directly AWS S3 effectively\nbypassing your application server. This allows you to avoid long running\nrequests from large file uploads. This is particularly helpful for if\nyou run your service on AWS Lambda or Heroku where you have a hard request\nlimit.\n\n|PyPi Version| |Build Status| |Test Coverage| |GitHub license|\n\n--------\nFeatures\n--------\n\n- lightweight: less 200 lines\n- no JavaScript or Python dependencies (no jQuery)\n- easy integration\n- works just like the built-in\n- extendable JavaScript API\n\n-------------\nFor the Nerds\n-------------\n\n.. image:: http-message-flow.svg\n\n------------\nInstallation\n------------\n\nMake sure you have `Amazon S3 storage`_ setup correctly.\n\nJust install S3file using ``pip``.\n\n.. code:: bash\n\n pip install django-s3file\n # or\n pipenv install django-s3file\n\nAdd the S3File app and middleware in your settings:\n\n.. code:: python\n\n\n INSTALLED_APPS = (\n '...',\n 's3file',\n '...',\n )\n\n MIDDLEWARE = (\n '...',\n 's3file.middleware.S3FileMiddleware',\n '...',\n )\n\n-----\nUsage\n-----\n\nS3File automatically replaces Django\u2019s ``ClearableFileInput`` widget,\nyou do not need to alter your code at all.\n\nThe ``ClearableFileInput`` widget is only than automatically replaced\nwhen the ``DEFAULT_FILE_STORAGE`` setting is set to\n``django-storages``\\ \u2019 ``S3Boto3Storage``.\n\nSetting up the AWS S3 bucket\n----------------------------\n\nUpload folder\n~~~~~~~~~~~~~\n\nS3File uploads to a single folder. Files are later moved by Django when\nthey are saved to the ``upload_to`` location.\n\nIt is recommended to `setup expiration`_ for that folder, to ensure that\nold and unused file uploads don\u2019t add up and produce costs.\n\nThe default folder name is: ``tmp/s3file`` You can change it by changing\nthe ``S3FILE_UPLOAD_PATH`` setting.\n\nCORS policy\n~~~~~~~~~~~\n\nYou will need to allow ``POST`` from all origins. Just add the following\nto your CORS policy.\n\n.. code:: xml\n\n