unotools 0.3.3

如何安装

$ sudo aptitude install -y libreoffice libreoffice-script-provider-python uno-libs3 python3-uno python3

$ sudo aptitude install -y virtualenvwrapper
$ mkvirtualenv -p /usr/bin/python3.4 --system-site-packages tmp3

(tmp3)$ python
Python 3.4.0 (default, Apr 11 2014, 13:05:11)
[GCC 4.8.2] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import uno

(tmp3)$ pip install unotools

$ hg clone ssh://hg@bitbucket.org/t2y/unotools

$ hg clone ssh://hg@bitbucket.org/ambv/singledispatch

$ export PYTHONPATH="/path/to/singledispatch/:/path/to/unotools/"

$ /Applications/LibreOffice.app/Contents/MacOS/soffice --version
LibreOffice 4.4.0.3 de093506bcdc5fafd9023ee680b8c60e3e0645d7

$ /Applications/LibreOffice.app/Contents/MacOS/python
Python 3.3.5 (default, Jan 22 2015, 17:12:45)
[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.51)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import unotools

如何使用（在Ubuntu 14.04上）

启动libreoffice

(tmp3)$ soffice --accept='socket,host=localhost,port=8100;urp;StarOffice.Service'

从https://bitbucket.org/t2y/unotools/raw/default/sample-scripts下载示例脚本

(tmp3)$ python sample-scripts/writer-sample1.py -s localhost
(tmp3)$ python sample-scripts/calc-sample1.py -s localhost -d sample-scripts/datadir/
(tmp3)$ ls
sample-calc.html  sample-calc.pdf  sample-calc_html_eaf26d01.png
sample-scripts  sample-writer.html  sample-writer.pdf
sample.csv  sample.doc  sample.ods  sample.odt  sample.xls

有一个将odt/ods转换为pdf的示例脚本。

(tmp3)$ python sample-scripts/pdf-convert-sample1.py -s localhost -f sample.odt
(tmp3)$ python sample-scripts/pdf-convert-sample1.py -s localhost -f sample.ods
(tmp3)$ ls sample.pdf

查看这些示例脚本，然后它将帮助您使用unotools。

逐步与解释器交互

使用UNO与文档交互，让你学会如何使用unotools。

启动LibreOffice

$ soffice --accept='socket,host=localhost,port=8100;urp;StarOffice.Service'

>>> from unotools import Socket, connect
>>> from unotools.component.writer import Writer
>>> context = connect(Socket('localhost', 8100))
>>> writer = Writer(context)

现在，你可以在LibreOffice中看到新的文档窗口。

>>> writer.set_string_to_end('Hello\n')
>>> writer.set_string_to_end('World\n')

然后，将《Hello》和《World》放入文档窗口。

>>> text = writer.text
>>> text
<unotools.component.writer.Text object at 0x1064a8e10>

Writer继承XTextRange接口并具有这些方法。为了充分利用unotools，你必须理解UNO API。

有一个技巧可以确认组件中存在哪些方法。_show_attributes()是一个unotools组件继承的辅助方法。

>>> text._show_attributes()
[ ...
 'getElementType',
 'getEnd',
 'getImplementationId',
 'getImplementationName',
 'getPropertySetInfo',
 'getPropertyValue',
 'getSomething',
 'getStart',
 'getString',
 'getSupportedServiceNames',
 'getText',
 'getTypes',
  ...
]

尽管这些方法是大驼峰命名法，但你也可以调用Python风格的命名方法。

>>> text.getString()
'Hello\nWorld\n'

>>> text.get_string()
'Hello\nWorld\n'

这两个方法相同，unotools组件将Python风格的方法转换为原始方法。

让我们将此文档保存为odt。

>>> from unotools.unohelper import convert_path_to_url
>>> url = convert_path_to_url('./test1.odt')
>>> url
'file:///Users/t2y/work/repo/unotools/test1.odt'
>>> writer.store_to_url(url, 'FilterName', 'writer8')
>>> writer.close(True)

如果你想读取文件系统上的OpenDocument，就像这样。

>>> writer = Writer(context, convert_path_to_url('./test1.odt'))

更改日志