PyPI - django-simpletask5 - Versions diffs - 0.1.3__tar.gz → 0.1.4__tar.gz - Mend

django-simpletask5 0.1.3tar.gz → 0.1.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (50) hide show

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-simpletask5
-Version: 0.1.3
+Version: 0.1.4
 Summary: Lightweight async task execution framework for Django
 Author-email: rRR0VrFP <rrr0vrfp@qq.com>
 Maintainer-email: rRR0VrFP <rrr0vrfp@qq.com>
@@ -27,6 +27,8 @@ Requires-Dist: globallock>=0.1.4
 Requires-Dist: django-safe-fields>=0.2.3
 Requires-Dist: django-app-requires>=0.3.6
 Requires-Dist: django-admin-dashboards>=0.1.1
+Requires-Dist: django-checkbox-normalize>=0.2.2
+Requires-Dist: django-tabbed-changeform-admin>=0.1.9
 Requires-Dist: cryptography>=48.0.0
 Requires-Dist: croniter>=6.2.2
 Requires-Dist: requests>=2.34.2
@@ -104,6 +106,87 @@ DJANGO_SIMPLETASK_LOCK_CONFIG = {
 python manage.py migrate django_simpletask5
 ```
+## 配置说明
+所有配置项均为可选，设有合理的默认值。以下按功能分类说明。
+### 消息队列（MQ）
+默认使用内存队列（`memory://`），适合开发调试。生产环境建议切换为 RabbitMQ 或 Redis。
+```python
+# 方式一：直接指定完整 Broker URL（优先级最高）
+DJANGO_SIMPLETASK_BROKER_URL = 'amqp://guest:guest@127.0.0.1:5672//'
+# 方式二：分别指定类型和连接参数
+DJANGO_SIMPLETASK_MESSAGE_QUEUE_TYPE = 'rabbitmq'  # 'memory' | 'rabbitmq' | 'redis'
+DJANGO_SIMPLETASK_RABBITMQ_HOST = '127.0.0.1'
+DJANGO_SIMPLETASK_RABBITMQ_PORT = 5672
+DJANGO_SIMPLETASK_RABBITMQ_USER = 'guest'
+DJANGO_SIMPLETASK_RABBITMQ_PASSWORD = 'guest'
+# Redis 作为 MQ 时：
+# DJANGO_SIMPLETASK_MESSAGE_QUEUE_TYPE = 'redis'
+# DJANGO_SIMPLETASK_REDIS_MQ_HOST = '127.0.0.1'
+# DJANGO_SIMPLETASK_REDIS_MQ_PORT = 6379
+# DJANGO_SIMPLETASK_REDIS_MQ_DB = 0
+```
+### 分布式锁
+```python
+DJANGO_SIMPLETASK_LOCK_CONFIG = {
+    'global_lock_engine_class': 'globallock.redis_global_lock.RedisGlobalLock',
+    'global_lock_engine_options': {
+        'host': '127.0.0.1',
+        'port': 6379,
+        'db': 0,
+    },
+}
+DJANGO_SIMPLETASK_LOCK_TIMEOUT = 600  # 锁超时时间（秒）
+```
+### 队列路由
+```python
+DJANGO_SIMPLETASK_DEFAULT_QUEUE = 'django_simpletask5.queue.default'          # 默认队列
+DJANGO_SIMPLETASK_HIGH_PRIORITY_QUEUE = 'django_simpletask5.queue.high_priority'  # 高优先级队列
+```
+### 执行与重试
+```python
+DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES = 3        # 默认最大重试次数
+DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS = 600  # 默认执行超时时间（秒）
+```
+### 归档
+```python
+DJANGO_SIMPLETASK_ARCHIVE_PATH = 'django_simpletask5_archives'  # 归档文件存储子目录
+DJANGO_SIMPLETASK_ARCHIVE_SALT = 'django-simpletask5-archive'   # 归档加密盐值（结合 SECRET_KEY 派生 AES 密钥）
+DJANGO_SIMPLETASK_ARCHIVE_RETENTION_DAYS = 7                    # 归档保留天数
+```
+### Cron
+```python
+DJANGO_SIMPLETASK_CRONJOB_AUTO_SYNC = True  # 是否自动将代码注册的 Cron 同步到数据库
+```
+### 安全
+```python
+# 脚本执行白名单（空列表表示不限制）
+DJANGO_SIMPLETASK_SCRIPT_WHITELIST = ['/path/to/allowed/scripts']
+# 自定义字段加密（默认使用 django-safe-fields 的默认加密）
+DJANGO_SIMPLETASK_FIELD_CIPHER_CLASS = None                              # 自定义加密器类
+DJANGO_SIMPLETASK_RESULT_PASSWORD = None     # 执行结果加密密码
+DJANGO_SIMPLETASK_ERROR_MSG_PASSWORD = None  # 错误信息加密密码
+DJANGO_SIMPLETASK_CONTEXT_PASSWORD = None    # 上下文数据加密密码
+```
 ## 快速开始
 ### 1. 定义任务模型
@@ -232,6 +315,12 @@ Worker 消费消息 → 获取分布式锁 → 加载执行器 → 执行并保
 ## Releases
+### 0.1.4
+- **修复打包** — `pyproject.toml` 添加 `package-data` 配置，打包时包含 locale po/mo 文件，修复 i18n 翻译不生效的问题
+- **补充依赖** — `requirements.txt` 和 `pyproject.toml` 添加缺失的 `django-checkbox-normalize`、`django-tabbed-changeform-admin` 依赖
+- **完善文档** — README 新增完整配置说明章节，涵盖消息队列（MQ）、分布式锁、队列路由、归档、Cron、安全等全部配置项
 ### 0.1.3
 - **Admin 界面大升级** — 集成 Tabbed ChangeForm 分页签展示字段，CronJob 后台支持直接执行/启用/禁用操作；TaskExecution 列表优化，execution_id 显示前8字符并支持点击复制，重试次数合并显示，全局字段中文翻译

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/README.md RENAMED Viewed

@@ -67,6 +67,87 @@ DJANGO_SIMPLETASK_LOCK_CONFIG = {
 python manage.py migrate django_simpletask5
 ```
+## 配置说明
+所有配置项均为可选，设有合理的默认值。以下按功能分类说明。
+### 消息队列（MQ）
+默认使用内存队列（`memory://`），适合开发调试。生产环境建议切换为 RabbitMQ 或 Redis。
+```python
+# 方式一：直接指定完整 Broker URL（优先级最高）
+DJANGO_SIMPLETASK_BROKER_URL = 'amqp://guest:guest@127.0.0.1:5672//'
+# 方式二：分别指定类型和连接参数
+DJANGO_SIMPLETASK_MESSAGE_QUEUE_TYPE = 'rabbitmq'  # 'memory' | 'rabbitmq' | 'redis'
+DJANGO_SIMPLETASK_RABBITMQ_HOST = '127.0.0.1'
+DJANGO_SIMPLETASK_RABBITMQ_PORT = 5672
+DJANGO_SIMPLETASK_RABBITMQ_USER = 'guest'
+DJANGO_SIMPLETASK_RABBITMQ_PASSWORD = 'guest'
+# Redis 作为 MQ 时：
+# DJANGO_SIMPLETASK_MESSAGE_QUEUE_TYPE = 'redis'
+# DJANGO_SIMPLETASK_REDIS_MQ_HOST = '127.0.0.1'
+# DJANGO_SIMPLETASK_REDIS_MQ_PORT = 6379
+# DJANGO_SIMPLETASK_REDIS_MQ_DB = 0
+```
+### 分布式锁
+```python
+DJANGO_SIMPLETASK_LOCK_CONFIG = {
+    'global_lock_engine_class': 'globallock.redis_global_lock.RedisGlobalLock',
+    'global_lock_engine_options': {
+        'host': '127.0.0.1',
+        'port': 6379,
+        'db': 0,
+    },
+}
+DJANGO_SIMPLETASK_LOCK_TIMEOUT = 600  # 锁超时时间（秒）
+```
+### 队列路由
+```python
+DJANGO_SIMPLETASK_DEFAULT_QUEUE = 'django_simpletask5.queue.default'          # 默认队列
+DJANGO_SIMPLETASK_HIGH_PRIORITY_QUEUE = 'django_simpletask5.queue.high_priority'  # 高优先级队列
+```
+### 执行与重试
+```python
+DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES = 3        # 默认最大重试次数
+DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS = 600  # 默认执行超时时间（秒）
+```
+### 归档
+```python
+DJANGO_SIMPLETASK_ARCHIVE_PATH = 'django_simpletask5_archives'  # 归档文件存储子目录
+DJANGO_SIMPLETASK_ARCHIVE_SALT = 'django-simpletask5-archive'   # 归档加密盐值（结合 SECRET_KEY 派生 AES 密钥）
+DJANGO_SIMPLETASK_ARCHIVE_RETENTION_DAYS = 7                    # 归档保留天数
+```
+### Cron
+```python
+DJANGO_SIMPLETASK_CRONJOB_AUTO_SYNC = True  # 是否自动将代码注册的 Cron 同步到数据库
+```
+### 安全
+```python
+# 脚本执行白名单（空列表表示不限制）
+DJANGO_SIMPLETASK_SCRIPT_WHITELIST = ['/path/to/allowed/scripts']
+# 自定义字段加密（默认使用 django-safe-fields 的默认加密）
+DJANGO_SIMPLETASK_FIELD_CIPHER_CLASS = None                              # 自定义加密器类
+DJANGO_SIMPLETASK_RESULT_PASSWORD = None     # 执行结果加密密码
+DJANGO_SIMPLETASK_ERROR_MSG_PASSWORD = None  # 错误信息加密密码
+DJANGO_SIMPLETASK_CONTEXT_PASSWORD = None    # 上下文数据加密密码
+```
 ## 快速开始
 ### 1. 定义任务模型
@@ -195,6 +276,12 @@ Worker 消费消息 → 获取分布式锁 → 加载执行器 → 执行并保
 ## Releases
+### 0.1.4
+- **修复打包** — `pyproject.toml` 添加 `package-data` 配置，打包时包含 locale po/mo 文件，修复 i18n 翻译不生效的问题
+- **补充依赖** — `requirements.txt` 和 `pyproject.toml` 添加缺失的 `django-checkbox-normalize`、`django-tabbed-changeform-admin` 依赖
+- **完善文档** — README 新增完整配置说明章节，涵盖消息队列（MQ）、分布式锁、队列路由、归档、Cron、安全等全部配置项
 ### 0.1.3
 - **Admin 界面大升级** — 集成 Tabbed ChangeForm 分页签展示字段，CronJob 后台支持直接执行/启用/禁用操作；TaskExecution 列表优化，execution_id 显示前8字符并支持点击复制，重试次数合并显示，全局字段中文翻译

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/django_simpletask5/core/defaults.py RENAMED Viewed

@@ -5,8 +5,6 @@ DJANGO_SIMPLETASK_LOCK_TIMEOUT = getattr(settings, 'DJANGO_SIMPLETASK_LOCK_TIMEO
 DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES = getattr(settings, 'DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES', 3)
 DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS = getattr(settings, 'DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS', 600)
-DJANGO_SIMPLETASK_UPDATE_FILTER_POLICY = getattr(settings, 'DJANGO_SIMPLETASK_UPDATE_FILTER_POLICY', 'whitelist')
 DJANGO_SIMPLETASK_ARCHIVE_PATH = getattr(settings, 'DJANGO_SIMPLETASK_ARCHIVE_PATH', 'django_simpletask5_archives')
 DJANGO_SIMPLETASK_ARCHIVE_SALT = getattr(settings, 'DJANGO_SIMPLETASK_ARCHIVE_SALT', 'django-simpletask5-archive')
 DJANGO_SIMPLETASK_ARCHIVE_RETENTION_DAYS = getattr(settings, 'DJANGO_SIMPLETASK_ARCHIVE_RETENTION_DAYS', 7)

django_simpletask5-0.1.4/django_simpletask5/locale/zh_Hans/LC_MESSAGES/django.mo ADDED Viewed

Binary file

django_simpletask5-0.1.4/django_simpletask5/locale/zh_Hans/LC_MESSAGES/django.po ADDED Viewed

@@ -0,0 +1,418 @@
+# Django SimpleTask5 zh_Hans translation.
+# Copyright (C) 2026 THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: django-simpletask5\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-06-10 09:15+0800\n"
+"PO-Revision-Date: 2026-05-31 00:45+0800\n"
+"Last-Translator: \n"
+"Language-Team: \n"
+"Language: zh_Hans\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+#: django_simpletask5/admin.py:35 django_simpletask5/models.py:209
+#, fuzzy
+#| msgid "ID"
+msgid "UID"
+msgstr "唯一码"
+#: django_simpletask5/admin.py:40 django_simpletask5/models.py:210
+msgid "Name"
+msgstr "名称"
+#: django_simpletask5/admin.py:45 django_simpletask5/models.py:114
+#: django_simpletask5/models.py:212
+msgid "Executor class"
+msgstr "执行器类"
+#: django_simpletask5/admin.py:49 django_simpletask5/models.py:128
+#: django_simpletask5/models.py:215
+msgid "Context"
+msgstr "上下文"
+#: django_simpletask5/admin.py:57
+msgid ""
+"Supports JSON or YAML format. YAML is more concise and compatible with JSON "
+"standard format."
+msgstr "支持 JSON 或 YAML 格式。YAML 更简洁，且兼容 JSON 标准格式。"
+#: django_simpletask5/admin.py:95
+msgid "Invalid parameter format. Please use JSON or YAML format."
+msgstr "参数格式无效，请使用 JSON 或 YAML 格式。"
+#: django_simpletask5/admin.py:126 django_simpletask5/models.py:110
+msgid "Execution ID"
+msgstr "执行流水号"
+#: django_simpletask5/admin.py:131
+msgid "Copied!"
+msgstr "已复制！"
+#: django_simpletask5/admin.py:179 django_simpletask5/admin.py:370
+#: django_simpletask5/admin.py:389
+msgid "Basic Info"
+msgstr "基本信息"
+#: django_simpletask5/admin.py:180
+msgid "Execution Data"
+msgstr "执行数据"
+#: django_simpletask5/admin.py:181
+msgid "Retry & Timeout"
+msgstr "重试与超时"
+#: django_simpletask5/admin.py:184 django_simpletask5/dashboards.py:144
+#: django_simpletask5/models.py:106
+msgid "Retry"
+msgstr "重试"
+#: django_simpletask5/admin.py:217
+msgid "Basic Config"
+msgstr "基本配置"
+#: django_simpletask5/admin.py:218
+msgid "Advanced Settings"
+msgstr "高级设置"
+#: django_simpletask5/admin.py:262
+msgid "操作"
+msgstr ""
+#: django_simpletask5/admin.py:318
+msgid "Reset from code definitions"
+msgstr "从代码重置规则"
+#: django_simpletask5/admin.py:324
+msgid "Mark as user-modified"
+msgstr "标记为手动修改"
+#: django_simpletask5/admin.py:330
+msgid "Unmark as user-modified"
+msgstr "取消手动修改标记"
+#: django_simpletask5/admin.py:336
+msgid "Activate selected tasks"
+msgstr "启用选中任务"
+#: django_simpletask5/admin.py:342
+msgid "Deactivate selected tasks"
+msgstr "停用选中任务"
+#: django_simpletask5/admin.py:371
+msgid "Statistics"
+msgstr "统计数据"
+#: django_simpletask5/apps.py:8
+msgid "Simple Task Manager"
+msgstr "简易任务管理"
+#: django_simpletask5/core/cronjob_registry.py:83
+#, fuzzy
+#| msgid "Status"
+msgid "Status Check"
+msgstr "状态"
+#: django_simpletask5/core/cronjob_registry.py:90
+#, fuzzy
+#| msgid "Retry count"
+msgid "Retry Timeout"
+msgstr "重试次数"
+#: django_simpletask5/core/cronjob_registry.py:97
+#, fuzzy
+#| msgid "Archives"
+msgid "Archive"
+msgstr "归档"
+#: django_simpletask5/core/cronjob_registry.py:104
+msgid "Purge Expired"
+msgstr ""
+#: django_simpletask5/core/cronjob_registry.py:111
+#, fuzzy
+#| msgid "Pending / Running"
+msgid "Ping / Pong"
+msgstr "待处理 / 运行中"
+#: django_simpletask5/dashboards.py:14
+msgid "Task Manager Dashboard"
+msgstr "任务管理仪表盘"
+#: django_simpletask5/dashboards.py:65
+msgid "Today Executions"
+msgstr "今日执行"
+#: django_simpletask5/dashboards.py:72
+msgid "Success Rate"
+msgstr "成功率"
+#: django_simpletask5/dashboards.py:80
+msgid "Workers"
+msgstr "工作进程"
+#: django_simpletask5/dashboards.py:86
+msgid "Cronjobs"
+msgstr "定时任务"
+#: django_simpletask5/dashboards.py:96
+msgid "Pending / Running"
+msgstr "待处理 / 运行中"
+#: django_simpletask5/dashboards.py:103
+msgid "Failed Today"
+msgstr "今日失败"
+#: django_simpletask5/dashboards.py:110
+msgid "Archives"
+msgstr "归档"
+#: django_simpletask5/dashboards.py:117
+msgid "Retries"
+msgstr "重试"
+#: django_simpletask5/dashboards.py:140 django_simpletask5/models.py:102
+msgid "Pending"
+msgstr "待处理"
+#: django_simpletask5/dashboards.py:141 django_simpletask5/models.py:103
+msgid "Running"
+msgstr "运行中"
+#: django_simpletask5/dashboards.py:142 django_simpletask5/dashboards.py:256
+#: django_simpletask5/models.py:104
+msgid "Success"
+msgstr "成功"
+#: django_simpletask5/dashboards.py:143 django_simpletask5/models.py:105
+msgid "Failed"
+msgstr "失败"
+#: django_simpletask5/dashboards.py:145 django_simpletask5/models.py:107
+msgid "Timeout"
+msgstr "超时"
+#: django_simpletask5/dashboards.py:154
+msgid "Execution Status Distribution"
+msgstr "执行状态分布"
+#: django_simpletask5/dashboards.py:167
+msgid "Daily Executions (Last 30 Days)"
+msgstr "每日执行（近30天）"
+#: django_simpletask5/dashboards.py:191
+msgid "Recent Failed / Timeout Executions"
+msgstr "最近失败/超时执行"
+#: django_simpletask5/dashboards.py:192 django_simpletask5/dashboards.py:200
+msgid "ID"
+msgstr "唯一码"
+#: django_simpletask5/dashboards.py:192 django_simpletask5/dashboards.py:200
+msgid "Executor"
+msgstr "执行器"
+#: django_simpletask5/dashboards.py:192 django_simpletask5/dashboards.py:200
+msgid "Event"
+msgstr "事件"
+#: django_simpletask5/dashboards.py:192 django_simpletask5/dashboards.py:200
+#: django_simpletask5/dashboards.py:227 django_simpletask5/models.py:115
+msgid "Status"
+msgstr "状态"
+#: django_simpletask5/dashboards.py:192 django_simpletask5/dashboards.py:200
+msgid "Time"
+msgstr "时间"
+#: django_simpletask5/dashboards.py:199
+msgid "Recent Executions"
+msgstr "最近执行"
+#: django_simpletask5/dashboards.py:226
+msgid "Active Workers"
+msgstr "活跃工作进程"
+#: django_simpletask5/dashboards.py:227
+msgid "Hostname"
+msgstr "主机名"
+#: django_simpletask5/dashboards.py:227
+msgid "Queue"
+msgstr "队列"
+#: django_simpletask5/dashboards.py:227
+msgid "Current Execution"
+msgstr "当前执行"
+#: django_simpletask5/dashboards.py:227
+msgid "Services"
+msgstr "服务"
+#: django_simpletask5/dashboards.py:261
+msgid "Failed/Timeout"
+msgstr "失败/超时"
+#: django_simpletask5/models.py:111
+msgid "Task ID"
+msgstr "任务编号"
+#: django_simpletask5/models.py:112 django_simpletask5/models.py:279
+msgid "Task model"
+msgstr "任务模型"
+#: django_simpletask5/models.py:113 django_simpletask5/models.py:280
+msgid "Trigger event"
+msgstr "触发事件"
+#: django_simpletask5/models.py:116
+msgid "Result"
+msgstr "结果"
+#: django_simpletask5/models.py:117
+msgid "Total tasks count"
+msgstr "总任务数"
+#: django_simpletask5/models.py:118
+msgid "Done tasks count"
+msgstr "已完成数"
+#: django_simpletask5/models.py:119
+msgid "Error message"
+msgstr "错误信息"
+#: django_simpletask5/models.py:120
+msgid "Retry count"
+msgstr "重试次数"
+#: django_simpletask5/models.py:121
+msgid "Max retries"
+msgstr "最大重试次数"
+#: django_simpletask5/models.py:122
+msgid "Timeout seconds"
+msgstr "超时秒数"
+#: django_simpletask5/models.py:123
+msgid "Expire time"
+msgstr "过期时间"
+#: django_simpletask5/models.py:124
+msgid "Started at"
+msgstr "开始时间"
+#: django_simpletask5/models.py:125
+msgid "Finished at"
+msgstr "完成时间"
+#: django_simpletask5/models.py:126 django_simpletask5/models.py:222
+#: django_simpletask5/models.py:265 django_simpletask5/models.py:286
+msgid "Created at"
+msgstr "创建时间"
+#: django_simpletask5/models.py:127 django_simpletask5/models.py:223
+msgid "Updated at"
+msgstr "更新时间"
+#: django_simpletask5/models.py:132
+msgid "Task execution"
+msgstr "任务执行"
+#: django_simpletask5/models.py:133
+msgid "Task executions"
+msgstr "任务执行"
+#: django_simpletask5/models.py:137
+msgid "TaskExecution"
+msgstr "任务执行"
+#: django_simpletask5/models.py:211
+msgid "Cron expression"
+msgstr "Cron 表达式"
+#: django_simpletask5/models.py:213
+msgid "Description"
+msgstr "描述"
+#: django_simpletask5/models.py:214
+msgid "Active"
+msgstr "启用"
+#: django_simpletask5/models.py:217
+msgid "Keep manual changes"
+msgstr "保留手动修改"
+#: django_simpletask5/models.py:219
+msgid ""
+"When checked, the cron job will not be overwritten by automatic code "
+"definition sync. Uncheck to allow re-sync from code definitions. It is "
+"automatically checked when substantive changes are saved via the admin."
+msgstr ""
+"勾选后，该定时任务不会被代码定义自动同步覆盖。当通过管理后台保存实质性变更"
+"时，该选项会自动勾选。取消勾选后，可重新从代码定义同步。"
+#: django_simpletask5/models.py:221
+msgid "Next run time"
+msgstr "下次运行时间"
+#: django_simpletask5/models.py:227
+msgid "Cron job"
+msgstr "定时任务"
+#: django_simpletask5/models.py:228
+msgid "Cron jobs"
+msgstr "定时任务"
+#: django_simpletask5/models.py:263
+msgid "Archive date"
+msgstr "归档日期"
+#: django_simpletask5/models.py:264
+msgid "File"
+msgstr "文件"
+#: django_simpletask5/models.py:269
+msgid "Task execution archive"
+msgstr "任务执行归档"
+#: django_simpletask5/models.py:270
+msgid "Task execution archives"
+msgstr "任务执行归档"
+#: django_simpletask5/models.py:278
+msgid "Date"
+msgstr "日期"
+#: django_simpletask5/models.py:281
+msgid "Total count"
+msgstr "总数"
+#: django_simpletask5/models.py:282
+msgid "Success count"
+msgstr "成功数"
+#: django_simpletask5/models.py:283
+msgid "Failed count"
+msgstr "失败数"
+#: django_simpletask5/models.py:284
+msgid "Timeout count"
+msgstr "超时数"
+#: django_simpletask5/models.py:285
+msgid "Avg duration (s)"
+msgstr "平均耗时(秒)"
+#: django_simpletask5/models.py:290
+msgid "Task execution stat"
+msgstr "任务执行统计"
+#: django_simpletask5/models.py:291
+msgid "Task execution stats"
+msgstr "任务执行统计"

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/django_simpletask5.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-simpletask5
-Version: 0.1.3
+Version: 0.1.4
 Summary: Lightweight async task execution framework for Django
 Author-email: rRR0VrFP <rrr0vrfp@qq.com>
 Maintainer-email: rRR0VrFP <rrr0vrfp@qq.com>
@@ -27,6 +27,8 @@ Requires-Dist: globallock>=0.1.4
 Requires-Dist: django-safe-fields>=0.2.3
 Requires-Dist: django-app-requires>=0.3.6
 Requires-Dist: django-admin-dashboards>=0.1.1
+Requires-Dist: django-checkbox-normalize>=0.2.2
+Requires-Dist: django-tabbed-changeform-admin>=0.1.9
 Requires-Dist: cryptography>=48.0.0
 Requires-Dist: croniter>=6.2.2
 Requires-Dist: requests>=2.34.2
@@ -104,6 +106,87 @@ DJANGO_SIMPLETASK_LOCK_CONFIG = {
 python manage.py migrate django_simpletask5
 ```
+## 配置说明
+所有配置项均为可选，设有合理的默认值。以下按功能分类说明。
+### 消息队列（MQ）
+默认使用内存队列（`memory://`），适合开发调试。生产环境建议切换为 RabbitMQ 或 Redis。
+```python
+# 方式一：直接指定完整 Broker URL（优先级最高）
+DJANGO_SIMPLETASK_BROKER_URL = 'amqp://guest:guest@127.0.0.1:5672//'
+# 方式二：分别指定类型和连接参数
+DJANGO_SIMPLETASK_MESSAGE_QUEUE_TYPE = 'rabbitmq'  # 'memory' | 'rabbitmq' | 'redis'
+DJANGO_SIMPLETASK_RABBITMQ_HOST = '127.0.0.1'
+DJANGO_SIMPLETASK_RABBITMQ_PORT = 5672
+DJANGO_SIMPLETASK_RABBITMQ_USER = 'guest'
+DJANGO_SIMPLETASK_RABBITMQ_PASSWORD = 'guest'
+# Redis 作为 MQ 时：
+# DJANGO_SIMPLETASK_MESSAGE_QUEUE_TYPE = 'redis'
+# DJANGO_SIMPLETASK_REDIS_MQ_HOST = '127.0.0.1'
+# DJANGO_SIMPLETASK_REDIS_MQ_PORT = 6379
+# DJANGO_SIMPLETASK_REDIS_MQ_DB = 0
+```
+### 分布式锁
+```python
+DJANGO_SIMPLETASK_LOCK_CONFIG = {
+    'global_lock_engine_class': 'globallock.redis_global_lock.RedisGlobalLock',
+    'global_lock_engine_options': {
+        'host': '127.0.0.1',
+        'port': 6379,
+        'db': 0,
+    },
+}
+DJANGO_SIMPLETASK_LOCK_TIMEOUT = 600  # 锁超时时间（秒）
+```
+### 队列路由
+```python
+DJANGO_SIMPLETASK_DEFAULT_QUEUE = 'django_simpletask5.queue.default'          # 默认队列
+DJANGO_SIMPLETASK_HIGH_PRIORITY_QUEUE = 'django_simpletask5.queue.high_priority'  # 高优先级队列
+```
+### 执行与重试
+```python
+DJANGO_SIMPLETASK_DEFAULT_MAX_RETRIES = 3        # 默认最大重试次数
+DJANGO_SIMPLETASK_DEFAULT_TIMEOUT_SECONDS = 600  # 默认执行超时时间（秒）
+```
+### 归档
+```python
+DJANGO_SIMPLETASK_ARCHIVE_PATH = 'django_simpletask5_archives'  # 归档文件存储子目录
+DJANGO_SIMPLETASK_ARCHIVE_SALT = 'django-simpletask5-archive'   # 归档加密盐值（结合 SECRET_KEY 派生 AES 密钥）
+DJANGO_SIMPLETASK_ARCHIVE_RETENTION_DAYS = 7                    # 归档保留天数
+```
+### Cron
+```python
+DJANGO_SIMPLETASK_CRONJOB_AUTO_SYNC = True  # 是否自动将代码注册的 Cron 同步到数据库
+```
+### 安全
+```python
+# 脚本执行白名单（空列表表示不限制）
+DJANGO_SIMPLETASK_SCRIPT_WHITELIST = ['/path/to/allowed/scripts']
+# 自定义字段加密（默认使用 django-safe-fields 的默认加密）
+DJANGO_SIMPLETASK_FIELD_CIPHER_CLASS = None                              # 自定义加密器类
+DJANGO_SIMPLETASK_RESULT_PASSWORD = None     # 执行结果加密密码
+DJANGO_SIMPLETASK_ERROR_MSG_PASSWORD = None  # 错误信息加密密码
+DJANGO_SIMPLETASK_CONTEXT_PASSWORD = None    # 上下文数据加密密码
+```
 ## 快速开始
 ### 1. 定义任务模型
@@ -232,6 +315,12 @@ Worker 消费消息 → 获取分布式锁 → 加载执行器 → 执行并保
 ## Releases
+### 0.1.4
+- **修复打包** — `pyproject.toml` 添加 `package-data` 配置，打包时包含 locale po/mo 文件，修复 i18n 翻译不生效的问题
+- **补充依赖** — `requirements.txt` 和 `pyproject.toml` 添加缺失的 `django-checkbox-normalize`、`django-tabbed-changeform-admin` 依赖
+- **完善文档** — README 新增完整配置说明章节，涵盖消息队列（MQ）、分布式锁、队列路由、归档、Cron、安全等全部配置项
 ### 0.1.3
 - **Admin 界面大升级** — 集成 Tabbed ChangeForm 分页签展示字段，CronJob 后台支持直接执行/启用/禁用操作；TaskExecution 列表优化，execution_id 显示前8字符并支持点击复制，重试次数合并显示，全局字段中文翻译

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/django_simpletask5.egg-info/SOURCES.txt RENAMED Viewed

@@ -30,6 +30,8 @@ django_simpletask5/executors/python_script.py
 django_simpletask5/executors/retry_timeout.py
 django_simpletask5/executors/simple_request.py
 django_simpletask5/executors/status_check.py
+django_simpletask5/locale/zh_Hans/LC_MESSAGES/django.mo
+django_simpletask5/locale/zh_Hans/LC_MESSAGES/django.po
 django_simpletask5/management/__init__.py
 django_simpletask5/management/commands/__init__.py
 django_simpletask5/management/commands/django_simpletask_archive.py

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/django_simpletask5.egg-info/requires.txt RENAMED Viewed

@@ -2,6 +2,8 @@ globallock>=0.1.4
 django-safe-fields>=0.2.3
 django-app-requires>=0.3.6
 django-admin-dashboards>=0.1.1
+django-checkbox-normalize>=0.2.2
+django-tabbed-changeform-admin>=0.1.9
 cryptography>=48.0.0
 croniter>=6.2.2
 requests>=2.34.2

{django_simpletask5-0.1.3 → django_simpletask5-0.1.4}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "django-simpletask5"
-version = "0.1.3"
+version = "0.1.4"
 description = "Lightweight async task execution framework for Django"
 readme = "README.md"
 license = {text = "MIT"}
@@ -30,6 +30,8 @@ dependencies = [
     "django-safe-fields>=0.2.3",
     "django-app-requires>=0.3.6",
     "django-admin-dashboards>=0.1.1",
+    "django-checkbox-normalize>=0.2.2",
+    "django-tabbed-changeform-admin>=0.1.9",
     "cryptography>=48.0.0",
     "croniter>=6.2.2",
     "requests>=2.34.2",
@@ -53,6 +55,9 @@ email = "rrr0vrfp@qq.com"
 include = ["django_simpletask5*"]
 exclude = ["django_simpletask5_demo*", "django_simpletask5_example*"]
+[tool.setuptools.package-data]
+django_simpletask5 = ["locale/**/*.po", "locale/**/*.mo"]
 [tool.pytest.ini_options]
 DJANGO_SETTINGS_MODULE = "django_simpletask5_demo.settings"
 testpaths = ["django_simpletask5_example/tests"]