Transpiler Mate

Transpiler Mate is a Python library and CLI that extracts schema.org/SoftwareApplication metadata from annotated CWL documents and converts it into publication-ready formats.

What It Does

Given an input CWL metadata source, Transpiler Mate can:

Generate CodeMeta JSON-LD.
Generate DataCite metadata payloads.
Generate OGC API - Records payloads.
Generate Markdown documentation for workflows.
Generate OCI Annotations.
Bundle CWL documents into self-contained files with external references resolved.
Publish records to InvenioRDM.
Bump semantic versions in metadata files.

Documentation: https://terradue.github.io/transpiler-mate/

Supported Outputs

CodeMeta: https://codemeta.github.io/
DataCite Metadata: https://inveniordm.docs.cern.ch/reference/metadata/#metadata
OGC API - Records: https://ogcapi.ogc.org/records/
OCI Annotations: https://oras.land/docs/how_to_guides/manifest_annotations/
InvenioRDM: https://inveniosoftware.org/products/rdm/

Requirements

Python >= 3.10

Installation

From source (recommended for development)

git clone https://github.com/Terradue/transpiler-mate.git
cd transpiler-mate
pip install -e .

Install tooling for local workflows

pip install hatch ruff

CLI Usage

Entry point:

transpiler-mate --help

Main commands:

transpiler-mate codemeta <source> [--code-repository URL] [--output codemeta.json]
transpiler-mate datacite <source> [--output datacite.json]
transpiler-mate ogcrecord <source> [--output record.json]
transpiler-mate markdown <source> --workflow-id <id> [--output DIR] [--code-repository URL]
transpiler-mate oci-annotations <source> --workflow-id <id> [--image-source URL] [--image-revision ] [--output annotations.json]
transpiler-mate invenio-publish <source> --base-url URL --auth-token TOKEN [--attach FILE ...]
transpiler-mate bump-version <source> [--version-part major|minor|patch|build|pre-release]
transpiler-mate bundle <source> [--output bundle.cwl] [--oci-hostname HOST] [--oci-username USER] [--oci-password PASSWORD] [--oauth2-bearer TOKEN]

Examples

Generate CodeMeta:

transpiler-mate codemeta ./metadata.cwl --output ./dist/codemeta.json

Generate DataCite metadata:

transpiler-mate datacite ./metadata.cwl --output ./dist/datacite.json

Generate OGC Record:

transpiler-mate ogcrecord ./metadata.cwl --output ./dist/record.json

Generate Markdown documentation:

transpiler-mate markdown ./workflow.cwl --workflow-id main --output ./docs

Bundle a CWL document and resolve its external references:

transpiler-mate bundle ./workflow.cwl --output ./dist/bundle.cwl

The bundle command was migrated from the CWL Loader CLI.

Publish to InvenioRDM:

export INVENIO_AUTH_TOKEN="<token>"
transpiler-mate invenio-publish ./metadata.cwl --base-url https://invenio.example.org --auth-token "$INVENIO_AUTH_TOKEN"

Development

Run lint and formatting checks:

hatch run dev:check
hatch run dev:lint

Run tests for one interpreter:

hatch run test.py3.12:test-q

Run full Hatch test matrix (local environment permitting):

hatch run test:test-q

Project Tasks

Taskfile.yaml includes helper tasks for schema/model generation and quality checks:

task quality:test
task quality:lint
task quality:check

Local quality checks

Install Hatch and Taskfiles then install the Git hook:

task quality:pre-commit:install

Every commit runs Ruff (including the configured McCabe complexity limit), Ruff formatting, strict mypy checks, and the pytest suite. Run the complete hook explicitly with:

task quality:pre-commit:run

## License

[![Apache License, Version 2.0](https://img.shields.io/badge/license-Apache%20License%202.0-blue)](https://www.apache.org/licenses/LICENSE-2.0)

Download files

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

Source Distribution

transpiler_mate-0.48.0.tar.gz (1.0 MB view details)

Uploaded Jul 28, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

transpiler_mate-0.48.0-py3-none-any.whl (248.4 kB view details)

Uploaded Jul 28, 2026 Python 3

File details

Details for the file transpiler_mate-0.48.0.tar.gz.

File metadata

Download URL: transpiler_mate-0.48.0.tar.gz
Upload date: Jul 28, 2026
Size: 1.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for transpiler_mate-0.48.0.tar.gz
Algorithm	Hash digest
SHA256	`1338f208ebf5e0b419a0d1e5d9cd77548f307f37090a97c582d60f0da51a0572`
MD5	`ed52a0978e861118f3386774d551fad5`
BLAKE2b-256	`1596e2974b5d1a79105b964638ca927fbc94e43fb48343bf4ffe65e02038ee82`

See more details on using hashes here.

Provenance

The following attestation bundles were made for transpiler_mate-0.48.0.tar.gz:

Publisher: package.yaml on Terradue/transpiler-mate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: transpiler_mate-0.48.0.tar.gz
- Subject digest: 1338f208ebf5e0b419a0d1e5d9cd77548f307f37090a97c582d60f0da51a0572
- Sigstore transparency entry: 2273086826
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: Terradue/transpiler-mate@18dbf09d67d536ef54466dd61ec31170ec6f6e07
- Branch / Tag: refs/tags/v0.48.0
- Owner: https://github.com/Terradue
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: package.yaml@18dbf09d67d536ef54466dd61ec31170ec6f6e07
- Trigger Event: push