ezodf 0.2.0

Abstract

ezodf is a Python package to create new or open existing OpenDocument (ODF) files to extract, add, modify or delete document data.

a simple example:

import ezodf
from ezodf import Paragraph, Heading

odt = ezodf.newdoc(doctype='odt', filename='text.odt')
paragraph = Paragraph("This is a paragraph. ")
# document content resides in the body object
odt.body.append(paragraph)
paragraph.append_text("This is another sentence.\nNormal usage of line breaks.")
# insert new heading before 'paragraph'
odt.body.insert_before(paragraph, Heading("Chapter 1"))
odt.save()

from ezodf import Sheet

# this ODS example doesn't work yet
ods = ezodf.newdoc(doctype='ods', filename='spreadsheet.ods')
# document content resides in the body object
sheet = ods.body.append(Sheet('SHEET'))
sheet[0, 0] = Paragraph("Textcell")
ods.save()

for more examples see: /examples folder

Dependencies

• lxml <http://codespeak.net/lxml/> for painless serialisation with prefix declaration (xlmns:prefix=”global:namespace:specifier”) in the root element. Declarations for unused prefixes are also possible.

The target platform is Python 3.1+, no Python 2 support planned at this time.

Installation

with pip:

pip install ezodf

or from source:

python setup.py install

Documentation

http://packages.python.org/ezodf

send feedback to mozman@gmx.at

ezodf can be found on bitbucket.org at:

http://bitbucket.org/mozman/ezodf

NEWS

Version 0.1.0 - 02 January 2011

• Pre-Alpha version

• open/saveas ODF documents

• modify meta data

Version 0.2.0 - 18 January 2011

• Alpha version

• create new empty odt, ods, odp, odg file

• added template support - can create ott, ots, otp, otg files

• open documents - ezodf.opendoc(filename)

• create new documents - ezdof.newdoc(doctype, filename, template)

• Text: added Paragraph, Heading, Span, Hyperlink, List, Section objects