|OOo Extensions project
Please view the wiki usage guidelines
|Extensions on the main site|
Python and OpenOffice.org
OpenOffice.org ships with a python scripting language on it's versions 2.3.4. This Python distribution comes with the Uno module which connects the UNO API with the python scripting language. To run this version of Python on Linux you can go to the direct OpenOffice.org PATH. OOo-Python can be run from the command line as well as you might expect with any other distribution of Python.
Where is the IDE ?
OpenOffice.org's IDE doesn't support Python, so development have to be done from other editor that does. Any volunteer for a binding is welcommed
Tips & Tricks
Here are some usefull information, helping using python in OOo
If you launch a python script, any error will silently break the execution and your extension will be hard to debug. To change this behaviour, one can change the LogLevel
Have a look in /path/to/ooo/program/pythonscript.py and replace LogLevel.use = LogLevel.NONE with LogLevel.use = LogLevel.DEBUG
There are also currently undocumented environment variables, which tell the pyUno bridge to log every call, set therefor the environment variable export PYUNO_LOGLEVEL=ARGS , the output is a little hard to read, but helpful during development.
This holds for unix, for windows you need some more switches and the output gets written to files (no stdout on windows :-( ).
Some error messages still don't appear in these logs, this will improve in near future (cws pyunofixes4). Once the cws is integrated, I will document these switches on the official pyuno site.
Thanks to Joerg Budischewski
Python specific information for Extension creation
To create extensions for python is important that you have enough relation with the UNO components as well as packaging your code to be able to easily distribute your scripts through the OpenOffice.org package manager. Please check up the tutorials on how to componentize your code as well as how to deploy remote scripting through a service implementation.
To learn to run Python on Windows you could visit this link for more detail information.
- Using Python on Windows - New to Python? Learn how to use python on Windows
- Using Python on Linux - A must read for an overwiew on Python and OOo relations
- pyUNO bridge - Official page of the PyUNO bridge at the UDK site
- Python as a macro language in OpenOffice.org 2.x - How to use the Python scripting framework
- Introduction on testing pyUNO programs with doctests
- Setting up Python-bridge on Debian - How to install and activate the PyUNO in a Debian box.
- Create a dialog box in PyUNO.
- Connect to openoffice.org from PyUNO
- PyUNO samples currently shipping with OpenOffice.org and the explanation.
- Danny's Python Modules - Collection guide from DannyB's modules.
- PrinttoWriter.py - This makes it easy and convenient to print a bunch of text into a Writer document.
- Developing Calc Funcions in Python - Learn how Python can be used to script your spreadsheets
- Generating a Spreadsheet through Python - Automatically generate new spreadsheets
- Python container components
- PyUNOServer - The PyUNOServer is a script that works as an XML server for OpenOffice.org Calc
- calcParser - calcParser is a small parser using the native SAX utilities within the OpenOffice.org python
- UNO component packaging - How to create UNO components as well as the basics of script componentizing
- Python component to parse XML - Python is great to parse XML, PyUNO is also excellent when working with XML
- Example of Service in Python - Learn how to run Python as a service, this is useful for remote scripting.
- Modify spreadsheet - Example of storing and retrieving a custom attribute on a spreadsheet cell.
- A simple daemon in Python - Learn how to run Python as a daemon
- Loook.py - a simple Python tool that searches for text strings in OpenOffice.org.
- odt2txt.py - convert ODF to plain text using python (and convert the txt to html).