django-smuggler 1.0.4

安装和设置

Smuggler 在 Python 包索引 (PyPI) 上，您可以使用工具 pip 或 easy_install 轻松安装最新稳定版本。试试

pip install django-smuggler

或者

easy_install django-smuggler

另外，您可以从源代码安装 Smuggler，在包含 setup.py 文件的目录中运行以下命令

python setup.py install

安装后，您需要配置项目以识别 Smuggler 应用程序，将 'smuggler' 添加到您的 INSTALLED_APPS 设置中，并设置项目的 URLConf 如下所示

urlpatterns = [
    # ...
    path('admin/', include('smuggler.urls')),  # before admin url patterns!
    path('admin/', admin.site.urls),
]

然后尝试访问以下 URL

• /admin/load/，从上传的文件或 SMUGGLER_FIXTURE_DIR 上的文件加载数据；

• /admin/dump/，从整个项目下载数据；

  您也可以传递一个查询字符串，如 /admin/dump/?app_label=flatpages,auth,yourapp.model，以指定必须导出的内容。

• /admin/APP_LABEL/dump/，从应用程序下载数据；

• /admin/APP_LABEL/MODEL_LABEL/dump/，从模型下载数据；

如果可以访问上述 URL，则应用程序已正确设置。请注意，这些 URL 仅对超级用户可访问。

Smuggler 还提供了一个模板，可以在更改列表页面 (change_list.html) 上显示导出和加载数据的按钮。您可以按以下方式设置您感兴趣的 ModelAdmin

class ExampleAdmin(admin.ModelAdmin):
    change_list_template = 'smuggler/change_list.html'
    ...

屏幕截图

change_list.html 中的按钮

加载表单（已配置 SMUGGLER_FIXTURE_DIR）

发布说明

向后不兼容的更改

• 删除了 AdminFormMixin（版本 0.7）

• 删除了 signals.py（版本 0.6）

• 将 urls 重命名为 import/export 为 load/dump（版本 0.1）

贡献

如果您在代码或文档中发现问题，请花 30 秒钟填写一个问题。

对代码或翻译的贡献将受到高度赞赏。请随意分支或发送补丁。

您可以使用 Transifex 将此应用程序翻译成您的语言。访问Transifex 上的项目页面。

有关此应用程序的完整作者列表，请参阅 AUTHORS 文件。

感谢互动联盟赞助项目的第一个版本。

测试

如果您正在为 django-smuggler 贡献，我们建议设置一个 virtualenv 并运行

pip install -r test-requirements.txt

然后您可以使用以下命令运行测试

make tests

在提交拉取请求之前，请通过运行以下命令测试我们的支持的 Python 和 Django 版本

tox

要查看是否需要添加测试，我们使用 coverage。您可以使用以下命令生成覆盖率报告

make coverage

要检查您的代码是否遵循风格指南，您可以运行

make lint

复制条件

Django Smuggler 是免费软件；您可以在自由软件基金会发布的GNU 较小通用公共许可证的条款下重新分发和/或修改它；许可证的第 3 版，或者（根据您的选择）任何较新版本。

Django Smuggler 的分发是希望它将是有用的，但没有任何保证；甚至没有关于其商售性或适用于特定目的的暗示性保证。有关更多信息，请参阅 GNU 较小通用公共许可证。

您应该已经收到一份 GNU 较小通用公共许可证的副本，与该程序一起；请参阅 COPYING.LESSER 文件。如果没有，请参阅https://gnu.ac.cn/licenses/。