# django-s3-file-field
[](https://pypi.python.org/pypi/django-s3-file-field/)
`django-s3-file-field` is a Django widget library for uploading files directly to S3
(or MinIO) through the browser. django-s3-file-field heavily depends on the
[django-storages](https://github.com/jschneier/django-storages) package.
## Quickstart
Ensure you've configured your Django installation to use `django-storages` for S3 access: https://django-storages.readthedocs.io/en/latest/backends/amazon-S3.html.
Install the django-s3-file-field package:
```sh
pip install django-s3-file-field
```
Add `s3_file_field` to your `INSTALLED_APPS`:
```python
INSTALLED_APPS = [
...
's3_file_field',
]
```
Add the required settings:
```python
S3FF_UPLOAD_STS_ARN = '' # see STS Role section below (not required for minio)
```
Add the appropriate routes to `urls.py`:
```python
urlpatterns = [
...
path('api/s3-upload/', include('s3_file_field.urls')),
]
```
## Usage
```python
from s3_file_field import S3FileField
class Car(db.Model):
...
owners_manual = S3FileField()
```
## Running checks
django-s3-file-field can detect common misconfigurations using Django's built in [System check
framework](https://docs.djangoproject.com/en/3.0/topics/checks/). To confirm
your configuration is correct, run:
``` sh
./manage.py check
```
## Advanced Topics
### Advanced configuration
| Key | Default | Description |
| ------------------- | ---------------- | ------------------------------------------- |
| S3FF_UPLOAD_STS_ARN | none | ... |
#### STS configuration
#### CORS configuration
This is a minimal function CORS configuration for an S3 bucket to be compatible with django-s3-file-field:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedHeader>*</AllowedHeader>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>PUT</AllowedMethod>
<AllowedOrigin>*</AllowedOrigin>
<ExposeHeader>Connection</ExposeHeader>
<ExposeHeader>Content-Length</ExposeHeader>
<ExposeHeader>Date</ExposeHeader>
<ExposeHeader>ETag</ExposeHeader>
<ExposeHeader>Server</ExposeHeader>
<ExposeHeader>x-amz-delete-marker</ExposeHeader>
<ExposeHeader>x-amz-version-id</ExposeHeader>
<MaxAgeSeconds>600</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
```
Note: These are insecure defaults, the allowed origin and headers should not be a wildcard but instead
modified for your specific deployment(s).
### MinIO support
MinIO support depends on the django-minio-storage config (see https://django-minio-storage.readthedocs.io/en/latest/usage/), following settings are used
### Security considerations
### Integrating with forms
If you want to use an S3FileField in a form, some extra client code needs to be injected into your frontend.
The form submission only communicates with Django, so the web client has to somehow send that data directly to S3 before the form is submitted.
The necessary `<script>` is available in templates as `form.media`, which should be embedded into your form template similarly to this:
```
...
<head>
{{ form.media }}
</head>
...
```
The script will detect any S3FileFields being rendered in forms and dynamically rewrite them so that they upload data directly to S3 whenever a file is selected.
### Extending
django-s3-file-field sends out two signals when its REST api is called:
```python
s3_file_field_upload_prepare(name: str, object_key: str)
s3_file_field_upload_finalize(name: str, object_key: str, status: string)
```
### API Reference
django-s3-file-field-0.0.23.tar.gz （49个子文件） 
django-s3-file-field-0.0.23 
MANIFEST.in 250B PKG-INFO 6KB python-client pyproject.toml 160B tox.ini 379B s3_file_field_client __init__.py 3KB setup.py 1KB README.md 1KB pyproject.toml 471B s3_file_field _multipart_boto3.py 3KB _sizes.py 262B apps.py 739B _multipart.py 6KB _registry.py 1KB _multipart_minio.py 3KB checks.py 815B static s3_file_field widget.css.map 4KB widget.js.map 90KB widget.js 29KB widget.css 2KB __init__.py 260B signals.py 137B fields.py 4KB views.py 7KB widgets.py 4KB urls.py 370B rest_framework.py 841B forms.py 3KB javascript-client package.json 1KB package-lock.json 79KB src client.ts 5KB tsconfig.json 269B LICENSE 11KB DEVELOPMENT.md 864B setup.cfg 102B django_s3_file_field.egg-info PKG-INFO 6KB
requires.txt 106B SOURCES.txt 1KB top_level.txt 14B dependency_links.txt 1B setup.py 2KB build_js.py 4KB README.md 4KB widget package.json 2KB package-lock.json 340KB src style.scss 3KB widget.ts 416B S3FileInput.ts 5KB constants.ts 548B tsconfig.json 90B资源评论
挣扎的蓝藻
- 粉丝: 14w+
- 资源: 15万+
最新资源
- simulink 三机九节点系统风电调频，mppt运行下附有下垂控制和惯性控制，风电渗透率20%，带参考文献
- 西门子smart200plc与4台台达变频器modbus通讯 1，读写变频器的内部参数 2，控制变频器启停，读频率电流 3，设置变频器输出频率 4，有彩色接线图，和参数设置说明， 昆仑通泰触摸程序 有
- MATLAB环境下EMG信号降噪（去除心脏干扰）方法 算法运行环境为MAT;AB R2018a，执行MATLAB环境下EMG信号降噪（去除心脏干扰），采用概率自适应模板减法PATS，经验模态分解方法E
- 条形码检测 avt相机 halcon联合C++联合C#读条码源码 AVT的CCD相机飞拿采集图片，流水线上面运行，传感器感应条形码，相机采图，识别二维码，当读取二维码不联系后，开始通过串口控制输出点停
- 基于Windows.RTX64实时系统的仿真系统框架，用于分析工作时序(ns级)，系统动态分析，集采集、分析、处理等于一体的多功能系统 可搭载光纤卡，图像卡，高速A D等板卡
- Simulink集成外部C语言实现PID功能，与Simulink自带pid模块功能一致 可直接进行DSP28335等的代码生成，拖过来直接用，加快开发进度 下图三显示这6种方式达到了基本一致的效果
- 分布式驱动电动汽车LQR DYC 直接横摆力矩控制 最优 规则扭矩分配控制pid计算纵向扭矩需求， 上层lqr计算 下层最小附着利用率分配 扭矩分配 效果优良 稳定性控制 操纵稳定性 matlab
- 四轮独立驱动电动汽车的车辆状态估计，分别采用无迹卡尔曼，容积卡尔曼，高阶容积卡尔曼观测器等，可估计包括纵向速度，质心侧偏角，横摆角速度，以及四个车轮角速度七个状态 模型中第一个模块是四轮驱动电机用f
- 开发板STM32 三轴联动 带插补 加减速 源代码 MDK 源码 分别基于STM32F1和STM32F4两套的三轴联动插补(直线圆弧两种带)加减速的源码，基于国外写的脱机简易雕刻机源码的项目修改，添加
- 三相电压型PWM整流器+双向buck boost matlab仿真 电压电流双闭环控制 dq变 波形完美 ps：可代做仿真
- 基于固定400Hz正弦信号注入的在线搜索永磁同步电机MTPA自动追踪运行的仿真，考虑了电感的饱和以及电机参数的变化，不需要电机的具体参数便可以自动寻求到最佳MTPA工作点，模型采用离散化的方式运行，与
- 基恩士KV7500 程序 ~ 基恩士KV7500系列程序，KV7500+KV-C64X+KV-C64T等输入输出模块，KV-XH16EC定位控制模块 检测机程序 松下A6系列总线控制伺服电机和总
- IronPython-2.6.2-Src-Net20.zip
- Labview条码追踪系统JKI+ AMC结合的框架，扩展性强，适用于各种项目
- PFC单轴压缩代码，非均质模型，包括声发射，根据裂纹数截图同时输出应力和位移云图数据，拉剪裂纹等
- IronPython-2.6.2-Net20.msi
资源上传下载、课程学习等过程中有任何疑问或建议，欢迎提出宝贵意见哦~我们会及时处理！
点击此处反馈
