Skip to main content

openpack

Project description

https://img.shields.io/pypi/v/openpack.svg https://img.shields.io/pypi/pyversions/openpack.svg https://img.shields.io/travis/yougov/openpack/master.svg https://readthedocs.org/projects/openpack/badge/?version=latest

Status

openpack provides base functionality for working with the Open Office XML (OOXML) format in Python.

Introduction

Openpack is a base library for OpenXML documents. It’s used by the paradocx and Xlsxcessive.

Utilities

Openpack includes two utilities for working with OpenXML documents from the command-line, part-edit and zip-listdir.

These commands are additionally exposed as modules and may be invoked using python -m, e.g. python -m openpack.part-edit.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
openpack-2.1.1-py2.py3-none-any.whl (16.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Nov 12, 2017
openpack-2.1.1.tar.gz (91.7 kB) Copy SHA256 hash SHA256 Source None Nov 12, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page