Metadata-Version: 2.4
Name: bashthing
Version: 0.1.0
Summary: Deterministic profiler for bash scripts. DEBUG trap + strace/dtruss + execsnoop + ShellCheck in a single pass.
Keywords: bash,profiler,performance,shell,tracing
Author: Kevin Turcios
Author-email: Kevin Turcios <turcioskevinr@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.14
Project-URL: Homepage, https://github.com/KRRT7/bashthing
Project-URL: Repository, https://github.com/KRRT7/bashthing.git
Project-URL: Issues, https://github.com/KRRT7/bashthing/issues
Project-URL: Changelog, https://github.com/KRRT7/bashthing/blob/main/docs/changelog.md
Description-Content-Type: text/markdown

# bashthing

`bashthing` profiles Bash 5 scripts and stores command traces and optional system-level data in SQLite.

Requires Python 3.14 and Bash 5 or newer.

## Usage

```bash
uv sync --group dev
uv run bashthing run path/to/script.sh
uv run bashthing run path/to/script.sh --all
```

`run` uses the built-in DEBUG tracer. Add optional backends with repeatable `--backend` arguments, or use `--all` to run every usable backend and report those that cannot run. Available backend names are `shellcheck`, `syscalls`, `execs`, and `probes`.

Run `uv run bashthing --help` for all commands and options.

Development instructions are in [docs/contributing.md](docs/contributing.md).

## License

[MIT](LICENSE)
