ezodf2 0.2.10
A Python package to create/manipulate OpenDocumentFormat files.
License: MIT
Keywords: ODF,OpenDocumentFormat,OpenOffice,LibreOffice

Abstract
========

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

a simple example::

    from ezodf2 import newdoc, Paragraph, Heading, Sheet

    odt = newdoc(doctype='odt', filename='text.odt')
    odt.body += Heading("Chapter 1")
    odt.body += Paragraph("This is a paragraph.")
    odt.save()

    ods = newdoc(doctype='ods', filename='spreadsheet.ods')
    sheet = Sheet('SHEET', size=(10, 10))
    ods.sheets += sheet
    sheet['A1'].set_value("cell with text")
    sheet['B2'].set_value(3.141592)
    sheet['C3'].set_value(100, currency='USD')
    sheet['D4'].formula = "of:=SUM([.B2];[.C3])"
    pi = sheet[1, 1].value
    ods.save()

for more examples see: /examples folder

Continuous Integration Status
=============================

[![Build Status](https://travis-ci.org/iwschris/ezodf2.png)](https://travis-ci.org/iwschris/ezodf2.png)


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 platforms are: Python 2.7, 3.2, and 3.3.

Installation
============

with pip::

    pip install ezodf2

or from source::

    python setup.py install

Documentation
=============

http://github.com/iwschris/ezodf2 (for now, this will be changing soon.)

send feedback to chris@britecore.com

ezodf2 can be found on github at:

http://github.com/iwschris/ezodf2

History
=======
This package was originally created by Manfred Moitzi under the name ezodf (https://bitbucket.org/mozman/ezodf)


CHANGES
=======

Version 0.2.10 - July 2013

  * Alpha version
  * Changed to MIT License
  * tested: on Ubuntu 12.10 and 13.04 with python 2.7, 3.2, and 3.3

Version 0.2.9 - July 2013

  * Alpha version
  * Updated setup.py to be compatible with setuptools or distutils
  * Removed unecessary requirements
  * tested: on Ubuntu 12.10 and 13.04 with python 2.7, 3.2, and 3.3

Version 0.2.8 - July 2013

  * Alpha version
  * Updated setup.py to use setuptools
  * Updated setup.py requirements to use install_requires
  * Added distribute as a requirement
  * Fixed the lxml install problem
  * tested: on Ubuntu 12.10 and 13.04 with python 2.7, 3.2, and 3.3

Version 0.2.4 - June 2012

  * Alpha version
  * can open tables with many repeated rows/cols, 3 opening strategies are supported
  * tested: on Windows7 32 Bit with CPython 2.7 and CPython 3.2

Version 0.2.3 - January 2012

  * Alpha version
  * tested: on Windows7 32 Bit with CPython 2.7 and CPython 3.2

Version 0.2.2 - March 2011

  * Alpha version
  * Spreadsheet: added cell-span management
  * tested with Python 3.2 - OK
  * added tobytes() method to all document classes
  * opendoc() accept the zip-file content as 'bytes' instead of the filename
    as parameter 'filename'
  * newdoc() accept the zip-file content as 'bytes' instead of the filename
    as parameter 'template'

Version 0.2.1 - 06 February 2011

  * Alpha version
  * added basic spreadsheet support
  * Spreadsheet: added sheet, row, column and cell management

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 - ezodf2.opendoc(filename)
  * create new documents - ezdof.newdoc(doctype, filename, template)
  * Text: added Paragraph, Heading, Span, Hyperlink, List, Section objects

Version 0.1.0 - 02 January 2011

  * Pre-Alpha version
  * open/saveas ODF documents
  * modify meta data