collectr 0.0.5

使用collectr

collectr是在boto库之上构建的一系列函数。这使得您可以按需将collectr集成到任何Python代码中。然而，对于那些想要“即用即得”解决方案的人来说，collectr还附带了一个示例脚本，非常适合与任何Django项目一起使用。

如果您想要简单，可以使用collectr如下所示

import collectr
collectr.update('path/to/static/files', 'bucket-name')

collectr将扫描目录，使用您系统上的任何工具压缩可以压缩的任何内容，并将所有文件上传到指定的S3存储桶。S3上已存在的任何内容都将保留其所有元数据。

当然，您可以有比这更多的控制。

import collectr
statics = collectr.StaticDir('path/to/static/files')
statics.input_directory = 'path/to/other/dir'
statics.minifier = 'yuicompressor -o {out_name} {in_name}'
statics.force_update = True
statics.ignore = ['.*\.jpg', '.*\.json']
statics.metadata = {'Cache-Control': 'max-age=3600'}
statics.update('bucket-name')

不过，在您做任何事情之前，请确保您已设置好环境变量。您需要将AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY设置为正确的值。

特性

• 静态文件压缩。

• 忽略过滤器。

• 多目录管理。

• 元数据管理。

安装

要安装collectr

$ pip install collectr

如果您没有 pip 并且无法安装，您应该向您的系统管理员投诉，然后执行以下操作：

$ easy_install collectr

贡献

collectr 欢迎贡献，包括错误修复和新功能。任何功能请求都应充分考虑对 API 的影响。API 清晰度高于新功能，因此任何使 API 复杂化的功能都必须为库增加显著价值才能被接受。

如果您想做出贡献，请执行以下操作：

1. 检查您的想法是否已经被提出。请检查 GitHub 上的所有 开放和关闭 问题。

2. 在 GitHub 上分叉存储库并做出您的更改。

3. 尽可能编写可以重现错误的测试，或可以测试新功能的测试。

4. 发送一个拉取请求。别忘了将您自己添加到 AUTHORS 文件中。

历史记录