uploadcare.com的python库
pyuploadcare的Python项目详细描述
pyuploadcare:用于uploadcare的python库
简单的网络文件上传是最重要的 对于我们,请访问http://uploadcare.com/?utm_source=github&utm_campaign=pyuploadcare" rel="nofollow">上传服务。今天,每个人都习惯了 允许用户上传照片或附加简历。例行公事 包括:安装图像处理库,调整权限, 确保服务器永不停机,并启用CDN。 从Facebook上传或手动裁剪等功能都很重要, 因此罕见。 我们的目标是改变现状。
这个库由 uploadcare api接口和一些 我的朋友。您可能还想查看这个 指南 为 一个起点。
简单地说,uploadcare imagefield 可以添加到 现有的django项目只需几个简单的步骤。 这将使您的用户能够查看上载进度,选择文件 从google drive或instagram,在文件处于 正在异步上载。
fromdjangoimportformsfromdjango.dbimportmodelsfrompyuploadcare.dj.modelsimportImageFieldfrompyuploadcare.dj.formsimportFileWidgetclassCandidate(models.Model):photo=ImageField(blank=True,manual_crop="")# optional. provide advanced widget options: https://uploadcare.com/docs/uploads/widget/config/#optionsclassCandidateForm(forms.Form):photo=ImageField(widget=FileWidget(attrs={'data-cdn-base':'https://cdn.super-candidates.com','data-image-shrink':'1024x1024',}))
功能
- uploadcare的python包装器 rest 和 上传 api。
- Django小部件,具有有用的手动裁剪和多个上载功能。
- ucare 控制台实用程序。
- 托管资产(对 s_awek ehlert !)
要求
pyuploadcare 需要python 2.7、3.4、3.5、3.6、3.7。
如果您对django使用 pyuploadcare ,请检查 .travis.yml 是否支持 python-django组合。
官方不支持过时的python和django版本,但很可能 一切都还顺利吗?如果必须使用,请修改tox.ini,test和 自行承担风险;)或者,您可以使用旧版本的库。
安装
要安装pyuploadcare,只需运行:
$ pip install pyuploadcare
或者,如果您喜欢旧的方式:
$ easy_install pyuploadcare
测试
除了travis ci之外,我们还使用tox。为了运行测试,只需:
$ pip install tox $ tox
安全问题
如果你认为你在uploadcare库中遇到了一些可能 安全问题,请访问 bugboundant @ uploadcare com 或哈克龙。
我们会在短时间内亲自联系您,通过合作和 在任何公开披露之前。
反馈
欢迎提出问题和减贫战略。你可以提供你的反馈或者给我们一个支持 在 hello @ uploadcare com 请求。
历史记录
此项目的所有显著更改都将记录在此文件中。
格式基于保持变更日志 这个项目遵循语义版本控制。
2.4.0
-
更改"用户代理"请求头中的数据格式。
2.3.0
-
添加对django版本1.11和~2.0的支持
-
杂项更新(版本、许可文件中的年份、tox配置等)
-
放弃对过时的python和django版本的官方支持。
很可能一切都还顺利。如果必须使用它们,请修改
tox.ini
,
运行测试并自行承担使用风险;)或者,您可以使用旧版本的库。
2.2.1
-
添加
文件。创建本地拷贝
和
文件。创建远程拷贝
方法。
-
向file.create_remote_copy方法添加新的
make_public
和
模式参数。
-
将新的存储参数添加到file.create_local_copy methods。
-
更新小部件的CDN链接。
-
使用通配符
2.x
总是获取最新的
widget版本
2
的补丁或次要版本。请参见小部件更改日志
-
将捆绑小部件更新到版本
2.10.3
。请参见小部件更改日志
2.1.0
-
支持上传请求中的自动存储
-
已将小部件更新到2.10.0版(请参见小部件更改日志。
-
放弃对Python3.2的支持
-
简化和减少
中的测试矩阵。travis.yml
2.0.1
-
修复了缺少ucare cli的问题。
2
-
增加了对rest api版本0.5的支持。
-
已将小部件更新到2.8.1版(请参见小部件更改日志。
-
添加了ucare list_groups命令。
-
已删除不推荐的实体。
nb
:存在向后不兼容的更改。有关升级过程的详细信息,请参见更新到2.0版。
1.3.6
-
修复了尝试同步无大小文件时出现的零除错误
1.3.5
- 增加了对django 1.9的支持
已从ucare的输出中删除unicode字符串的指示
-
修复了
ucare create_group
命令的组表示形式 - 修复了尝试处理非图像文件时的ucare sync错误
1.3.4
- 添加了存储操作
- 向ucare cli添加了请求限制
1.3.3
- 扩展用户代理
1.2.11
- 修复复制请求的"源"组合
- 让我们通过限制的conf.retry来配置默认的限制重试计数
1.2.10
- 处理head和option请求的响应
- 将小部件更新到1.4.6
1.2.9
- 与Django 1.7兼容
1.2.8
- 将小部件更新到1.4.0
1.2.7
- 处理rest api限制
1.2.6
- 将小部件更新到1.2.3
- 修复了与六库版本1.7.0及更高版本的兼容性
1.2.5
- 修复了设置脚本
1.2.4
- 将小部件更新到1.0.1
- 修复了响应包含Unicode字符时的日志记录问题
1.2.3
- 将小部件更新到0.17.1
1.2.2
- 添加file.copy()
- 向UploadCareException添加数据属性
- 将小部件更新到0.13.2
- 更新pyuploadcare.dj.models.imagefield crop validation
1.2.1
https://ucarecdn.com/ 返回URL以服务小部件的资产。
1.2
- cdn url已更改为http://www.ucarecdn.com/ 。以前的URL https://ucarecdn.com/ 已清除。
- 小部件更新到 0.10.1
1.1
- 小部件更新到 0.10
- 默认的api版本更新到 0.3
- Django设置已合并到UploadCare字典中。
- 通过重用请求的会话,性能得到了提高。
1.0.2
UnicodedeCoderror 已修复。当 请求 's 方法 param是unicode并且 requests.request() 得到 个文件 参数,例如:
>>>requests.request(u'post',u'http://httpbin.org/post',...files={u'file':open('README.rst','rb')})UnicodeDecodeError:'ascii'codeccan't decode byte 0xc5 ...
1.0.1
小部件更新到 0.8.1.2
它正在调用 模型实例保存,例如:
photo.title='new title'photo.save()
现在它在按窗体保存时发生,即通过调用 您的_model_form.is_valid() 。还有别的东西可以触发 存储–直接调用photo.full_clean()。
1
- 增加了Python3.2和3.3支持。
- 已添加文件组创建。
- 文件、文件组的每个API字段的方法已添加。
- 已删除不推荐的内容。此版本不向后兼容。 有关详细信息,请参见 https://pyuploadcare.readthedocs.org/en/v0.19/deprecated.html
0.19
- 已添加多重上载支持。
- argparse 被添加到 setup.py 需求中。
- 文档已添加并发布在https://pyuploadcare.readthedocs.org" rel="nofollow">https://pyuploadcare.readthedocs.org
0.18
- 小部件更新到 0.6.9.1
0.17
- 添加了imagefield 。它只提供上传图像文件。此外, 您可以激活手动裁剪,例如 imagefield(手动裁剪='2:3')
- 添加了更合适的例外。
- 测试从库中分离出来并重新构造。
- 小部件更新到 0.6.7
- 文件字段 的 空白 , 空属性的问题已得到解决。
0.14
- 替换旧API版本的接受头
0.13
- 修复字段呈现的Unicode问题
0.12
- 向pyuploadcare.dj添加新小部件
- 删除旧窗口小部件
- 对所有请求使用https
0.11
- 将cdn_base添加到ucare中。
- 摆脱API V.0.1支持
- 添加file.sure_on_s3和file.sure_on_cdn帮助程序
- add file properties is_on_s3,is_removed,is_stored
- 修复URL构造
- 添加并更正等待上传和从URL上传的内容
0.10
- 向ucare添加控制台日志处理程序
- 向ucare store和delete命令添加wait参数
- 修复ucare arg处理
0.9
- 通过url命令向ucare upload和upload添加一组参数
- 修复uploadedfile.wait()
0.8
- 修复旧API的文件存储
- 用授权替换身份验证标题
- 在http头中找到日志警告
- 用新的CDN替换旧的大小调整器
- 添加verify_api_ssl、verify_upload_ssl选项
- 向api添加自定义http头并上载api请求
0.7
- 添加了uuu版本
- 添加了"用户代理"请求头
- 添加了"accept"请求头
- 添加了ucare配置文件分析
- 添加了pyuploadcare/tests.py
- 已替换上载API
- 已将file.keep替换为file.store,不推荐使用file.keep
- file.store使用新的PUT请求
- 在file.store、file.delete中添加了超时
- 添加了从uURL向ucare上载和上载uU的功能
- 在安装过程中添加了测试
- 用请求替换httplib,支持https(验证api请求的证书)
- 向UploadCare添加了API_版本arg,默认值为0.2
0.6
- 添加了ucare cli实用程序
- 添加了PyUploadCare上载库URL设置
- 添加了pyuploadcare小部件url
-
更新了0.0.1版的小部件资产
制成的以下pyuploadcare.file.file方法的属性:
- api_uri()
- url()
- filename()
- 已更改PyUploadCare。UploadCareException.\uu init\uu