Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Parser and converter for an alternate compact XML syntax.

Project description


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:output xml no

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

Instead of like this:

<xsl:stylesheet version="1.0" xmlns:xsl="">
<xsl:output method="xml" indent="no"/>

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


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.


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 install command should work to install the library.


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 in the source distribution which can be used for converting from/to compact xml syntax. See --help for usage information after installation.


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

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
compactxml-2.1.0-py2.7.egg (50.3 kB) Copy SHA256 hash SHA256 Egg 2.7
compactxml-2.1.0.tar.gz (73.0 kB) Copy SHA256 hash SHA256 Source None
compactxml-2.1.0.win32.exe (220.6 kB) Copy SHA256 hash SHA256 Windows Installer 2.7 (88.6 kB) Copy SHA256 hash SHA256 Source None

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page