DAP档案加载器和检查器
daploader的Python项目详细描述
加载dap文件的python模块,检查它的健全性/有效性 并通过python类提供对元数据的访问。
您还可以在daps上运行daplint,以查看一些错误或警告。
还提供了从Dapi(dapi)安装daps的非常基本的命令行工具。
dap
dap是包含自定义助理的devassistant扩展的格式。 整个事情现在处于开发阶段,规范可能会改变 未来。这个模块应该定义标准。
结构
- <;软件包名称>;-<;版本>;/
- 助手/
- {crt,mod,prep,task}/
- <;package_name>;.yaml和可选的<;package_name>;/*.yaml
- {crt,mod,prep,task}/
- 文件/
- {crt,mod,prep,task,snippets}/
- <;软件包名称>;/
- 助手需要的其他文件(脚本、模板等)
- <;软件包名称>;/
- {crt,mod,prep,task,snippets}/
- 图标/
- {crt,mod,prep,task,snippets}/
- <;包名>;{svg,png…}
- {crt,mod,prep,task,snippets}/
- 片段/
- <;package_name>;.yaml和可选的<;package_name>;/*.yaml
- 医生/
- <;软件包名称>;/
- 许可证或复制文件
- 自述
- 其他文档
- <;软件包名称>;/
- 元音
- 元数据
- 助手/
基本上只有meta.yaml是必需的,但是带有meta.yaml的dap没有任何意义。所有内容都包装在tar.gz存档中,并重命名为<;package_name>;-<;version>;.dap。.yaml和icons文件扩展名(当前仅.svg和.png)必须小写。存档应包含一个顶级目录,名为<;package\u name>;-<;version>;。
异甘氨酸
package_name: foo # required version: 1.0.0 # required license: GPLv2 # required authors: [Bohuslav Kabrda <bkabrda@mailserver.com>, ...] # required homepage: https://github.com/bkabrda/assistant-foo # optional summary: Some brief one line text # required bugreports: <a single URL or email address> # optional description: | Some not-so-brief optional text. It can be split to multiple lines.
- package name可以包含小写字母(仅限ascii)、数字、下划线和破折号(虽然它只能以字母或数字开头和结尾),但必须是唯一的,有几个名称是由devassistant本身保留的(例如python、ruby)
- version遵循此方案:<;num>;[.<;num>;]*[dev a b],其中1.0.5<;1.1dev<;1.1a<;1.1b<;1.1
- license是通过fedora中使用的license标记指定的https://fedoraproject.org/wiki/Licensing:Main?rd=Licensing#Good_Licenses
- authors是具有电子邮件地址的作者列表(可以使用at而不是@) 1是一个指向描述DAP或包含代码(如示例)的现有网页的URL,仅允许http或FTP,没有IP地址<
- summary和description在给定示例中是自描述性的
- bugreports定义用户应在哪里报告错误,它可以是url(问题跟踪器)或电子邮件地址(邮件列表或个人)