.. |pypi badge| image:: https://img.shields.io/pypi/v/pysdmx.svg
:target: https://pypi.org/project/pysdmx/
.. |awesome badge| image:: https://awesome.re/mentioned-badge.svg
:target: http://www.awesomeofficialstatistics.org
|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 <http://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 <https://jcristharif.com/msgspec/>`_.
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) <https://sdmx.org/about-sdmx/about-vtl/>`_,
and major Python libraries like `Pandas <https://pandas.pydata.org/>`_.
Take a look at the ``pysdmx`` toolkit module to learn more.
``pysdmx`` is available on `PyPI <https://pypi.org/>`_ and can be
installed using options such as pip, pipx, poetry, etc.
For more details, check the `project documentation
<https://py.sdmx.io>`_.
Raw data
{
"_id": null,
"home_page": "https://sdmx.io/tools/pysdmx",
"name": "pysdmx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "sdmx, data discovery, data retrieval, metadata, fmr",
"author": "Xavier Sosnovsky",
"author_email": "<xavier.sosnovsky@bis.org>",
"download_url": "https://files.pythonhosted.org/packages/67/9f/ebb98a377f7fc158d72e11b5cd35a77134ec1970323a019dfbb8dde04cd6/pysdmx-1.8.1.tar.gz",
"platform": null,
"description": ".. |pypi badge| image:: https://img.shields.io/pypi/v/pysdmx.svg\n :target: https://pypi.org/project/pysdmx/\n\n.. |awesome badge| image:: https://awesome.re/mentioned-badge.svg\n :target: http://www.awesomeofficialstatistics.org\n\n|pypi badge| |awesome badge|\n\n``pysdmx`` in a nutshell\n************************\n\nWhat is pysdmx?\n===============\n\n``pysdmx`` is a **pragmatic** and **opinionated** SDMX library written in\n**Python**. It focuses on **simplicity**, providing a subset of SDMX functionalities\nwithout requiring advanced knowledge of SDMX. ``pysdmx`` is developed as part of\nthe `sdmx.io <http://sdmx.io/>`_ project under the **BIS Open Tech initiative**.\n\nWhat does it do?\n================\n\n``pysdmx`` aspires to be a versatile SDMX toolbox for Python, covering various\nuse cases. Here are some highlights:\n\nSDMX information model in Python\n--------------------------------\n\n``pysdmx`` offers Python classes representing a **simplified subset of the SDMX\ninformation model**, enabling a domain-driven development of SDMX processes in\nPython. The model classes support serialization in formats like JSON, YAML, or\nMessagePack. This functionality relies on the \n`msgspec library <https://jcristharif.com/msgspec/>`_.\n\nMetadata in action\n------------------\n\nSDMX metadata are very useful for documenting statistical processes. For example,\nthey can define the structure we expect for a data collection process and share\nit with the organizations providing data so that they know what to send.\n\nHowever, metadata can do so much more than that, i.e., they can be \u201cactive\u201d and\n**drive various types of statistical processes**, such as generating the filesystem\nlayout, creating the physical data model, validating data, mapping data, and\nconfiguring processes. To drive such processes, ``pysdmx`` supports retrieving\nmetadata from an SDMX Registry or any service compliant with the SDMX-REST 2.0.0 (or\nabove) API. Use these metadata to power your own statistical processes!\n\nReading and writing SDMX files\n------------------------------\n\n``pysdmx`` supports reading and writing SDMX data and structure messages, in various\nformats, such as SDMX-CSV, SDMX-JSON, and SDMX-ML.\n\nData discovery and data retrieval\n---------------------------------\n\nThis functionality is under development. Once ready, ``pysdmx`` will allow:\n \n- **Listing public SDMX services**.\n- **Discovering data** available in these services.\n- **Retrieving data** from these services.\n \nThis functionality is based on the **SDMX Global Discovery Service initiative**.\n\nIntegration with the ecosystem\n------------------------------\n\n``pysdmx`` integrates nicely with other standards, like the `Validation and\nTransformation Language (VTL) <https://sdmx.org/about-sdmx/about-vtl/>`_,\nand major Python libraries like `Pandas <https://pandas.pydata.org/>`_.\nTake a look at the ``pysdmx`` toolkit module to learn more.\n\n``pysdmx`` is available on `PyPI <https://pypi.org/>`_ and can be\ninstalled using options such as pip, pipx, poetry, etc.\n\nFor more details, check the `project documentation \n<https://py.sdmx.io>`_.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Your opinionated Python SDMX library",
"version": "1.8.1",
"project_urls": {
"Bug Tracker": "https://bis-med-it.github.io/pysdmx/issues",
"Documentation": "https://bis-med-it.github.io/pysdmx",
"Homepage": "https://sdmx.io/tools/pysdmx",
"Repository": "https://github.com/bis-med-it/pysdmx"
},
"split_keywords": [
"sdmx",
" data discovery",
" data retrieval",
" metadata",
" fmr"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3f8d54e34c54f76436b160184550d53c268d0cbb1507e492f458ca284e33bfc4",
"md5": "c046ad0b979df9a4226df00a0bd5a2fc",
"sha256": "153101199e54e410dd96ab28da900f5e198edc85ad4c33a8cd10a349471fe3c3"
},
"downloads": -1,
"filename": "pysdmx-1.8.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c046ad0b979df9a4226df00a0bd5a2fc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 236892,
"upload_time": "2025-10-22T11:47:18",
"upload_time_iso_8601": "2025-10-22T11:47:18.476233Z",
"url": "https://files.pythonhosted.org/packages/3f/8d/54e34c54f76436b160184550d53c268d0cbb1507e492f458ca284e33bfc4/pysdmx-1.8.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "679febb98a377f7fc158d72e11b5cd35a77134ec1970323a019dfbb8dde04cd6",
"md5": "88cce7d88e87ddc6157c6bd5eda3ed72",
"sha256": "3ad3373d9501d22451db3f93da9f3aae7a3d3a390ace62be865b3705da843c95"
},
"downloads": -1,
"filename": "pysdmx-1.8.1.tar.gz",
"has_sig": false,
"md5_digest": "88cce7d88e87ddc6157c6bd5eda3ed72",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 153294,
"upload_time": "2025-10-22T11:47:19",
"upload_time_iso_8601": "2025-10-22T11:47:19.920179Z",
"url": "https://files.pythonhosted.org/packages/67/9f/ebb98a377f7fc158d72e11b5cd35a77134ec1970323a019dfbb8dde04cd6/pysdmx-1.8.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 11:47:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bis-med-it",
"github_project": "pysdmx",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pysdmx"
}
JSON
