openxmllib-py3 2.0.0

特点

公共API

这些例子说明了：

>>> import openxmllib
>>> doc = openxmllib.openXmlDocument(path='office.docx')
>>> # Raises a ValueError on not supported office files.
>>> doc.mimeType
'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
>>> doc.coreProperties # Keys may depend on application
{'title': u'blah...', u'creator': u'John Doe', ...}
>>> doc.extendedProperties # Keys may depend on application
{'Words': u'312', 'Application': u'Your favorite word processor', ...}
>>> doc.customProperties # May return an empty mapping
{'My property': u'My value', ...}
>>> doc.allProperties # Merges core+extended+custom properties (see above)
{...}
>>> doc.indexableText(include_properties=False)
u'all the words of that document body'
>>> doc.indexableText(include_properties=True)
u'all the words of that document body and all properties values'
>>> doc.documentCover()
('jpg', <open file '/var/folders/.../docProps/thumbnail.jpeg', mode 'rb' at 0x1af300>)

标准mimetypes包扩展

文件工厂签名：

>>> # We have the path for the office file
>>> doc = openxmllib.openXmlDocument(path='office.docx')
>>> # We have a file object for the office file
>>> fh = open('office.docx', 'rb')
>>> doc = openxmllib.openXmlDocument(file_='office.docx')
>>> # We have the URL for the office file
>>> doc = openxmllib.openXmlDocument(url='http://domain.tld/office.docx')
>>> # Xe have the raw data of the office file
>>> import mimetypes
>>> docx_mimetype = mimetypes.guess_type('office.docx')
>>> body = open('office.docx', 'rb').read()
>>> doc = open(data=body, mime_type=docx_mimetype)

请注意，如果您没有运行Python应用程序，您可能会得到索引 包含的文档中的文本openxmlinfo.py控制台实用程序。只需输入：

$ openxmlinfo --help

复制和许可

版权所有（c）2008 Gilles Lenfant

本软件受GNU公众条款的约束 许可证，2.0版（GPL）。应随附GPL副本 分配。此软件按“原样”提供 明示或默示的保证被否认，包括但不 仅限于对所有权、适销性的默示保证， 反对侵权，以及对特定目的的适用性

有关此包中包含的COPYING文件的更多详细信息。在

状态

从2.0版开始，这个包在Linux上使用Python3.8.x进行测试。 如果可以满足依赖关系，那么它很可能也适用于其他环境。在

安装

使用常用的setuptools命令：

$ pip install openxmllib-py3

注意，这将安装优秀的lxml鸡蛋，如果还没有完成。在

从现在起，您可以在Python应用程序中“导入openxmllib”并使用 “openxmlinfo”命令行实用程序。在

Gotchas

请注意，大多数文本数据都来自各种openxmllib 服务可以是us ascii或Unicode。这是lxml的副作用 （bug还是功能？）。转换这些文本取决于您的应用程序 到适当的字符集。在

实际上，我们并不处理由于XML格式错误或 意外的结构。你应该处理各种（潜在的） 应用程序中try（…）except（…）块中的问题。在

开发和测试

您应该从位于https://github.com/wilbertom/openxmllib-py3的存储库中获取openxmllib。在

然后：

$ cd /where/you/installed/openxmllib
$ python setup.py develop

请注意，测试不需要安装：

$ cd tests
$ python runalltests.py

支持

使用project site提供的问题跟踪器。在

学分

• 吉勒·伦芬特[吉尔斯·伦芬特]<；gilles dot lenfant在gmail.com>
• 凯文·德尔迪克[凯文·德尔迪克]<；kevin在deldycke dot com>
• 雨果·洛佩斯·塔瓦雷斯[hltbra]<；hltbra at gmail dot com>
• Petri Savolainen[Petri]<；Petri dot Savolainen at koodaamo dot fi>
• 埃里克·沃恩利希[ewohnlich]<；https://github.com/ewohnlich>
• 威尔伯托•莫拉莱斯【威尔伯托姆】<；https://github.com/wilbertom/>