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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysdmx-1.19.0.tar.gz (211.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pysdmx-1.19.0-py3-none-any.whl (310.4 kB view details)

Uploaded Python 3

File details

Details for the file pysdmx-1.19.0.tar.gz.

File metadata

  • Download URL: pysdmx-1.19.0.tar.gz
  • Upload date:
  • Size: 211.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1022-azure

File hashes

Hashes for pysdmx-1.19.0.tar.gz
Algorithm Hash digest
SHA256 44996e6e6a3f3fb9e8a0235d73ef589109c662b5fe688df0c0b42216bebb76a5
MD5 bd4ab0c07c4d20280239d928f1c37dfa
BLAKE2b-256 ae4f9bd4b01f2815957b482b3b593a662787744d2435796c9bc0d1091ccbc4b3

See more details on using hashes here.

File details

Details for the file pysdmx-1.19.0-py3-none-any.whl.

File metadata

  • Download URL: pysdmx-1.19.0-py3-none-any.whl
  • Upload date:
  • Size: 310.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.4.1 CPython/3.12.3 Linux/6.17.0-1022-azure

File hashes

Hashes for pysdmx-1.19.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2bfa576afd201d6e24b41d128128ba7436073eea816055dc69ac76c49cba3a3c
MD5 b8a295820a95aa8249c53dabb4580b99
BLAKE2b-256 1399d62c7a622d0bf57af7a04f3f5d119d45f23babdb488259d943aa23f42f98

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.19.0 This release

2 files

1.18.0

2 files

1.17.0

2 files

1.16.0

2 files

1.15.1

2 files

1.15.0

2 files

1.14.0

2 files

1.13.0

2 files

1.12.0

2 files

1.11.0

2 files

1.10.1

2 files

1.10.0

2 files

1.9.0

2 files

1.8.1

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.1

2 files

1.1.0

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page