Skip to main content

A Python interface to xmlsq.

Project description

The utility xmlsq performs simple and full XPath 1.0 queries on an XML document.

>>> import xmlsq
>>> xml = r"<a><b foo='baz'>hello</b><b>world</b><e /></a>"
>>> xmlsq.get_text(xml, "//b")
>>> xmlsq.get_text(xml, "//b[2]")
>>> xmlsq.full_query(xml, "//b")
'<b foo="baz">hello</b>\n<b>world</b>\n'
>>> xmlsq.get_text(xml, "//b/@foo")
>>> xmlsq.full_query(xml, "//b/@foo")
>>> xmlsq.full_query(xml, "/a", xmlsq.Opts.RAW)
'<a><b foo="baz">hello</b><b>world</b><e/></a>'
>>> xmlsq.count(xml, "//b")
>>> xmlsq.count(xml, "//notthere")
>>> xmlsq.count(xml, "//e")
>>> xmlsq.full_query(xml, "2+3.5")

xmlsq.get_text() extracts the text value of the first node found selected by the query.

xmlsq.full_query() outputs the result of the full XPath 1.0 query as a string.

xmlsq.count() computes the integer value of count(query).

For xmlsq.get_text() and xmlsq.count() the query must evaluate to a node. xmlsq.full_query() accepts any valid XPath 1.0 expression and returns the result as a string.

For full details of all available methods and options, please see the documentation.

System requirements

Windows platform with Python 3. Requires the Windows native library diXmlsq.dll to be installed on your system, available from


This software is based on the pugixml library ( Pugixml is Copyright (C) 2006-2019 Arseny Kapoulkine.


For more information or to make suggestions, please contact us at

David Ireland
DI Management Services Pty Ltd
5 June 2020

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 (8.8 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