Skip to main content

Split an XML document by milestone element.

Project description

This is useful for XML files containing multiple hierarchies.


One example is an XML dialect called TEI which might have been created to represent a book using chapters (div elements) but you want to use the text by page (pb element).

Imagine an XML file called myfile.xml that contains milestone elements <pb/> dotted throughout the XML.

The following command will split the input file into separate output files for each pb element:

python3 -t pb myfile.xml

Or if you have installed the module through pip, you can use:

python3 -m milestone -b pb myfile.xml

The above commands will name the output files with integers.

Now imagine that the <pb> elements have an attribute called ‘n’ that we want to use for the name of each output file.

The following command will split the input file into separate output files, named according to the ‘n’ attribute:

python3 -t pb -n n myfile.xml

If you want to transform the hierarchy but not split the data into separate files, you can use the -x flag:

python3 -x -t pb -n n myfile.xml > outputfile.xml

To use this as a library in your own code, import the Milestone class:

from milestone import Milestone

To share ideas or improvements, please visit the github project at:

Project details

Download files

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

Source Distribution

milestone-0.2.tar.gz (5.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page