Metadata-Version: 1.1
Name: openpack
Version: 1.1.2
Summary: UNKNOWN
Home-page: https://bitbucket.org/yougov/openpack
Author: Christian Wyglendowski (YouGov), Jason R. Coombs (YouGov)
Author-email: open.source@yougov.com
License: MIT
Description: Openpack
        ==============
        
        .. contents::
        
        Status and License
        ------------------
        
        ``openpack`` provides base functionality for working with the `Open
        Office XML (OOXML) <http://en.wikipedia.org/wiki/Office_Open_XML>`_
        format in Python.
        
        ``openpack`` is Copyright (c) 2010 by YouGov Plc. under `this license
        <http://bitbucket.org/yougov/openpack/raw/36514c7ce217/LICENSE>`_.
        
        Introduction
        ------------
        
        Openpack is a base library for OpenXML documents. It's used by the `paradocx
        <http://bitbucket.org/yougov/paradocx>`_ and `Xlsxcessive
        <https://bitbucket.org/dowski/xlsxcessive>`_.
        
        Utilities
        ---------
        
        Openpack includes two utilities for working with OpenXML documents from the
        command-line, `part-edit` and `zip-listdir`.
        
        zip-listdir
        ~~~~~~~~~~~
        
        `zip-listdir` isn't specific to OpenXML, and will work on any zip file.
        However, since OpenXML documents are themselves zip files, it's useful to have
        when working with OpenXML::
        
            > zip-listdir ..\paradocx\data.docx
              [Content_Types].xml
            d _rels
            d word
        
        `zip-listdir` lists the files and directories and can be used to list
        sub-directories as well::
        
            > zip-listdir ..\paradocx\data.docx/word
            d _rels
              document.xml
        
        part-edit
        ~~~~~~~~~
        
        While `zip-listdir` enables inspecting the structure of the zip content of
        an OpenXML document, `part-edit` facilitates editing the various parts of
        those documents using the client's text editor. For example, to edit the
        `word/document.xml` as found in data.docx from the previous example, simply
        invoke part-edit::
        
            > part-edit ..\paradocx\data.docx/word/document.xml
        
        The program will attempt to use the default text editor to edit the file. If
        the default editor is not sufficient, the user may specify an editor by
        setting either XML_EDITOR or EDITOR environment variables.
        
        `part-edit` will parse the zip file, locate the content within the zip file,
        extract that content to a temporary file, and then open that content in an
        editor. After the editor is closed, if the file was changed, the zip file
        will be updated with the new content.
        
        The user may pass the optional `--reformat-xml`, in which case the XML will
        be pretty-formatted for easier human readability.
        
        
        Changes
        -------
        
        For the list of changes, see `CHANGES in the repository
        <http://bitbucket.org/yougov/openpack/src/tip/CHANGES>`_.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
