Skip to main content

pypi badge awesome badge

pysdmx in a nutshell

What is pysdmx?

pysdmx is a pragmatic and opinionated SDMX library written in Python. It focuses on simplicity, providing a subset of SDMX functionalities without requiring advanced knowledge of SDMX. pysdmx is developed as part of the sdmx.io project under the BIS Open Tech initiative.

What does it do?

pysdmx aspires to be a versatile SDMX toolbox for Python, covering various use cases. Here are some highlights:

SDMX information model in Python

pysdmx offers Python classes representing a simplified subset of the SDMX information model, enabling a domain-driven development of SDMX processes in Python. The model classes support serialization in formats like JSON, YAML, or MessagePack. This functionality relies on the msgspec library.

Metadata in action

SDMX metadata are very useful for documenting statistical processes. For example, they can define the structure we expect for a data collection process and share it with the organizations providing data so that they know what to send.

However, metadata can do so much more than that, i.e., they can be “active” and drive various types of statistical processes, such as generating the filesystem layout, creating the physical data model, validating data, mapping data, and configuring processes. To drive such processes, pysdmx supports retrieving metadata from an SDMX Registry or any service compliant with the SDMX-REST 2.0.0 (or above) API. Use these metadata to power your own statistical processes!

Reading and writing SDMX files

pysdmx supports reading and writing SDMX data and structure messages, in various formats, such as SDMX-CSV, SDMX-JSON, and SDMX-ML.

Data discovery and data retrieval

This functionality is under development. Once ready, pysdmx will allow:

  • Listing public SDMX services.

  • Discovering data available in these services.

  • Retrieving data from these services.

This functionality is based on the SDMX Global Discovery Service initiative.

Integration with the ecosystem

pysdmx integrates nicely with other standards, like the Validation and Transformation Language (VTL), and major Python libraries like Pandas. Take a look at the pysdmx toolkit module to learn more.

pysdmx is available on PyPI and can be installed using options such as pip, pipx, poetry, etc.

For more details, check the project documentation.

Metadata

Release files for pysdmx 1.20.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pysdmx 1.20.0
File Size Uploaded
pysdmx-1.20.0.tar.gz 221.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pysdmx 1.20.0
File Interpreter ABI Platform
pysdmx-1.20.0-py3-none-any.whl Python 3 none any Details

Total release size: 543.2 kB

Release files / pysdmx-1.20.0.tar.gz

Download URL pysdmx-1.20.0.tar.gz
Size 221.8 kB
Tags Source
SHA-256 checksum
How to use checksums
cee050bd2b79585999c91c4999272877c8b3da6a95185791a74f7819faf505a0
BLAKE2b-256 checksum
How to use checksums
011a27b2115087e61b09cd8d4b3409bc51f572e343a8745b9cacb6b2b8d723ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.3 CPython/3.12.3 Linux/6.17.0-1022-azure

Release files / pysdmx-1.20.0-py3-none-any.whl

Download URL pysdmx-1.20.0-py3-none-any.whl
Size 321.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
17d30262a06b3a9e1d6bfa08cfff6f8c65f985174e829040bc3b3272af00cace
BLAKE2b-256 checksum
How to use checksums
14b85163d0a482cc34c080ad2abfe2d52b8afd655f6e6d0839264e6c096e2641
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.3 CPython/3.12.3 Linux/6.17.0-1022-azure

Release history Release notifications | RSS feed

This release

1.20.0 This release

2 release files

1.19.0

2 release files

1.18.0

2 release files

1.17.0

2 release files

1.16.0

2 release files

1.15.0

2 release files

1.14.0

2 release files

1.11.0

2 release files

1.10.1

2 release files

1.9.0

2 release files

1.8.1

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.0

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page