guptarohit / asciigraph / 27907009380

93%

push

github

feat: add ColorAbove/ColorBelow threshold coloring option (library + CLI) (#85)

Closes #38.

Adds value-based threshold coloring: highlight points that breach an
upper or
lower limit, regardless of which series they belong to.

## API

```go
asciigraph.Plot(data,
    asciigraph.ColorAbove(asciigraph.Red, 80),   // points above 80 → red
    asciigraph.ColorBelow(asciigraph.Green, 20), // points below 20 → green
)
```

- **`ColorAbove(color, threshold)`** colors points whose value is
**strictly above** `threshold`.
- **`ColorBelow(color, threshold)`** colors points whose value is
**strictly below** `threshold`.
- Bounds are **exclusive** (`>` / `<`), matching the literal meaning of
"above"/"below".
- Applies **across all series** (a single global threshold, not
per-series).
- **Precedence:** thresholds take precedence over `SeriesColorGradient`
and
`SeriesColors`; points in between keep their normal color. If a point
matches
both `ColorAbove` and `ColorBelow` (overlapping thresholds),
`ColorAbove` wins.

## CLI

```bash
seq 1 100 | asciigraph -h 10 -ca red,80 -cb green,20
```

- `-ca color,value` → color points above the value
- `-cb color,value` → color points below the value

---------

Co-authored-by: MihirMohapatra <kumarmihir79@gmail.com>
Co-authored-by: Rohit Gupta <rohitgtech+git@gmail.com>

19 of 19 new or added lines in 2 files covered. (100.0%)

690 of 741 relevant lines covered (93.12%)

1445.42 hits per line