Metadata-Version: 2.4
Name: obra-tools
Version: 0.1.0
Summary: Command-line tools for CAN, ROS 2, MCAP metrics, and VCS workspace syncing.
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: cantools>=39
Requires-Dist: mcap>=1.0
Requires-Dist: PyYAML>=6.0

# obra-tools

`obra-tools` packages the current Python command-line utilities from obra.

## Install

```bash
python -m pip install obra-tools
```

## Commands

- `obra-bag-to-csv`: export `/system/metrics` samples from MCAP files.
- `obra-dbc-to-msg`: generate ROS 2 `.msg` files from a DBC database.
- `obra-dbc-to-ros`: normalize DBC message and signal names for ROS.
- `obra-log-replay`: replay a CL3000 CAN log through a SocketCAN interface (Linux).
- `obra-vcs`: clone and synchronize repositories declared in a `.repos` file.

Run any command with `--help` for its arguments. The package includes only the Python scripts supplied with timestamps within the requested two-year window; the Bash shell helpers are intentionally excluded.

## Publishing

Set the final project metadata (especially the license and project URL) before uploading, then build with:

```bash
python -m build
python -m twine check dist/*
python -m twine upload dist/*
```
