This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Parser and converter for an alternate compact XML syntax.

Project Description

Summary

Compact XML is an alternative syntax for representing XML files. It uses indentation to indicate nesting to give a python like feel, XPath based prefixes to identify nodes, and has a macro system to shorten common XML constructs. It is intended for writing element based XML files, especially those where the XML elements share a common structure such as XSLT files.

This package includes a parser and bidirectional converter for converting from this compact XML syntax to XML, and from XML to this compact XML syntax.

Why Do I Want This?

Unlike most projects to create a shorter XML, compact XML is not designed for compressing XML on the wire. Instead, this syntax is designed to make editing XML easier with common editors, and to provide a convenient, configurable shorthand when authoring XML documents with a common syntax.

If you spend all day writing XSLT files or something similar, this will let you work with source files that look like this:

xsl:stylesheet
        xsl:output xml no

        xsl:template "@* | node( )"
                xsl:copy
                        xsl:apply-templates "@* | node( )"

Instead of like this:

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="no"/>

<xsl:template match="@* | node( )">
        <xsl:copy>
                <xsl:apply-templates select="@* | node( )"/>
        </xsl:copy>
</xsl:template>

</xsl:stylesheet>

If you’re integrating with a python based program, the parser can be built in and parse compact XML files to XML directly. Otherwise a simple command line utility is included that can be used inside make or equivalent to convert to XML as part of your build process.

Install

compactxml is a pure python library, and should be platform independent. It has been developed and tested on python 2.6 on linux, however. As dependencies, it requires that lxml and pyparsing be installed to function.

A normal python setup.py install command should work to install the library.

Usage

There is a compactxml.expand function for converting from compact XML syntax to XML, and a compactxml.compact function for converting from XML to compact XML syntax, with variations on both depending on the output format desired. help( compactxml ) will give better usage instructions, and the included documentation in compactxml.rst provides a comprehensive overview of the compact xml syntax.

Any errors in expansion or compaction are raised as compactxml.ParsingError.

There is also a command line utility compactxml.py in the source distribution which can be used for converting from/to compact xml syntax. See compactxml.py --help for usage information after installation.

Documentation

Detailed documentation of the compact XML format is available through the python package index, including a tutorial for new users.

Release History

Release History

This version
History Node

2.1.0

History Node

2.0.5

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

1.1.2

History Node

1.1.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
compactxml-2.1.0-py2.7.egg (50.3 kB) Copy SHA256 Checksum SHA256 2.7 Egg Feb 7, 2011
compactxml-2.1.0.tar.gz (73.0 kB) Copy SHA256 Checksum SHA256 Source Feb 7, 2011
compactxml-2.1.0.win32.exe (220.6 kB) Copy SHA256 Checksum SHA256 2.7 Windows Installer Feb 7, 2011
compactxml-2.1.0.zip (88.6 kB) Copy SHA256 Checksum SHA256 Source Feb 7, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting