red_dot 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e48a83c891b5b2979651d8c6f766f47b8f25718e4c303ebca0068764bca0226e
+  data.tar.gz: aa3bf5f6074d7a126336e2292e7c8803698ed62d50eaba4aeae7f65254704d94
+SHA512:
+  metadata.gz: c811553942cc8d55e78b802e5fe056f57130e56de9956dd1d32a0cf147e0f63a379ae044f06a36465ce382ea0512bfa14bfeb6cc143f725845cf6da29e5eb664
+  data.tar.gz: 5325b9d2fb1cb15902c398893077e4d9eb55ecf98ddae1c3af7a9b7ae912b5f25e86f37f40f2c0ebf7367cdaff472215f405dbb157961bcd1556f21f24481fa1

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,190 @@
+# Red Dot
+
+A terminal UI for running RSpec tests. Start it from your project directory, leave it open, and run specs whenever you want.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "red_dot"
+```
+
+Or install directly:
+
+```bash
+gem install red_dot
+```
+
+### Build and install locally
+
+To build and install the gem from source (e.g. for development or testing):
+
+```bash
+git clone https://github.com/red_dot/red_dot.git
+cd red_dot
+bundle install
+gem build red_dot.gemspec
+gem install red_dot-*.gem
+```
+
+Or install without building a `.gem` file (uses the local directory):
+
+```bash
+cd /path/to/red_dot
+bundle install
+gem install --local .
+```
+
+Requires Ruby 3.2+ and `bundle install` will pull in dependencies (bubbletea, lipgloss).
+
+## Usage
+
+**Single project**: From your project root (where your `spec/` directory lives), or from any directory with a `spec/`:
+
+```bash
+rdot
+# or with a specific directory
+rdot /path/to/project
+
+# Index spec files with the following key combination:
+shift + i
+```
+
+**Umbrella / component projects**: From the repo root that has a root-level `components/` directory, run `rdot` to see and run specs from the root (if it has a `spec/` dir) and from each direct child of `components/` that has a `spec/` subdirectory. Each component’s specs run in that component’s directory (using its Gemfile). You can still run `rdot` from inside a component (e.g. `cd components/auth && rdot`) for single-component mode.
+
+
+### One-off options (CLI)
+
+Override options for a single run without editing config or the TUI:
+
+```bash
+rdot --format documentation
+rdot --tag slow --fail-fast /path/to/project/root
+rdot -f progress -t focus -o /tmp/out.txt
+```
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--format` | `-f` | RSpec formatter (e.g. progress, documentation) |
+| `--tag` | `-t` | Tag filter (repeatable) |
+| `--output` | `-o` | Output file path |
+| `--example` | `-e` | Example filter (e.g. regex) |
+| `--line` | `-l` | Line number (run single example at path:line when running one file) |
+| `--fail-fast` | — | Stop on first failure |
+
+### Configuration
+
+Options are merged in this order (later overrides earlier):
+
+1. **Defaults** (see table below)
+2. **User config** — `~/.config/red_dot/config.yml` (or `$XDG_CONFIG_HOME/red_dot/config.yml`)
+3. **Project config** — `.red_dot.yml` in the project root
+4. **CLI** — flags passed to `rdot`
+
+All of these can be overridden via config YAML (user or project). In the TUI, press `o` to focus the options bar and edit any field (Enter to edit or toggle).
+
+| Option | Default | Config key | Notes |
+|--------|--------|------------|-------|
+| Tags | *(empty)* | `tags` or `tags_str` | RSpec tag filter. Use `tags:` (array) or `tags_str:` (string, e.g. `"~slow, focus"`). |
+| Format | `progress` | `format` | RSpec formatter: e.g. `progress`, `documentation`. |
+| Output | *(empty)* | `output` | File path for RSpec output. Also accepts legacy key `out_path`. |
+| Example | *(empty)* | `example_filter` | Example filter (e.g. regex) passed to RSpec. |
+| Line | *(empty)* | `line_number` | Line number for single-file runs (path:line). |
+| Fail-fast | `false` | `fail_fast` | Stop on first failure. Use `true` or `false`. |
+| Seed | *(empty)* | `seed` | RSpec random seed (e.g. `12345`) for reproducibility. |
+| Editor | `cursor` | `editor` | Editor for “open file” (O): `vscode`, `cursor`, or `textmate`. |
+
+| Components | *(auto)* | `components` | Umbrella only: list of component root paths (relative to project root). Overrides automatic discovery. Use `"."` or `""` for root, e.g. `[".", "components/auth", "apps/web"]`. |
+
+Example `~/.config/red_dot/config.yml`:
+
+```yaml
+format: documentation
+tags_str: "~slow"
+fail_fast: false
+editor: cursor   # vscode, cursor, or textmate — used when opening file (O)
+```
+
+Example `.red_dot.yml` in project root:
+
+```yaml
+format: progress
+tags:
+  - focus
+output: /tmp/rspec.out
+editor: vscode   # optional: vscode, cursor, or textmate
+```
+
+You can edit any option in the TUI: press `o` for Options, then ←/→ or j/k to move, Enter to edit a field, toggle fail-fast, or cycle editor (vscode → cursor → textmate).
+
+The TUI uses a layout with numbered panels and a shared status bar:
+
+- **Panel 1 — Options**: Top bar (Tags, Format, Output, Example, Line, Fail-fast, Editor). Press `1` or `o` to focus; ←/→ or j/k to move, Enter to edit or toggle (Editor cycles vscode/cursor/textmate); `b` or Esc to unfocus.
+- **Panel 2 — Spec files**: Left panel (browse, →/← expand/collapse to show tests per file, Space to select files, Enter/s to run, `e` to run at line or run focused example, `O` to open selected file in editor).
+- **Panel 3 — Output/Results**: Right panel (idle message, live RSpec output, or results). Press `3` to focus when results are available.
+- **Status bar**: Key hints at the bottom. Press **`1`**, **`2`**, or **`3`** from anywhere to switch focus to that panel.
+
+The TUI stays open until you press `q` or Ctrl+C. You can:
+
+- **File list**: Browse spec files; press **→** to expand a file (list its tests) and **←** to collapse. Press **I** to **index** all spec files (builds a searchable cache with a progress bar; run once so find can match test names without expanding). Select files with Space, run with Enter or `s` (selected), `a` (all), `e` (run at line on a file, or run the focused example when on an example row), `f` (failed, after a run with failures). Use **/** to find; search matches file paths and test names for indexed (or expanded) files — put the cursor on a matched example and press Enter to run just that test. **Esc** or **Enter** exits find and collapses all files. Use **]** to expand all files and **\[** to collapse all.
+- **Options** (top bar): Always visible. Press `o` to focus; ←/→ or j/k to move, Enter to edit a field or toggle fail-fast; `b` or Esc to unfocus.
+- **Running**: See live RSpec output in the right panel. Press `q` to kill the run and return to the file list.
+- **Results**: In the right panel; j/k to move over failures, `e` to run that single example (path:line), `O` to open that file in your configured editor, `r` to rerun same scope, `f` to rerun only failed examples.
+
+### Key bindings
+
+| Key | Action |
+|-----|--------|
+| **1** | Focus panel 1 (Options) |
+| **2** | Focus panel 2 (Spec files) |
+| **3** | Focus panel 3 (Output/Results; only when results exist) |
+| q / Esc | Quit |
+
+| Key | Action (file list — panel 2) |
+|-----|------------------------------|
+| j / ↓ | Move down |
+| k / ↑ | Move up |
+| → | Expand file (show its tests) |
+| ← | Collapse file (or move to parent file and collapse) |
+| ] | Expand all files |
+| [ | Collapse all files |
+| Space | Toggle selection (files only) |
+| Enter | Run selected (or current file/example if none selected) |
+| a | Run all specs |
+| s | Run selected specs |
+| e | Run at line (prompt for line number on a file) or run this example (when on an example row) |
+| O | Open selected file (or example’s file at line) in configured editor (vscode/cursor/textmate) |
+| f | Run failed only (after a run with failures) |
+| I | Index all spec files (build cache for find; shows progress bar) |
+| o | Focus options (panel 1) |
+| R | Refresh file list |
+| q / Esc | Quit |
+
+| Key | Action (options bar — panel 1) |
+|-----|---------------------------------|
+| 2 | Focus panel 2 (Spec files) |
+| ← / → or j / k | Move between fields |
+| Enter | Edit field, toggle fail-fast, or cycle editor (vscode/cursor/textmate) |
+| b / Esc | Unfocus options, back to file list |
+| q | Quit |
+
+| Key | Action (results — panel 3) |
+|-----|----------------------------|
+| j / k | Move between failed examples |
+| e | Run this example only (path:line) |
+| O | Open this file in configured editor |
+| 2 / b / Esc | Back to file list |
+| r | Rerun same scope |
+| f | Rerun failed only |
+| q | Quit |
+
+## Requirements
+
+- Ruby 3.2+
+- A terminal (TTY)
+- RSpec in your project (the gem invokes `bundle exec rspec` or `rspec` via the CLI)
+
+## License
+
+MIT

data/exe/rdot

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+gem_root = File.expand_path('..', __dir__)
+require 'bundler/setup' if File.exist?(File.join(gem_root, 'Gemfile'))
+load File.expand_path('lib/red_dot.rb', gem_root)
+
+parsed = RedDot::Cli.parse(ARGV)
+RedDot.run(working_dir: parsed[:working_dir], option_overrides: parsed[:option_overrides])