xmlplain 1.6.0

xmlplan

XML作为纯对象实用程序模块

Synopsys

此模块是一组实用函数，用于分析自包含的 XML输入到纯列表/dict/string类型并发送到/读取 从XML或YAML格式。

其动机是将xml转储到yaml，手动编辑 将文件作为yaml，并返回xml输出。

尽管此模块可以更简单地用于转储兼容的plain 将/dict/string对象列为xml或yaml进行文本存储。

当读到对象并写回xml时，xml文件内容具有 所有的文件结构和内容都保存在W.R.T.。 元素开始/结束和文本内容。 通过xml注释、文档类型规范、外部 如果输入中存在实体定义，则将放弃实体定义。外部系统 不支持实体（即包含外部文件） 并生成一个输入错误。

输入xml只是在语法上验证，而不是验证 作为底层后端的任何DTD或模式规范 是核心xml.sax模块。

文档上唯一的可选破坏性转换 内容是读取时的条带空间选项（分别为漂亮选项 在书写时）会影响非叶文本内容（剥离 前导和尾随空格）。

XML命名空间被忽略，因为没有实际的架构验证， 因此，元素、属性名和名称空间uri属性 按原样传递和保留。

注意，有一些模块几乎相同 功能，但没有一个提供所有功能：

• 简单的普通对象（dict、list、strings）转储到XML或从XML重新加载
• 保存半结构化XML文档（标记重复， 混合文本和标记）输入时
• 通过yaml桥管理可编辑表单

用法

为了将xml文件转换为yaml表示，例如 测试/example-1.xml文件：

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

执行以下python代码：

importxmlplain# Read to plain objectwithopen("tests/example-1.xml")asinf:root=xmlplain.xml_to_obj(inf,strip_space=True,fold_dict=True)# Output plain YAMLwithopen("example-1.yml","w")asoutf:xmlplain.obj_to_yaml(root,outf)

这将在example-1.yml中输出yaml表示

example:doc:'Thisisanexampleforxmlobjdocumentation.'content:'@version':betakind:documentclass:examplestructured:''elements:-item:Elt 1-doc:Elt 2-item:Elt 3-doc:Elt 4

然后可以读取发出的yaml表示并生成 再次显示一个xml输出，其中：

importxmlplain# Read the YAML filewithopen("example-1.yml")asinf:root=xmlplain.obj_from_yaml(inf)# Output back XMLwithopen("example-1.new.xml","w")asoutf:xmlplain.xml_from_obj(root,outf,pretty=True)

这将输出回以下XML（可能有 压痕和/或短空元素差异 原件：

<?xml version="1.0" encoding="UTF-8"?><example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured></structured><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

有关详细用法，请阅读api文档，其中包含：

pydoc xmlplain

或访问在线文档：https://guillon.github.io/xmlplan" rel="nofollow">https://guillon.github.io/xmlplan

安装

该模块与python 2.6/2.7和python 3.x兼容。

对于本地安装（安装到$home/.local）请执行：

pip install --user xmlplain

这将在您的用户环境中安装最新版本及其依赖项。

可选地在系统级安装：

sudo pip install xlmplain

来源

从以下版本下载此模块存档文件：https://github.com/guillon/xmlplan/releases" rel="nofollow">https://github.com/guillon/xmlplan/releases

或者克隆源git存储库，地址是：https://github.com/guillon/xmlplan" rel="nofollow">https://github.com/guillon/xmlplan

从源安装

使用以下命令安装第一个模块依赖项：

pip install --user setuptools PyYAML ordereddict

要么将xmlplan.py文件复制到某个地方，要么安装它 使用setup.py

对于用户本地安装（安装到$home/.local）请执行：

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>

<example><doc>This is an example for xmlobj documentation. </doc><contentversion="beta"><kind>document</kind><class>example</class><structured/><elements><item>Elt 1</item><doc>Elt 2</doc><item>Elt 3</item><doc>Elt 4</doc></elements></content></example>