hunch 2.0.2

A media filename parser for movies, TV, and anime — built in Rust, inspired by guessit
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# Code Coverage

Hunch tracks line, function, and region coverage via [`cargo-llvm-cov`](https://github.com/taiki-e/cargo-llvm-cov).
Run locally during release prep or when working on test-quality
improvements.

> The dedicated CI `Coverage` job that previously ran on every PR
> was removed in #216 as part of trimming over-engineered CI for a
> hobby-scale crate. The tooling and the local workflow are unchanged.

## Current baseline

Captured against `main` on **2026-04-18** (post v1.1.8, after PR #167):

| Dimension      | Coverage  | Total   | Missed |
|----------------|-----------|---------|--------|
| **Lines**      | **94.34%** | 15,030  | 851    |
| **Functions**  | **95.54%** | 1,054   | 47     |
| **Regions**    | **94.63%** | 8,571   | 460    |

Re-measure with:

```bash
cargo llvm-cov --workspace --summary-only
```

## Lowest-covered files (line %)

Useful targets for the next round of test-quality work (and for the upcoming
mutation-testing epic, [#146](https://github.com/lijunzh/hunch/issues/146)):

| File                                                | Line %  | Missed |
|-----------------------------------------------------|---------|--------|
| `src/properties/language.rs`                        | 79.67%  | 37     |
| `src/properties/date.rs`                            | 89.00%  | 55     |
| `src/properties/title/strategies/unclaimed_bracket.rs` | 90.91%  | 8      |
| `src/properties/part.rs`                            | 91.29%  | 37     |
| `src/properties/subtitle_language.rs`               | 91.99%  | 45     |
| `src/properties/website.rs`                         | 93.30%  | 14     |

Everything else is ≥ 94% line coverage. 273 of 282 unit tests pass on every
fixture; the missed lines are concentrated in a handful of long-tail edge
branches (rare locale codes, malformed date fragments, etc.).

## Running locally

Install once:

```bash
cargo install cargo-llvm-cov --locked
rustup component add llvm-tools-preview
```

Generate a quick summary:

```bash
cargo llvm-cov --workspace --summary-only
```

Generate a full HTML report (open in browser):

```bash
cargo llvm-cov --workspace --html --open
```

Generate the LCOV file CI uploads (for IDE coverage gutters or external tools):

```bash
cargo llvm-cov --workspace --lcov --output-path lcov.info
```

## Roadmap

Long-term ideas, not actively planned post-#216:

- **Codecov.io / Coveralls integration** — the LCOV file is in the
  right shape if anyone wants to wire it up. Local-only for now.
- **Branch coverage** — `cargo-llvm-cov` reports it; the line-coverage
  baseline above is the project's primary signal.

## Notes

- **Why not 100%**: parser code intentionally has permissive fallback branches
  (e.g., "we couldn't decide, return the empty result") that aren't worth
  contorting tests to hit. ≥ 94% is the realistic ceiling for this codebase.