text: # Copyright 2018-2020 Jérôme Dumonteil
  # Copyright (c) 2009-2010 Ars Aperta, Itaapy, Pierlis, Talend.
  #
  # Licensed under the Apache License, Version 2.0 (the "License");
  # you may not use this file except in compliance with the License.
  # You may obtain a copy of the License at
  #
  #     http://www.apache.org/licenses/LICENSE-2.0
  #
  # Unless required by applicable law or agreed to in writing, software
  # distributed under the License is distributed on an "AS IS" BASIS,
  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  # See the License for the specific language governing permissions and
  # limitations under the License.
  #
  #
  # Authors (odfdo project): jerome.dumonteil@gmail.com
  # The odfdo project is a derivative work of the lpod-python project:
  # https://github.com/lpod/lpod-python
  # Authors: David Versmisse <david.versmisse@itaapy.com>
  #          Hervé Cauwelier <herve@itaapy.com>
  #          Romain Gauthier <romain@itaapy.com>
  """# odfdo
  python library for OpenDocument format (ODF)
  
  
  ![logo](./odfdo.png)
  
  odfdo is a Python3 library implementing the ISO/IEC 26300 OpenDocument Format
  standard.
  
  project:
      https://github.com/jdum/odfdo
  
  author:
      jerome.dumonteil@gmail.com
  
  licence:
      Apache License, Version 2.0
  
  odfdo is a derivative work of the lpod-python project.
  
  
  installation
  ============
  
  
      sudo python setup.py install
  
  
  after installation you can check everything is working:
      
      
      `cd test && python test.py`
      
  
  test should run for a few seconds and issue no error.
  
  
  usage
  =====
  
  
      from odfdo import Document, Paragraph
  
      doc = Document('text')
      doc.body.append(Paragraph("Hello world!"))
      doc.save("hello.odt")
  
  
  tl;dr
  =====
  
  'Intended Audience :: Developers'
  
  
  documentation
  =============
  
   - the "recipes" folder contains more than 50 working sample scripts,
   - the "scripts" folder contains some useful scripts (like style management),
   - the "doc" folder contains auto generated documentation.
  
  styles: the best way to apply style is by merging styles from a template
  document into your generated document. See odfdo-style.py in "scripts" folder.
  
  
  limitations
  ===========
  
  odfdo is intended to facilitate the generation of ODF documents,
  nevertheless a basic knowledge of the ODF format is necessary.
  
  ODF document rendering can vary greatly from software to software. In
  particular the "styles" of the document allow an adaptation of the rendering
  for a particular software.
  
  the best (only ?) way to apply style is by merging styles from a template
  document into your generated document. See odfdo-style.py in "scripts" folder.
  
  
  changes from former lpod library
  ================================
  lpod-python was written in 2009-2010 as a python2 library,
  see: https://github.com/lpod/lpod-python
  
  odfdo main changes from lpod:
  
   - odfdo requires python version >= 3.6
   - API change: more pythonic
   - include recipes
   - use only Apache 2.0 license
  """
  __all__ = (
      "Bookmark BookmarkStart BookmarkEnd Container Content Content "
      "Document DrawPage Element Text FIRST_CHILD LAST_CHILD NEXT_SIBLING "
      "PREV_SIBLING Frame default_frame_position_style Header DrawImage "
      "DrawFillImage Link ListItem List Manifest Meta Note Annotation "
      "AnnotationEnd Spacer Tab LineBreak Span Paragraph Reference "
      "ReferenceMark ReferenceMarkStart ReferenceMarkEnd Section "
      "ConnectorShape DrawGroup LineShape RectangleShape EllipseShape "
      "AnimPar AnimSeq AnimTransFilter default_boolean_style "
      "default_currency_style default_number_style default_percentage_style "
      "default_time_style default_date_style make_table_cell_border_string "
      "create_table_cell_style Style BackgroundImage rgb2hex hex2rgb Styles "
      "ChangeInfo TextInsertion TextDeletion TextFormatChange "
      "TextChangedRegion TrackedChanges TextChange TextChangeEnd "
      "TextChangeStart Cell Row Column Table HeaderRows RowGroup NamedRange "
      "IndexTitleTemplate default_toc_level_style TOC IndexTitle "
      "TocEntryTemplate TabStopStyle UserFieldDecl UserFieldGet "
      "UserFieldInput UserDefined VarChapter VarFileName VarInitialCreator "
      "VarCreationDate VarCreationTime VarDescription VarDecls VarDecl "
      "VarSet VarGet UserFieldDecls VarPageNumber VarPageCount VarDate "
      "VarTime VarTitle VarSubject VarKeywords XmlPart"
  ).split()
  
  from .version import __version__
  from .bookmark import Bookmark, BookmarkStart, BookmarkEnd
  from .container import Container
  from .content import Content
  from .document import Document
  from .draw_page import DrawPage
  from .element import Element, Text, FIRST_CHILD, LAST_CHILD, NEXT_SIBLING, PREV_SIBLING
  from .frame import Frame, default_frame_position_style
  from .header import Header
  from .image import DrawImage, DrawFillImage
  from .link import Link
  from .list import ListItem, List
  from .manifest import Manifest
  from .meta import Meta
  from .note import Note, Annotation, AnnotationEnd
  from .paragraph import Span, Paragraph, Spacer, Tab, LineBreak
  from .reference import Reference, ReferenceMark, ReferenceMarkStart, ReferenceMarkEnd
  from .section import Section
  from .shapes import ConnectorShape, DrawGroup, LineShape, RectangleShape, EllipseShape
  from .smil import AnimPar, AnimSeq, AnimTransFilter
  from .style import (
      Style,
      default_boolean_style,
      default_currency_style,
      default_number_style,
      default_percentage_style,
      default_time_style,
      default_date_style,
      make_table_cell_border_string,
      create_table_cell_style,
      BackgroundImage,
      rgb2hex,
      hex2rgb,
  )
  from .styles import Styles
  from .tracked_changes import (
      ChangeInfo,
      TextInsertion,
      TextDeletion,
      TextFormatChange,
      TextChangedRegion,
      TrackedChanges,
      TextChange,
      TextChangeEnd,
      TextChangeStart,
  )
  from .table import Cell, Row, Column, Table, HeaderRows, RowGroup, NamedRange
  from .toc import (
      TOC,
      IndexTitleTemplate,
      default_toc_level_style,
      IndexTitle,
      TocEntryTemplate,
      TabStopStyle,
  )
  from .variable import (
      UserFieldDecl,
      UserFieldGet,
      UserFieldInput,
      UserDefined,
      VarChapter,
      VarFileName,
      VarInitialCreator,
      VarCreationDate,
      VarCreationTime,
      VarDescription,
      VarDecls,
      VarDecl,
      VarSet,
      VarGet,
      UserFieldDecls,
      VarPageNumber,
      VarPageCount,
      VarDate,
      VarTime,
      VarTitle,
      VarSubject,
      VarKeywords,
  )
  from .xmlpart import XmlPart
  