NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1345 most downloaded on PyPI
Python bindings for the XML Security Library
Latest stable
1.3.18
Last release 24 days ago
29 Oct 2026
Release timing varies
gaps range from 5 weeks to 2.8 years
Some releases are documented
notes for 18 of 36 stable releases
1 version withdrawn
withdrawn after publishing
13 years old
39 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Release Date: 2026-10-29 Version: 1.3.18
Release Date: 2026-10-29 Version: 1.3.18
This release is compatible with xmlsec1 v1.3.13, and all binary wheels (Linux, macOS, Windows) now bundle it. The previous release bundled xmlsec1 1.3.9 (Linux/macOS) and 1.3.7 (Windows).
xmlsec1 1.3.13 introduces many backward-incompatible changes (stricter defaults, rejected inputs, changed digests for some transforms). Please read the xmlsec1 changelog before upgrading: https://www.aleksey.com/xmlsec/news.html
If you upgrade from 1.3.17, the bundled library jumps several versions, so also review the xmlsec1 1.3.10–1.3.12 entries on that page.
Wheels follow the new xmlsec1 defaults, and python-xmlsec does not restore the old behavior. Source builds behave according to the libxmlsec1 version they link against.
<dsig:Reference> URIs are now limited to URI="" and URI="#id". Any other URI (http://..., cid:..., file:///..., or a relative path such as other.xml) makes SignatureContext.sign() / verify() raise xmlsec.Error. This mostly affects code that resolves external references through xmlsec.register_callbacks.
To opt in, use the new SignatureContext.enabled_reference_uris property:
ctx = xmlsec.SignatureContext()
ctx.enabled_reference_uris = (
xmlsec.constants.TransformUriTypeEmpty
| xmlsec.constants.TransformUriTypeSameDocument
| xmlsec.constants.TransformUriTypeRemote
) # or xmlsec.constants.TransformUriTypeAny
The same default (empty and same-document only) now applies to:
<enc:CipherReference URI="..."> when decrypting with EncryptionContext.decrypt()<dsig:RetrievalMethod URI="..."> and <dsig11:KeyInfoReference URI="..."> in <dsig:KeyInfo>python-xmlsec has no setting to widen these.
xmlsec.shutdown() is now process-finalStarting with xmlsec1 1.3.11, the OpenSSL backend may call OPENSSL_cleanup() during shutdown, and OpenSSL cannot be reinitialized afterwards. Calling xmlsec.init() after xmlsec.shutdown() in the same process is therefore no longer supported.
<enc:EncryptedKey> nesting limit (default 1) now also counts <enc11:DerivedKey>, <enc:AgreementMethod> and <as:EncapsulationMechanism>.Python 3.9 has reached end of life, so the minimum supported version is now Python 3.10.
This release provides binary wheels that are compatible with lxml v6.1.3. The compatibility is ensured by using the same underlying libxml2 version in both python-xmlsec and lxml.
If you see the following message:
lxml & xmlsec libxml2 library version mismatch
then lxml was built against a different libxml2 version than python-xmlsec. Either upgrade lxml to v6.1.3, or build both packages from source against the same libxml2. See the new troubleshooting section in the docs for details.
libxml2 v2.14.6libxslt v1.1.43xmlsec1 v1.3.13zlib v1.3.2libiconv v1.19openssl v3.6.5iconv v1.19-1libxml2 v2.11.9-8libxslt v1.1.45openssl v3.5.9xmlsec v1.3.13zlib v1.3.2SignatureContext.enabled_reference_uris, plus the constants TransformUriTypeNone, TransformUriTypeEmpty, TransformUriTypeSameDocument, TransformUriTypeLocal, TransformUriTypeRemote and TransformUriTypeAny (#435)template.create() raising SystemError because of a wrong argument parser signature (#405, #407)setup.cfg to pyproject.tomlSpecial thanks to
template.create keyword listFull Changelog: https://github.com/xmlsec/python-xmlsec/compare/1.3.17...1.3.18
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Release Date: 2025-11-11 Version: 1.3.17
Release Date: 2025-11-11 Version: 1.3.17
This release provides binary wheels that are fully compatible with lxml v6.0.2. The compatibility is ensured by using the same underlying libxml2 version in both python-xmlsec and lxml.
Because of this strict requirement, the wheels cannot be used with versions of lxml lower than 6.0.2. Mixing versions will lead to runtime errors.
If you see the following message:
lxml & xmlsec libxml2 library version mismatch
it indicates that the version of libxml2 used to build lxml does not match the version used to build python-xmlsec.
lxml to v6.0.2, orlxml and python-xmlsec manually from source using the same libxml2 versionThese wheels are built against the following versions, which match those used in lxml v6.0.2:
libxml2 v2.14.6libxslt v1.1.43xmlsec1 v1.3.9zlib v1.3.1libiconv v1.18openssl v3.6.0The Windows binary wheels were compiled using Visual Studio 2022 and include the following libraries:
iconv v1.18-1libxml2 v2.11.9-3libxslt v1.1.39openssl v3.0.16.pl1xmlsec v1.3.7zlib v1.3.1These versions are compatible with those used in lxml v6.0.2.
Special thanks to
Full Changelog: https://github.com/xmlsec/python-xmlsec/compare/1.3.16...1.3.17
Release Date: 2025-07-10 Version: 1.3.16
Release Date: 2025-07-10 Version: 1.3.16
This release provides binary wheels that are fully compatible with lxml v6.0.0. The compatibility is ensured by using the same underlying libxml2 version in both python-xmlsec and lxml.
Because of this strict requirement, the wheels cannot be used with versions of lxml lower than 6.0.0. Mixing versions will lead to runtime errors.
If you see the following message:
lxml & xmlsec libxml2 library version mismatch
it indicates that the version of libxml2 used to build lxml does not match the version used to build python-xmlsec.
lxml to v6.0.0, orlxml and python-xmlsec manually from source using the same libxml2 versionThese wheels are built against the following versions, which match those used in lxml v6.0.0:
libxml2 v2.14.4libxslt v1.1.43xmlsec1 v1.3.7The Windows binary wheels were compiled using Visual Studio 2022 and include the following libraries:
iconv v1.18-1libxml2 v2.11.9-3libxslt v1.1.39openssl v3.0.16.pl1xmlsec v1.3.7zlib v1.3.1These versions are compatible with those used in lxml v6.0.0.
Special thanks to @TomiBelan for helping with the creation of binary wheels for this release.
Explicitly cast the pointer type in PyXmlSec_ClearReplacedNodes by @hroncok in https://github.com/xmlsec/python-xmlsec/pull/325
Full Changelog: https://github.com/xmlsec/python-xmlsec/compare/1.3.14...1.3.15
Make DES/3DES/KW-3DES support conditional on DES availability in XMLSec
Full Changelog: https://github.com/xmlsec/python-xmlsec/compare/1.3.13...1.3.14
Add CI for Python 3.10, manylinux2 SOABI, musllinux1 SOABI and OpenSUSE Tumbleweed
manylinux2 SOABI, musllinux1 SOABI and OpenSUSE Tumbleweedpre-commitPYXMLSEC_STATIC_DEPS=trueThis release is compatible with xmlsec1 v1.3.13 , and all binary wheels (Linux, macOS, Windows) now bundle it. The previous release bundled xmlsec1 1.3.9 (Linux/macOS) and 1.3.7 (Windows).
xmlsec1 1.3.13 introduces many backward-incompatible changes (stricter defaults, rejected inputs, changed digests for some transforms). Please read the xmlsec1 changelog before upgrading: https://www.aleksey.com/xmlsec/news.html
If you upgrade from 1.3.17, the bundled library jumps several versions, so also review the xmlsec1 1.3.10–1.3.12 entries on that page.
Wheels follow the new xmlsec1 defaults, and python-xmlsec does not restore the old behavior. Source builds behave according to the libxmlsec1 version they link against.
Added support for registering custom xmlsec IO callbacks
lxml-stubs package instead of custom LXML stubsRemoved Python 2 compatibility code.
XMLSEC_NO_XSLT macro.furo.Turned off building Python 2.7 wheels in CI pipelines
libxmlsec1 version checksMore tests added to increase test coverage
xmlsec.base64_default_line_size() function to set the default maximum columns size for base64 encodingEscape the XMLSEC_CRYPTO macro value, just as it was done in the original setup
Escape the XMLSEC_CRYPTO macro value, just as it was done in the original setup
Various improvements related to packaging, distribution, CI and documentation. Notable changes:
Various improvements related to packaging, distribution, CI and documentation. Notable changes:
manylinux2010 reference system and MacOS.setuptools-scm for dist version calculation from Git tags.Nothing published for this version
Nothing published for this version
Fixed build for windows platform
add method to load symmetric key from memory Key.from_binary_data
Added parameter 'id' to method xmlsec.template.create, 'name' is deprecated.
xmlsec.template.create, 'name' is deprecated.Added binding for method xmlSecTmplTransformAddC14NInclNamespaces
Nothing published for this version
Nothing published for this version
fixed work with dynamic crypto library #48
New release 1.0.5 - fixed issue #46
New release 1.0.5
Nothing published for this version
Fixed issues with installation from pypi
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.