跳转到主要内容

Kids XML库。

项目描述

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

kids.xml是一个Python库,提供在Python中编写xml时的一些辅助工具。

它是“Kids”(为了保持简单)库的一部分。

成熟度

此代码处于alpha阶段。它尚未在Windows上进行测试。API可能会更改。这是一个正在进行中的反思的草案。

我应该补充的是,这可能尚未准备好展示。尽管如此,这些功能中的许多每天都在我的项目中使用,我为每个项目重新编写它们感到厌烦。

功能

使用 kids.xml

  • xml2string实际上可以正常工作。

兼容性

此代码为python2和python3兼容。它尚未在Windows上进行测试。

安装

您不需要下载代码的GIT版本,因为kids.xml已在PyPI上提供。因此,您应该能够运行

pip install kids.xml

如果您已下载GIT源代码,则可以通过传统方式安装当前版本

python setup.py install

如果您没有GIT源代码,但希望从GitHub获取最新的master分支或分支,您也可以

pip install git+https://github.com/0k/kids.xml

甚至选择特定的修订版(分支/标签/提交)

pip install git+https://github.com/0k/kids.xml@master

使用方法

>>> from kids.file import tmpfile, rm
>>> f = tmpfile('<a x="2">Hi</a>')

加载

将从XML文件中加载内容

>>> from kids.xml import load

>>> xml = load(f)
>>> rm(f)
>>> xml
<Element a at ...>

xml2string

将以字符串形式输出XML对象的内容(来自lxml的ElementTree)

>>> from __future__ import print_function
>>> from kids.xml import xml2string

>>> print(xml2string(xml))
<?xml version="1.0" encoding="utf-8"?>
<a x="2">Hi</a>

请注意,内容已进行代码检查。

xmlize

将解析一个字符串并返回XML ElementTree

>>> from kids.xml import xmlize

>>> xmlize('<a x="2">Hi</a>')
<Element a at ...>

quote

您可以将kids.xml用作简单快捷的xml函数的快捷方式

>>> from kids.xml import quote_attr, quote_value

如果您必须将值插入属性中,您可以使用此方法来引用它

>>> print(quote_attr("It's called \"Smith & Wesson\""))
"It's called &quot;Smith &amp; Wesson&quot;"

如果您需要在XML中插入纯文本,可以使用这个方法

>>> print(quote_value("It's called \"Smith & Wesson\""))
It's called "Smith &amp; Wesson"

贡献

任何建议或问题都欢迎。非常欢迎推送请求,请查看指南。

推送请求指南

您可以发送任何代码。我会查看它,并在代码库中自行集成,并保留您作为作者。这个过程可能需要一些时间,如果您遵循以下指南,将节省时间

  • 使用PEP8或pylint检查您的代码。尽量保持80列宽。

  • 将您的提交按最小关注点分开。

  • 每个提交都应该通过测试(以便易于二分查找)

  • 每个功能/错误修复提交应包含代码、测试和文档。

  • 优先进行小的提交,例如排版或代码美学更改,非常欢迎。这些应该在其提交摘要中用!minor标记。

  • 提交信息应遵循gitchangelog规则(检查git log以获取示例)

  • 如果提交修复了问题或完成了功能的实现,请在摘要中说明。

如果您对这里未解答的指南有任何疑问,请查看当前的git log,您可能会找到以前提交的示例,说明如何处理您的问题。

许可证

版权(c)2015 Valentin Lab。

BSD许可证下授权。

变更日志

0.0.1 (2015-02-05)

  • 首次导入。[Valentin Lab]

项目详情


下载文件

下载适合您平台的项目。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分布

kids.xml-0.0.1.tar.gz (5.5 kB 查看哈希值)

上传时间 源代码

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面