# Asterisk-Task
## 介绍
这是一个任务管理的框架，可以把需要执行的任务在命令行进行执行，配置定时任务、多线程运行的任务等。
可以应用到日常监控、自动化执行、数据自动采集、定时自动机器学习等方面。
注意：
* 发行版本的版本号不一定连续，中间的版本号都是开发中的版本号，不正式发布。
* 版本号为A.B.C.mmdd.hhmm的格式，只须关注A.B.C即可，mmdd.hhmm为build时间戳
## 发行日志
详细可以参考[gitee版发布日志](https://gitee.com/zhangxin_1/asterisk-task/blob/master/docs/release_log.md)
技术文档参考[Documentation](https://gitee.com/zhangxin_1/asterisk-task/blob/master/docs/documentation.md)
### V2.1.0
* 移除AsteriskSinDout类，该类主要用于加密、解密。可以另外安装asterisk-security
* 实现定时任务中中国工作日，中国交易日的设定。
* 已经宣示deprecated都是的error_print以及warn_print方法，正式下线
* 开始deprecte start_task方法，逐步该用exec_task方法
* task支持next_tasks_paralelle属性，默认为False，当为True时，后续任务将启动新线程中执行，可以快速将主任务结束。
### 软件架构
Aterisk-Task以TaskManager作为任务管理器的类，在系统启动时，读入配置文件，读取可以调用任务类，启动默认任务，并启动定时任务。本框架集成了schedule、logging等常用类库。
为了解决关联任务直接的数据传递，以AsteriskContext来实现了类似cookie的功能。
自V2.0以后，任务类做了一次比较大的升级。任务类（除了启动后的默认任务，需要在AppConfig文件中配置意外）将不需要在配置文件中进行配置。
整体架构非常轻。
### 安装教程
1. 在gitee中[发行版](https://e.gitee.com/zhangxin_1/repos/zhangxin_1/asterisk-task/releases/ "Asteristk-Task 框架发行版")下载最新发行版
2. 可以命令行中执行`pip3 install asterisk_task-*.whl`进行安装
### 使用说明
1. 安装成功后,可以使用命令行创建项目，例如创建test_project `atnewapp -app test_project`
2. 系统会自动创建 `test_project` 目录，以及`run_test_project.py`
3. 执行`python3 run_test_project.py`即可启动项目运行。创建项目时会自动设置默认任务。
### 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
新建 Pull Request
### 特技
1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
Raw data
{
"_id": null,
"home_page": null,
"name": "asterisk-task",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10.0",
"maintainer_email": null,
"keywords": "task, scheduled task",
"author": "Shan,Tian",
"author_email": "geoshan@163.com",
"download_url": "https://files.pythonhosted.org/packages/c9/87/bb63fb22dec895b9d62b0a3db82be7df7ed445eb54386b083799c1653b78/asterisk_task-2.1.2.1022.835.tar.gz",
"platform": "Independent",
"description": "# Asterisk-Task\n\n## \u4ecb\u7ecd\n\n\u8fd9\u662f\u4e00\u4e2a\u4efb\u52a1\u7ba1\u7406\u7684\u6846\u67b6\uff0c\u53ef\u4ee5\u628a\u9700\u8981\u6267\u884c\u7684\u4efb\u52a1\u5728\u547d\u4ee4\u884c\u8fdb\u884c\u6267\u884c\uff0c\u914d\u7f6e\u5b9a\u65f6\u4efb\u52a1\u3001\u591a\u7ebf\u7a0b\u8fd0\u884c\u7684\u4efb\u52a1\u7b49\u3002\n\u53ef\u4ee5\u5e94\u7528\u5230\u65e5\u5e38\u76d1\u63a7\u3001\u81ea\u52a8\u5316\u6267\u884c\u3001\u6570\u636e\u81ea\u52a8\u91c7\u96c6\u3001\u5b9a\u65f6\u81ea\u52a8\u673a\u5668\u5b66\u4e60\u7b49\u65b9\u9762\u3002\n\n\u6ce8\u610f\uff1a\n\n* \u53d1\u884c\u7248\u672c\u7684\u7248\u672c\u53f7\u4e0d\u4e00\u5b9a\u8fde\u7eed\uff0c\u4e2d\u95f4\u7684\u7248\u672c\u53f7\u90fd\u662f\u5f00\u53d1\u4e2d\u7684\u7248\u672c\u53f7\uff0c\u4e0d\u6b63\u5f0f\u53d1\u5e03\u3002\n* \u7248\u672c\u53f7\u4e3aA.B.C.mmdd.hhmm\u7684\u683c\u5f0f\uff0c\u53ea\u987b\u5173\u6ce8A.B.C\u5373\u53ef\uff0cmmdd.hhmm\u4e3abuild\u65f6\u95f4\u6233\n\n## \u53d1\u884c\u65e5\u5fd7\n\n\u8be6\u7ec6\u53ef\u4ee5\u53c2\u8003[gitee\u7248\u53d1\u5e03\u65e5\u5fd7](https://gitee.com/zhangxin_1/asterisk-task/blob/master/docs/release_log.md)\n\u6280\u672f\u6587\u6863\u53c2\u8003[Documentation](https://gitee.com/zhangxin_1/asterisk-task/blob/master/docs/documentation.md)\n\n### V2.1.0\n\n* \u79fb\u9664AsteriskSinDout\u7c7b\uff0c\u8be5\u7c7b\u4e3b\u8981\u7528\u4e8e\u52a0\u5bc6\u3001\u89e3\u5bc6\u3002\u53ef\u4ee5\u53e6\u5916\u5b89\u88c5asterisk-security\n* \u5b9e\u73b0\u5b9a\u65f6\u4efb\u52a1\u4e2d\u4e2d\u56fd\u5de5\u4f5c\u65e5\uff0c\u4e2d\u56fd\u4ea4\u6613\u65e5\u7684\u8bbe\u5b9a\u3002\n* \u5df2\u7ecf\u5ba3\u793adeprecated\u90fd\u662f\u7684error_print\u4ee5\u53cawarn_print\u65b9\u6cd5\uff0c\u6b63\u5f0f\u4e0b\u7ebf\n* \u5f00\u59cbdeprecte start_task\u65b9\u6cd5\uff0c\u9010\u6b65\u8be5\u7528exec_task\u65b9\u6cd5\n* task\u652f\u6301next_tasks_paralelle\u5c5e\u6027\uff0c\u9ed8\u8ba4\u4e3aFalse\uff0c\u5f53\u4e3aTrue\u65f6\uff0c\u540e\u7eed\u4efb\u52a1\u5c06\u542f\u52a8\u65b0\u7ebf\u7a0b\u4e2d\u6267\u884c\uff0c\u53ef\u4ee5\u5feb\u901f\u5c06\u4e3b\u4efb\u52a1\u7ed3\u675f\u3002\n\n### \u8f6f\u4ef6\u67b6\u6784\n\nAterisk-Task\u4ee5TaskManager\u4f5c\u4e3a\u4efb\u52a1\u7ba1\u7406\u5668\u7684\u7c7b\uff0c\u5728\u7cfb\u7edf\u542f\u52a8\u65f6\uff0c\u8bfb\u5165\u914d\u7f6e\u6587\u4ef6\uff0c\u8bfb\u53d6\u53ef\u4ee5\u8c03\u7528\u4efb\u52a1\u7c7b\uff0c\u542f\u52a8\u9ed8\u8ba4\u4efb\u52a1\uff0c\u5e76\u542f\u52a8\u5b9a\u65f6\u4efb\u52a1\u3002\u672c\u6846\u67b6\u96c6\u6210\u4e86schedule\u3001logging\u7b49\u5e38\u7528\u7c7b\u5e93\u3002\n\u4e3a\u4e86\u89e3\u51b3\u5173\u8054\u4efb\u52a1\u76f4\u63a5\u7684\u6570\u636e\u4f20\u9012\uff0c\u4ee5AsteriskContext\u6765\u5b9e\u73b0\u4e86\u7c7b\u4f3ccookie\u7684\u529f\u80fd\u3002\n\n\u81eaV2.0\u4ee5\u540e\uff0c\u4efb\u52a1\u7c7b\u505a\u4e86\u4e00\u6b21\u6bd4\u8f83\u5927\u7684\u5347\u7ea7\u3002\u4efb\u52a1\u7c7b\uff08\u9664\u4e86\u542f\u52a8\u540e\u7684\u9ed8\u8ba4\u4efb\u52a1\uff0c\u9700\u8981\u5728AppConfig\u6587\u4ef6\u4e2d\u914d\u7f6e\u610f\u5916\uff09\u5c06\u4e0d\u9700\u8981\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u8fdb\u884c\u914d\u7f6e\u3002\n\n\u6574\u4f53\u67b6\u6784\u975e\u5e38\u8f7b\u3002\n\n### \u5b89\u88c5\u6559\u7a0b\n\n1. \u5728gitee\u4e2d[\u53d1\u884c\u7248](https://e.gitee.com/zhangxin_1/repos/zhangxin_1/asterisk-task/releases/ \"Asteristk-Task \u6846\u67b6\u53d1\u884c\u7248\")\u4e0b\u8f7d\u6700\u65b0\u53d1\u884c\u7248\n2. \u53ef\u4ee5\u547d\u4ee4\u884c\u4e2d\u6267\u884c`pip3 install asterisk_task-*.whl`\u8fdb\u884c\u5b89\u88c5\n\n### \u4f7f\u7528\u8bf4\u660e\n\n1. \u5b89\u88c5\u6210\u529f\u540e,\u53ef\u4ee5\u4f7f\u7528\u547d\u4ee4\u884c\u521b\u5efa\u9879\u76ee\uff0c\u4f8b\u5982\u521b\u5efatest_project `atnewapp -app test_project`\n2. \u7cfb\u7edf\u4f1a\u81ea\u52a8\u521b\u5efa `test_project` \u76ee\u5f55\uff0c\u4ee5\u53ca`run_test_project.py`\n3. \u6267\u884c`python3 run_test_project.py`\u5373\u53ef\u542f\u52a8\u9879\u76ee\u8fd0\u884c\u3002\u521b\u5efa\u9879\u76ee\u65f6\u4f1a\u81ea\u52a8\u8bbe\u7f6e\u9ed8\u8ba4\u4efb\u52a1\u3002\n\n### \u53c2\u4e0e\u8d21\u732e\n\n1. Fork \u672c\u4ed3\u5e93\n2. \u65b0\u5efa Feat_xxx \u5206\u652f\n3. \u63d0\u4ea4\u4ee3\u7801\n \u65b0\u5efa Pull Request\n\n### \u7279\u6280\n\n1. \u4f7f\u7528 Readme\\_XXX.md \u6765\u652f\u6301\u4e0d\u540c\u7684\u8bed\u8a00\uff0c\u4f8b\u5982 Readme\\_en.md, Readme\\_zh.md\n2. Gitee \u5b98\u65b9\u535a\u5ba2 [blog.gitee.com](https://blog.gitee.com)\n3. \u4f60\u53ef\u4ee5 [https://gitee.com/explore](https://gitee.com/explore) \u8fd9\u4e2a\u5730\u5740\u6765\u4e86\u89e3 Gitee \u4e0a\u7684\u4f18\u79c0\u5f00\u6e90\u9879\u76ee\n4. [GVP](https://gitee.com/gvp) \u5168\u79f0\u662f Gitee \u6700\u6709\u4ef7\u503c\u5f00\u6e90\u9879\u76ee\uff0c\u662f\u7efc\u5408\u8bc4\u5b9a\u51fa\u7684\u4f18\u79c0\u5f00\u6e90\u9879\u76ee\n5. Gitee \u5b98\u65b9\u63d0\u4f9b\u7684\u4f7f\u7528\u624b\u518c [https://gitee.com/help](https://gitee.com/help)\n6. Gitee \u5c01\u9762\u4eba\u7269\u662f\u4e00\u6863\u7528\u6765\u5c55\u793a Gitee \u4f1a\u5458\u98ce\u91c7\u7684\u680f\u76ee [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Task management system.",
"version": "2.1.2.1022.835",
"project_urls": null,
"split_keywords": [
"task",
" scheduled task"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "98bd887b0df77039fdca8a4814da1c395222ab75b4b329745eb1ae43a55e46f6",
"md5": "1e362eec1f86bb45af3f97baadfbfe27",
"sha256": "35bf769443b3e8e996ddfad6f9889806c4eadad49b59d6af7033092366958848"
},
"downloads": -1,
"filename": "asterisk_task-2.1.2.1022.835-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1e362eec1f86bb45af3f97baadfbfe27",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.0",
"size": 37220,
"upload_time": "2024-10-22T00:39:34",
"upload_time_iso_8601": "2024-10-22T00:39:34.263488Z",
"url": "https://files.pythonhosted.org/packages/98/bd/887b0df77039fdca8a4814da1c395222ab75b4b329745eb1ae43a55e46f6/asterisk_task-2.1.2.1022.835-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c987bb63fb22dec895b9d62b0a3db82be7df7ed445eb54386b083799c1653b78",
"md5": "74078c165cae6765faf00cd8d0be4110",
"sha256": "9d2b6d62026a270358b4edd0c79d803b6dfcb358a3960ef2fdecbded00e612d9"
},
"downloads": -1,
"filename": "asterisk_task-2.1.2.1022.835.tar.gz",
"has_sig": false,
"md5_digest": "74078c165cae6765faf00cd8d0be4110",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.0",
"size": 31230,
"upload_time": "2024-10-22T00:39:35",
"upload_time_iso_8601": "2024-10-22T00:39:35.583075Z",
"url": "https://files.pythonhosted.org/packages/c9/87/bb63fb22dec895b9d62b0a3db82be7df7ed445eb54386b083799c1653b78/asterisk_task-2.1.2.1022.835.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-22 00:39:35",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "asterisk-task"
}
JSON