Metadata-Version: 1.1
Name: docxcompose
Version: 1.0.0a11
Summary: Compose .docx documents
Home-page: https://github.com/4teamwork/docxcompose
Author: Thomas Buchberger
Author-email: t.buchberger@4teamwork.ch
License: GPL version 2
Description: 
        *docxcompose* is a Python library for concatenating/appending Microsoft
        Word (.docx) files.
        
        
        Example usage
        -------------
        
        Append a document to another document:
        
        .. code::
        
            from docxcompose.composer import Composer
            from docx import Document
            master = Document("master.docx")
            composer = Composer(master)
            doc1 = Document("doc1.docx")
            composer.append(doc1)
            composer.save("combined.docx")
        
        
        The docxcompose console script
        ------------------------------
        
        
        The ``docxcompose`` console script allows to compose docx files form the command
        line, e.g.:
        
        .. code:: sh
        
            $ docxcompose files/master.docx files/content.docx -o files/composed.docx
        
        
        A note about testing
        --------------------
        
        The tests provide helpers for blackbox testing that can compare whole word
        files. To do so the following files should be provided:
        
        - a file for the expected output that should be added to the folder
          `docs/composed_fixture`
        - multiple files that can be composed into the file above should be added
          to the folder `docs`.
        
        The expected output can now be tested as follows:
        
        
        .. code:: python
        
            def test_example():
                fixture = FixtureDocument("expected.docx")
                composed = ComposedDocument("master.docx", "slave1.docx", "slave2.docx")
                assert fixture == composed
        
        
        Should the assertion fail the output file will be stored in the folder
        `docs/composed_debug` with the filename of the fixture file, `expected.docx`
        in case of this example.
        
        Changelog
        =========
        
        
        1.0.0a11 (2018-07-30)
        ---------------------
        
        - Fix handling of section type. 
          [buchi]
        
        - Fix an issue where the listing style of the first element was different.
          [deiferni]
        
        - Fix issue when restarting intermittent numbering.
          [deiferni]
        
        
        1.0.0a10 (2018-07-18)
        ---------------------
        
        - Add console script command to compose two or more word files.
          [deiferni]
        
        
        1.0.0a9 (2018-05-01)
        --------------------
        
        - Fix error in mapping of num_ids introduced in 1.0.0.a7.
          [buchi]
        
        - Do not fail when numbering zero is referenced.
          [deiferni]
        
        
        1.0.0a8 (2018-04-26)
        --------------------
        
        - Only attempt to set the nsid when it is available.
          [deiferni]
        
        
        1.0.0a7 (2018-04-20)
        --------------------
        
        - Fix handling of images in WordprocessingGroups (<wpg:wpg>).
          [buchi]
        
        - Fix handling of shapes in shape groups (<v:group>).
          [buchi]
        
        - Fix handling of numberings, avoid inserting multiple numbering properties.
          [buchi]
        
        - Fix renumbering of bookmarks.
          [buchi]
        
        - Renumber ids of drawing object properties (<wp:docPr>).
          [buchi]
        
        
        1.0.0a6 (2018-02-20)
        --------------------
        
        - Do not restart numbering of bullets.
          [buchi]
        
        
        1.0.0a5 (2018-01-11)
        --------------------
        
        - Renumber bookmarks to avoid duplicate ids.
          [buchi]
        
        - Add support for shapes.
          [buchi]
        
        
        1.0.0a4 (2017-12-27)
        --------------------
        
        - Fix handling of styles when composing documents with different languages.
          [buchi]
        
        - Also add numberings referenced in styles.
          [buchi]
        
        - Avoid having multiple <w:abstractNum> elements for the same style.
          [buchi]
        
        - Restart first numbering of inserted documents
          [buchi]
        
        - Add support for anchored images.
          [buchi]
        
        - Handle referenced style ids that are not defined in styles.xml
          [buchi]
        
        - Remove header and footer references in paragraph properties.
          [buchi]
        
        
        1.0.0a3 (2017-11-22)
        --------------------
        
        - Make removal of property fields optional.
          [buchi]
        
        
        1.0.0a2 (2017-11-06)
        --------------------
        
        - Fix handling of footnotes containing hyperlinks.
          [buchi]
        
        - Add functionality to deal with custom document properties. Properties can be
          updated and fields containing properties can be removed. When appending or
          inserting documents their custom document properties get removed automatically.
          [buchi]
        
        
        1.0.0a1 (2017-09-13)
        --------------------
        
        - Initial release
          [buchi]
        
Keywords: Python DOCX Word OOXML
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
