What’s new

Next release

• transport_data supports and is tested with Pandas 3.0.0, released 2026-01-21 (PR #59).

• Update for pycountry 26.2.16, released 2026-02-17 (PR #61).

• New HOWTO Get involved (PR #62).

• Improvements to the tdc command-line interface (CLI):

  • tdc warns but does not error if some modules/commands are not available (PR #63).

  • New command tdc org qr (PR #63).

  • New command tdc check-record (PR #58).

  • Rename command tdc check to tdc check-file (PR #58).

• Improve util.ckan (PR #58):

  • New method Package.portal_url().

  • New method Resource.fetch() to fetch and cache files.

  • Add type hints for commonly-used attributes of Package, Resource.

• Improve utility code (PR #58):

  • transport_data.hook is available as a top-level import for marking hook implementations.

  • New hook cli_modules().

  • New function sdmx.structure_from_csv().

v26.1.13

• transport_data supports and is tested on Python 3.14 (PR #51), released 2025-10-07. Support for Python 3.9 is dropped, as it has reached end-of-life.

• Improve org (PR #38):

  • New CLI command tdc ckan (see ckan.main()).

  • New class TDCALLReportStructure, representing the contents of a TDC metadata report.

  • New functions get_msd(), ckan_package_to_mdr(), and mdr_to_ckan_package().

  • Improve util.ckan (PR #38):

  • New ModelProxy class User.

  • New method ModelProxy.get().

  • ModelProxy processes collections of JSON objects to transport_data instances.

  • New class CKANMetadataReportStructure, representing the metadata fields of a CKAN package.

• Improve Pooch class (PR #50, PR #56).

  • Use a secret stored with keyring set transport-data api-token-zenodo, if available, to avoid Zenodo rate limiting.

  • Reduce repeated API calls.

  • Handle 429 Too Many Requests HTTP responses.

• ato data provider:

  • Rename .adb to ato (PR #47).

  • Update known hashes for files provided by ato (#46, PR #47, PR #50, PR #56).

  • Fetch source data from Zenodo mirror (PR #50, PR #56).

• oica data provider:

  • Update base URL and registry per 2025-10 OICA website refresh (PR #56).

  • Add 2024 data files (PR #56).

• New CLI command tdc test wipe (PR #38):

• New function util.sdmx.fields_to_mda() (PR #38).

• transport_data supports type checking of its use in downstream code, by including a py.typed marker.

• New HOWTO Create records using the TDC portal (PR #45).

v24.12.29

• Add util.ckan (PR #35), including a Client for access to CKAN instances (including the TDC instances); proxy classes for CKAN objects including Package, Resource, and more.

• Add org.ckan.PROD and org.ckan.DEV instances of ckan.Client (PR #35).

• Improve documentation (PR #40).

v24.11.25

• Add iso (International Organization for Standardization (ISO)) module (PR #29).

• Add itdp (Institute for Transport & Development Policy (ITDP)) module (PR #28).

• Add tools for SDMX-CSV and CSV data input (PR #29).

  • util.sdmx.read_csv() and CSVAdapter to read SDMX-CSV and to adapt non-standard CSV to SDMX-CSV, respectively.

  • tdc check CLI to confirm that data can be read in this way.

  • New HOWTO Format TDC-compliant data in CSV or SDMX-CSV to explain usage of these features.

• Add interactive tdc edit command-line interface for authoring SDMX data structures (PR #28, PR #31).

  • New HOWTO Edit data structures with the tdc CLI to explain usage of these features.

• Add METHOD to the TDC metadata structure (PR #28) via org.metadata.CONCEPTS.

• Improve processing of adb ATO metadata (PR #28).

  • Convert attributes from ATO data sets to TDC metadata reports.

  • Extract per-series data sources for sheets where the overall source attribute is “Country Official Statistics”.

• transport_data supports Python 3.13 (PR #32).

• Use dsss.store classes for SDMX artefact storage (PR #27).

  • transport_data.store.UnionStore is now a lightweight subclass of dsss.store.UnionStore.

  • Add Config.registry_remote_url.

v24.10.8

• Add tools and data for the TUEWAS project (PR #21).

  • Add metadata.spreadsheet, metadata.report submodules; expand metadata.

  • Add tdc org read, tdc org summarize, tdc org tuewas CLI commands.

• Add report.Report, a base class for generating ‘reports’ (documents derived from SDMX (meta)data) and supporting code in util.docutils, util.jinja2 (PR #21).

• Adopt pluggy for plug-in hooks and implementations (PR #21); use the hooks.get_agencies() hook across existing modules.

• Add tdc_cli(), test_data_path() test fixtures (PR #21).

• Python 3.8 support is dropped (PR #21), as it has reached end-of-life.

• Add ipcc (Intergovernmental Panel on Climate Change (IPCC)) module (#15, PR #21).

• Add Data standards and Roadmap documentation pages (PR #9).

• Adjust adb for changes in data format in the 2024-05-20 edition of the ATO National Database (PR #20, #18). Document the current file format that the code supports.

v24.2.5

• Add oica (International Organization of Motor Vehicle Manufacturers) module (PR #13).

• Improve store to handle both local and registry storage; expand documentation (PR #11).

• Add iamc.variable_cl_for_dsd(); expand documentation of IAM data (PR #10).

• transport_data supports and is tested on Python 3.8 through 3.12 (PR #8).

v23.5.11

Initial release