cobre-bridge

Convert power system data formats to Cobre input format.

Installation

uv tool install cobre-bridge   # recommended: isolated, on-PATH CLI
pipx install cobre-bridge       # alternative

Requires Python >= 3.12. cobre-python is bundled as a core dependency, so convert --validate and compare work out of the box.

Usage

Command	What it does
`cobre-bridge convert newave <SRC> <DST>`	Convert a NEWAVE case to Cobre input format.
`cobre-bridge convert decomp <SRC> <DST>`	Convert a DECOMP case to Cobre input format.
`cobre-bridge check newave <SRC>`	Preflight-validate NEWAVE inputs (no conversion).
`cobre-bridge check decomp <SRC>`	Preflight-validate DECOMP inputs (no conversion).
`cobre-bridge compare newave <NEWAVE_DIR> <COBRE_DIR>`	Compare simulation results against Cobre output.
`cobre-bridge compare decomp <DECOMP_DIR> <COBRE_DIR>`	Compare a DECOMP run against its converted Cobre output.
`cobre-bridge dashboard <CASE_DIR>`	Build an interactive HTML dashboard from Cobre results.

Every command accepts --json (a single machine-readable verdict {schema_version, command, status, summary, diagnostics} on stdout) and -v/-vv, --log-file PATH, --no-color, --quiet. convert adds --validate, --force, --dry-run, --diagnostics-json PATH. dashboard adds --open. compare newave and compare decomp add --tolerance, --format, --out-dir — with --format html both write a full multi-tab comparison report (Overview/cost, System, Energy Balance, Network, Convergence, Performance, plant detail, Productivity, FPHA; compare decomp adds REE, constraints, and evaporation sections).

See docs/cli.md for the full per-command reference.

Cobre version. This release targets cobre 0.14.3: converted cases use cobre 0.14's input contract, and the emitted policy relies on 0.14.3's boundary inflow-lag slot reservation, so convert --validate requires cobre-python >= 0.14.3 (an older one is skipped gracefully rather than failing).

Configuration

Defaults for compare newave tolerance, format, and out_dir can be set in a cobre-bridge.toml file (discovered from the working directory upward, then $XDG_CONFIG_HOME/cobre-bridge/config.toml, then ~/.config/cobre-bridge/config.toml) or via COBRE_BRIDGE_* environment variables (e.g. COBRE_BRIDGE_RESULTS_TOLERANCE, COBRE_BRIDGE_FORMAT, COBRE_BRIDGE_OUT_DIR). Precedence is flag > env > config file > default.

Shell completion

cobre-bridge --install-completion   # install for your shell
cobre-bridge --show-completion      # print the script

Development

pip install -e ".[dev]"
pytest
ruff check .
ruff format --check .

License

Apache-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

cobre_bridge-0.15.0.tar.gz (2.2 MB view details)

Uploaded Aug 24, 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.

cobre_bridge-0.15.0-py3-none-any.whl (825.9 kB view details)

Uploaded Aug 24, 2026 Python 3

File details

Details for the file cobre_bridge-0.15.0.tar.gz.

File metadata

Download URL: cobre_bridge-0.15.0.tar.gz
Upload date: Aug 24, 2026
Size: 2.2 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cobre_bridge-0.15.0.tar.gz
Algorithm	Hash digest
SHA256	`70dcd91fd1d20d3a04f9874eb124fce8cf178038c9a8fc4d762317c7ee50190f`
MD5	`730de909258af780d46d15e68c925520`
BLAKE2b-256	`3fd470f7b36b74479a54eebdb502087f90f583f1acb9f6dec125fa8d9ef59b3f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for cobre_bridge-0.15.0.tar.gz:

Publisher: release.yml on cobre-rs/cobre-bridge

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: cobre_bridge-0.15.0.tar.gz
- Subject digest: 70dcd91fd1d20d3a04f9874eb124fce8cf178038c9a8fc4d762317c7ee50190f
- Sigstore transparency entry: 2581449990
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: cobre-rs/cobre-bridge@b292b7f6f542a0b8db102dc0e57aba591add59de
- Branch / Tag: refs/tags/v0.15.0
- Owner: https://github.com/cobre-rs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@b292b7f6f542a0b8db102dc0e57aba591add59de
- Trigger Event: push