Odio

一个用于导入/导出ODF文档（.ods和.odt）的纯Python库。

安装

• 创建虚拟环境：python3 -m venv venv
• 激活虚拟环境：source venv/bin/activate
• 安装：pip install odio

快速入门

创建电子表格

>>> import odio
>>> import datetime
>>> 
>>>
>>> # Create the spreadsheet.
>>> # Version is ODF version. Can be '1.1' or '1.2'. The default is '1.2'.
>>> # Default for 'compressed' is True.
>>> with open('test.ods', 'wb') as f, odio.create_spreadsheet(
...         f, version='1.2', compressed=True) as sheet:
...	
...	# Add a table (tab) to the spreadsheet
... 	sheet.append_table(
...         'Plan',
...         [
...             [
...                 "veni, vidi, vici", 0.3, 5, odio.Formula('=B1 + C1'),
...                 datetime.datetime(2015, 6, 30, 16, 38),
...             ],
...         ]
...     )

导入电子表格

>>> import odio
>>>
>>>
>>> # Parse the document we just created.
>>> # Version is ODF version. Can be '1.1' or '1.2'. The default is '1.2'.
>>> with open('test.ods', 'rb') as f:
...     sheet = odio.parse_spreadsheet(f)
>>>
>>> table = sheet.tables[0]
>>> print(table.name)
Plan
>>> for row in table.rows:
...     print(row)
['veni, vidi, vici', 0.3, 5.0, odio.Formula('=B1 + C1'), datetime.datetime(2015, 6, 30, 16, 38)]

创建文本文档

>>> from odio import create_text, P, H, Span
>>> 
>>>
>>> # Create the text document. The ODF version string can be '1.2' or '1.1'
>>> with open('test.odt', 'wb') as f, create_text(f, '1.2') as txt:
...	
...     txt.append(
...         P("The Meditations", text_style_name='Title'),
...         H("Book One", text_style_name='Heading 1'),
...         P(
...             "From my grandfather ",
...             Span("Verus", text_style_name='Strong Emphasis'),
...             " I learned good morals and the government of my temper."
...         ),
...         P(
...             "From the reputation and remembrance of my father, "
...             "modesty and a ", Span("manly", text_style_name='Emphasis'),
...             " character."
...         )
...      )

解析文本文档

>>> import odio
>>>
>>>
>>> # Parse the text document we just created. Can be ODF 1.1 or 1.2 format.
>>> txt = odio.parse_text(open('test.odt', "rb"))
>>> 
>>> # Find a subnode
>>> subnode = txt.nodes[2] 
>>> print(subnode.name)
text:p
>>> print(subnode.attributes['text_style_name'])
Text Body
>>> print(subnode)
odio.P(' From my grandfather ', odio.Span('Verus', text_style_name='Strong Emphasis'), ' I learned good morals and the government of my temper. ')

回归测试

• 安装tox：pip install tox
• 运行tox：tox

发布Odio

运行tox确保所有测试通过，然后更新发布说明，然后执行：

• git tag -a x.y.z -m "版本 x.y.z"
• rm -r build; rm -r dist
• python -m build
• twine upload --sign dist/*

发布说明

版本 0.0.23，2024-05-22

• 在写入电子表格时，将decimal.Decimal解释为数字。

版本 0.0.22，2021-02-08

• 将<text:line-break/>替换为换行符。

版本 0.0.21，2021-02-05

• 查找文本不应该导致返回值为 None。

版本 0.0.20，2021-02-04

• 文本应出现在单元格内的 <text:p> 元素的content中。

版本 0.0.19，2021-02-04

• 在文本元素的content中出现换行符时，现在它们被替换为 <text:line-break/> 元素。这意味着换行符现在在电子表格中显示，而之前则不会。

版本 0.0.18，2019-11-29

• 性能改进：而不是使用 xml.sax.saxutils 版本的 escape 和 quoteattr，我已经将它们复制到Odio的源代码中，但删除了不需要的实体代码。

版本 0.0.17，2018-08-19

• 当解析文本类型的电子表格单元格时，如果值不在属性中，则递归地使用元素内容中的下一个节点。