Python:如何导入asciidoc3

Question

如何从我的python脚本中使用asciidoc3 python包将asciidoc转换为html？我找不到一个有用的例子。官方文档主要面向那些将asciidoc3作为命令行工具的人，而不是那些希望在python应用程序中进行转换的人。

我发现，有时软件包会被重构，大大的改进和旧的例子在互联网上没有更新。Python示例常常为了简洁而省略导入语句，但对于像我这样的新开发人员来说，正确的入口点并不明显。

在我的复仇里，我跑了

pip install asciidoc3

然后我试着..。

import io
from asciidoc3.asciidoc3api import AsciiDoc3API
infile = io.StringIO('Hello world')
outfile = io.StringIO()
asciidoc3_ = AsciiDoc3API()
asciidoc3_.options('--no-header-footer')
asciidoc3_.execute(infile, outfile, backend='html4')
print(outfile.getvalue())

和

import io
from asciidoc3 import asciidoc3api
asciidoc3_ = asciidoc3api.AsciiDoc3API()
infile = io.StringIO('Hello world')
asciidoc3_.execute(infile)

Pycharm在进行语法检查时，无论是导入尝试还是导入尝试都没有问题，而且根据我在venv站点中看到的包，一切看起来都是正确的."./venv/lib/python3.10/site-packages/asciidoc3/asciidoc3api.py“如出一辙地出现在那里。但我的两次尝试都引发了"AttributeError:模块'asciidoc3‘没有属性'execute'“

那是真的。asciidoc3没有任何这样的属性。它是在AsciiDoc3API中定义的类asciidoc3api.py的一种方法。我想问题应该是我的进口报表吧？

Answer 1

我想通了。这不是导入声明。错误信息把我送进了错误的兔子洞，但我在模块的doc文件夹中找到了这个.

注：.PyPI、venv (Windows或GNU/Linux和其他POSIX操作系统)不幸的是，有时(并不总是-取决于您的目录-布局、操作系统等)。当您通过venv和/或AsciiDoc3安装时，asciidoc3无法找到“asciidoc3”模块。+

解决办法：

from asciidoc3api import AsciiDoc3API
asciidoc3 = AsciiDoc3API('/full/path/to/asciidoc3.py')