行为工作者
act-workers的Python项目详细描述
实际工作者
简介
此存储库包含ACT platform的工作线程。
工作程序的源代码在github上可用。
设置
要使用workers,请从pypi安装:
sudo pip3 install act-workers
这将为所有工人安装脚本:
- 阿尔古斯法案案例
- 行动攻击
- 实际国家地区
- 误操作馈送
- 动作助记符PDN
- 表演接穗
- 代理ShadowServer ASN
- ACT上传程序
- 动作URL较短解包
- 动作验证
- 动作vt
用法
将事实打印到标准输出:
$ act-country-regions {"type": "memberOf", "value": "", "accessMode": "Public", "sourceObject": {"type": "country", "value": "Afghanistan"}, "destinationObject": {"type": "subRegion", "value": "Southern Asia"}, "bidirectionalBinding": false}{"type": "memberOf", "value": "", "accessMode": "Public", "sourceObject": {"type": "subRegion", "value": "Southern Asia"}, "destinationObject": {"type": "region", "value": "Asia"}, "bidirectionalBinding": false}(...)
或打印事实作为文本表示:
$ act-country-regions --output-format str (country/Afghanistan) -[memberOf]-> (subRegion/Southern Asia)(subRegion/Southern Asia) -[memberOf]-> (region/Asia)(...)
要将事实直接添加到平台,请包括act-baseurl和用户id选项:
$ act-country-regions --act-baseurl http://localhost:8888 --user-id 1
配置
所有工作线程都支持在配置文件中指定为命令行参数、环境变量的选项。
还包括一个用于显示和以默认ini文件开头的实用程序:
act-worker-config --help usage: ACT worker config [-h]{show,user,system} positional arguments: {show,user,system} optional arguments: -h, --help show this help message and exit show - Print default config user - Copy default config to /home/fredrikb/.config/actworkers/actworkers.ini system - Copy default config to /etc/actworkers.ini
您可以在act/workers/etc/actworkers.ini中看到默认选项。
配置显示(从最低到最高):
- 默认值(显示在--help for each worker中)
- INI文件
- 环境变量
- 命令行参数
INI文件
参数分两个阶段分析。首先,它将查找参数--config参数 它可用于指定ini文件的替代位置。如果不是--config参数 它将在以下位置查找ini文件:
/etc/<CONFIG_FILE_NAME>
~/.config/<CONFIG_ID>/<CONFIG_FILE_NAME> (or directory specified by $XDG_CONFIG_HOME)
INI文件包含一个“[默认]”部分,将用于所有工人。 此外,每个工作进程都有单独的部分可用于配置 工作机特定的选项,并重写默认选项。
环境变量
配置步骤还将查找大写的环境变量和 用“-”替换为“\对于选项“cert file”的示例,它将查找 环境变量“$cert_file”。
要求
所有工人都需要python版本>;=3.5和act api库:
此外,有些库可能有其他要求。有关所有要求的完整列表,请参见Requirements.txt。
地方发展
使用pip在local development mode中安装。act workers(和act api)使用命名空间,因此它与使用setup.py install
或setup.py develop
不兼容。
在存储库中,运行:
pip3 install --user -e .