headlamp 0.1.35 → 0.1.57

package/README.md

@@ -1,24 +1,23 @@
-### Headlamp
+# Headlamp
 
-Headlamp is a **Rust-powered test UX CLI**: smarter test selection, cleaner output, and a unified workflow across **jest**, **cargo test**, and **cargo nextest**.
+Headlamp is a **Rust-powered test UX CLI**: smarter test selection, cleaner output, and a unified workflow across **jest**, **cargo test**, **cargo nextest**, and **pytest**.
 
 Headlamp is useful when you want a consistent way to run tests across different projects and keep feedback fast as your repo grows. It can select tests based on what changed, surface failures in a readable format, and keep common defaults (like runner args and coverage settings) in a single config file so your team doesn’t have to remember a long list of flags.
 
-### Why Headlamp
+## Why Headlamp
 
-- **One CLI, many runners**: `--runner=jest|cargo-nextest|cargo-test`
+- **One CLI, many runners**: `--runner=jest|cargo-nextest|cargo-test|pytest`
 - **Selection that scales**: run what changed (`--changed`) and what’s related (dependency-graph driven)
 - **Coverage-first UX**: coverage output you can actually read
 - **Fast**: Rust core + caching
 
-### Installation
+## Installation
 
-#### npm (recommended)
+### npm (Node.js projects)
 
 Requirements:
 
 - Node **>= 18**
-- A GitHub Release for your version tag (see “Releases” below)
 
 Install:
 
@@ -32,15 +31,29 @@ Run:
 npx headlamp --help
 ```
 
-#### Cargo (from source)
+### Cargo (Rust projects)
+
+Install from crates.io:
 
 ```bash
-cargo install --path headlamp
+cargo install headlamp
 ```
 
-### Quickstart
+### Python (pytest projects)
 
-#### Jest
+Install:
+
+```bash
+pip install headlamp
+```
+
+```bash
+headlamp --runner=pytest
+```
+
+## Quickstart
+
+### Jest
 
 ```bash
 npx headlamp --runner=jest
@@ -52,47 +65,29 @@ Forward runner args after `--` (unknown args are forwarded):
 npx headlamp --runner=jest -- --runInBand
 ```
 
-#### Cargo nextest / cargo test
+### Cargo nextest / cargo test
 
 ```bash
 headlamp --runner=cargo-nextest
 headlamp --runner=cargo-test
 ```
 
-### CLI
-
-Current `--help` output:
-
-```text
-headlamp
-
-Usage:
-  headlamp [--runner=<jest|vitest|pytest|cargo-nextest|cargo-test>] [--coverage] [--changed[=<mode>]] [args...]
-
-Flags:
-  --runner <runner>              Select runner (default: jest)
-  --coverage                     Enable coverage collection (runner-specific)
-  --coverage-ui=jest|both         Coverage output mode
-  --coverage.abortOnFailure       Exit on test failures without printing coverage
-  --watch                        Re-run on file changes (runner-agnostic polling watch)
-  --ci                           CI mode (disable interactive UI and set CI=1)
-  --verbose                      More Headlamp diagnostics
-  --no-cache                     Disable Headlamp caches (and runner caches when possible)
-  --onlyFailures                 Show only failing tests during live output
-  --showLogs                     Show full logs under failing tests
-  --sequential                   Serialize execution (maps to jest --runInBand)
-  --bootstrapCommand <cmd>       Run once before tests (npm script name or shell cmd)
-  --changed[=all|staged|unstaged|branch|lastCommit]
-  --changed.depth=<n>
-
-Notes:
-  Unknown args are forwarded to the runner.
-```
+## CLI
+
+Run `headlamp --help` to see the up-to-date flags list.
+
+Highlights:
 
-### Configuration
+- **runners**: `--runner=jest|pytest|cargo-nextest|cargo-test`
+- **changed selection**: `--changed=all|staged|unstaged|branch|lastCommit|lastRelease`
+  - `lastRelease` selects changes since the previous stable SemVer release tag
+- **coverage**: `--coverage` plus `--coverage-ui`, `--coverage.detail`, thresholds, etc.
+
+## Configuration
 
 Headlamp discovers config from your repo root. Supported file names:
 
+- `headlamp.toml` (highest precedence)
 - `headlamp.config.ts`
 - `headlamp.config.js`
 - `headlamp.config.mjs`
@@ -104,7 +99,27 @@ Headlamp discovers config from your repo root. Supported file names:
 - `headlamp.config.yml`
 - `.headlamprc` plus `.headlamprc.*` variants (`.json`, `.json5`, `.jsonc`, `.yaml`, `.yml`, `.js`, `.cjs`, `.mjs`, `.ts`)
 
-#### Example: `headlamp.config.ts`
+Headlamp also supports embedded TOML config (lower precedence than explicit config files):
+
+- `pyproject.toml` under `[tool.headlamp]`
+- `Cargo.toml` under `[package.metadata.headlamp]`
+
+### Example: `headlamp.toml` (recommended for Rust + Python)
+
+```toml
+# Run tests sequentially (useful for very heavy integration tests)
+sequential = true
+
+[coverage]
+abort_on_failure = true
+mode = "auto"
+page_fit = true
+
+[changed]
+depth = 20
+```
+
+### Example: `headlamp.config.ts`
 
 Rules:
 
@@ -138,20 +153,14 @@ export default {
 };
 ```
 
-### Contributing
+## Contributing
 
 Pull requests are welcome. For large changes, open an issue first to align on direction.
 
-Local dev:
-
-```bash
-cargo test
-```
-
-### Support
+## Support
 
 - Bug reports and feature requests: GitHub Issues
 
-### License
+## License
 
 MIT — see `LICENSE`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "headlamp",
-  "version": "0.1.35",
+  "version": "0.1.57",
   "description": "The smart searchlight for your test suite. Fast, graph-powered selection for Jest and Cargo.",
   "keywords": [
     "testing",

package/bin/.gitkeep

@@ -1,4 +0,0 @@
-
-
-
-