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.21.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.21.0
File Size Uploaded
pysdmx-1.21.0.tar.gz 225.4 kB Details

Built distribution (wheel)

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

Total release size: 551.1 kB

Release files / pysdmx-1.21.0.tar.gz

Download URL pysdmx-1.21.0.tar.gz
Size 225.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4a00112601a1e369a931883bac9c70bb0cdf7d231cf7f474bee0083f4dd5dc8d
BLAKE2b-256 checksum
How to use checksums
b8d05a133b8c47d9497d0441917c8a22e3eb408795355e1a522ec1a6de32345c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure

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

Download URL pysdmx-1.21.0-py3-none-any.whl
Size 325.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7a2e17ca43211395da8349a1158c3641f0b43df7d3be5e66d95786c9d9a41de4
BLAKE2b-256 checksum
How to use checksums
81f4b627183e10ffa2176ad38dc28538c86d7f6dc60c44957990cce34265a3a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure

Release history Release notifications | RSS feed

This release

1.21.0 This release

2 release files

1.20.0

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