gams-xml-catalog
A Python package that provides an XML catalog containing schema files commonly needed in GAMS projects.
Starting with lxml version 6, the underlying libxml2 library disables fetching resources from the internet by default for security reasons. This library solves that problem by providing local copies of frequently used XML schemas and resources, making them accessible through the standard XML Catalog mechanism (https://xmlcatalogs.org/).
Additionally, it provides a resolve_uri_to_path() function to retrieve the local file path for any catalog resource. In most cases, using the default catalog mechanism is preferred—simply call gams_xml_catalog.activate_catalog() and let tools like lxml or saxonche handle URI resolution automatically.
Installation
Install the package from PyPI using pip:
pip install gams-xml-catalog
Usage
To use the catalog, simply import and activate it:
import gams_xml_catalog
gams_xml_catalog.activate_catalog()
This temporarily adds the catalog path to the XML_CATALOG_FILES environment variable, enabling lxml and other XML-aware tools to use local copies instead of fetching resources from the internet. Any tool with XML Catalog support will automatically benefit from this setup.
Direct URI to Path Resolution
For non-XML formats (such as RelaxNG Compact) or when you need to resolve URIs without triggering XML parsing, use the resolve_uri_to_path() function:
import gams_xml_catalog
# Resolve a RelaxNG Compact file (no XML parsing)
path = gams_xml_catalog.resolve_uri_to_path("http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rnc")
print(f"Local file: {path}")
# Output: /path/to/catalog/tei/p5/relaxng/tei_all.rnc
# For advanced use cases, create a CatalogResolver instance:
from gams_xml_catalog import CatalogResolver, get_catalog_path
resolver = CatalogResolver(get_catalog_path())
path = resolver.resolve("http://purl.org/dc/elements/1.1/") # auto-detect URI or system ID
path = resolver.resolve_uri("http://www.w3.org/1999/xlink") # resolve as URI
path = resolver.resolve_system("http://www.tei-c.org/release/xml/tei/custom/schema/xsd/tei_all.xsd") # resolve as system ID
This approach is useful for:
- Processing non-XML formats like RelaxNG Compact (
.rnc) - Pre-resolving URIs for tools without XML Catalog support
- Building schema dependency graphs without triggering parse errors
Contributing
The Github repository is ment to be a read only mirror of the work repository hosted on our institutional private Github server. You can use the bug tracker on Github, but everything else should happen in the Zimlab Github repo.
License
The package code is distributed under the MIT license (see LICENSE for details). The XML schemas and resources included in the catalog are primarily in the public domain. For some resources, explicit licensing information was not available.
Metadata
Release files for gams-xml-catalog 0.6.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gams_xml_catalog-0.6.8.tar.gz | 5.3 MB | Without provenance | Details for gams_xml_catalog-0.6.8.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gams_xml_catalog-0.6.8-py3-none-any.whl | Python 3 | none | any | Details for gams_xml_catalog-0.6.8-py3-none-any.whl |
Total release size: 11.1 MB
Release files / gams_xml_catalog-0.6.8.tar.gz
| Download URL | gams_xml_catalog-0.6.8.tar.gz |
|---|---|
| Size | 5.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3ec6ad617d9987e8a158e5044c222ddfc64f178fe5c3bb1f46867749d85db68d
|
|
BLAKE2b-256 checksum How to use checksums |
aec8c99da79c44993b58cd22f8c6518fa6dd6ae2590611a299552fc72d5ad0e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / gams_xml_catalog-0.6.8-py3-none-any.whl
| Download URL | gams_xml_catalog-0.6.8-py3-none-any.whl |
|---|---|
| Size | 5.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4372ad72763d37142ebdb5e5b449737d5db90b1c513880daec1a4b2ed30b721b
|
|
BLAKE2b-256 checksum How to use checksums |
b36d482b51abf3727384076e8eaf47dadf9781e24a887596f8bd01b9588dcab9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.13 {"installer":{"name":"uv","version":"0.11.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for gams-xml-catalog 0.6.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.