Adding upstream version 0.19.2.upstream/0.19.2upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 24 insertions, 0 deletions

diff --git a/doc/python/orcus/ods/index.rst b/doc/python/orcus/ods/index.rst
new file mode 100644
index 0000000..1dac00e
--- /dev/null
+++ b/doc/python/orcus/ods/index.rst
@@ -0,0 +1,24 @@
+
+orcus.ods
+==========
+
+.. py:function:: orcus.ods.read
+
+   Read an Open Document Spreadsheet file from a specified file path and create
+   a :py:class:`orcus.Document` instance object.
+
+   :param stream: file object containing byte streams.
+   :param bool recalc: optional parameter specifying whether or not to recalculate
+       the formula cells on load. Defaults to ``False``.
+   :param str error_policy: optional parameter indicating what to do when
+       encountering formula cells with invalid formula expressions. The value
+       must be either ``fail`` or ``skip``.  Defaults to ``fail``.
+   :rtype: :py:class:`orcus.Document`
+   :return: document instance object that stores the content of the file.
+
+   Example::
+
+      from orcus import ods
+
+      with open("path/to/file.ods", "rb") as f:
+          doc = ods.read(f, recalc=True, error_policy="fail")