解析ARM规范语言(ASL)文件的代码

aslutils的Python项目详细描述


解决方法

分析ASL文件和实际ASL语言的实用程序脚本。

安装

最好将其安装在虚拟环境中。要在当前目录中创建虚拟环境,请写入python3 -m venv env/。要进入虚拟环境,请使用source env/bin/activate

要安装,只需使用pip:pip3 install aslutils

安装用于开发

要安装用于开发的包,请克隆它,然后以可编辑模式安装它:pip3 install -e /path/to/aslutils/(即包含setup.py的目录)。

使用解决方案

文档可以在https://alehed.github.io/aslutils/

开发

生成文档

aslutils使用sphinx(pip install sphinx)生成文档。从根文件夹生成html文档的命令是sphinx-build -b html docs/source docs/build。然后可以在docs/build/index.html找到这些文档。

如果源文件中有任何更改(类名、新类等),则必须重新生成aslutils.rst和modules.rst文件。这可以通过sphinx-apidoc -f -o docs/source/ aslutils完成。不要手动编辑这些文件,因为一旦重新运行sphinx apidoc,更改将被覆盖。

构建时间依赖性

为了在本地构建项目,需要安装antlr4https://www.antlr.org/)和相应的antlr4 python运行时(pip install antlr4-python3-runtime==4.?.?,版本必须与安装的antlr版本匹配)。

构建解析器

asl访问者代码是用antlr4 -Dlanguage=Python3 -no-listener -visitor ./aslutils/ASL.g4生成的。每次更改文件asl.g4时都必须执行此操作。

包装

注:我目前是这个项目的唯一包装商,所以这一部分仅供以后参考。

一旦安装了antlr,这个步骤就很简单了。打包的依赖项有:轮子、设置工具和捆绳(pip install wheel setuptools twine

从dist目录rm dist/*中删除旧版本后,需要使用python setup.py sdist bdist_wheel --universal生成包。然后可以使用tween:twine upload dist/*上传。

释放过程

再说一次,这只是为了我自己。

  1. 决定重新发布
  2. 完全重新生成文档并提交更改
  3. 在setup.py中增加版本
  4. 标记最新提交并推送它
  5. 使用提供的脚本发布文档
  6. 执行包装中描述的步骤

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java模拟存储库对象从controller testcase返回空结果?   Java扫描程序跳行异常   c#混淆If语句?   java为什么日志中的stacktrace前面没有这一行?   java如何使SSHJ在非标准端口上启动出站SFTP?   java我如何确定为什么每周收入没有在我的程序中显示前三次?   java如何判断堆叠条形图的轴的行为?   java rest json API的Web服务器体系结构   java ClassCastException:javax。摆动按扭   Java在Linux上不读取excel文件(使用Apache POI)   反馈错误后,java Wicket 1.4.9无法从modal使用AjaxRequestTarget!   java方法头中“静态”的含义是什么?   java无法在我的tomcat应用程序中添加外部库   java使用Itext Pdf将图像添加到Pdf文件   java为什么当我调用universe时java3d会闪烁。getCanvas()。getView()。重新油漆();   java Gson嵌套类在使用proguard时为空   java如何确定JSON路径对文档是否有效   java在使用Jsoup解析时保持HTML布尔属性的原始形式   使用Java SDK,如何在Azure存储文件服务中为文件设置元数据?