pretender 0.3.1

Multi-language structural code-quality checks — complexity, duplication, mutation testing, and CI integration
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

# Java

Reference for which tree-sitter nodes pretender tracks for Java files, how
each contributes to `pretender check` metrics, and known measurement gaps.
Consult this page when tuning thresholds or diagnosing unexpected scores.

## Overview

Analyses `.java` files using a tree-sitter grammar. Tracks both method
declarations and constructors as function scopes. Enhanced `for` loops and
`switch` statement groups each count as separate branches.

## Tracked nodes

| Tree-sitter node | Capture | Metric impact |
|-----------------|---------|---------------|
| `method_declaration` | `@function.definition` | Defines a metric scope |
| `constructor_declaration` | `@function.definition` | Defines a metric scope |
| `if_statement` | `@branch.if` | +1 cyclomatic, +1 cognitive |
| `for_statement` | `@branch.loop` | +1 cyclomatic, +1 cognitive |
| `enhanced_for_statement` | `@branch.loop` | +1 cyclomatic, +1 cognitive |
| `while_statement` | `@branch.loop` | +1 cyclomatic, +1 cognitive |
| `do_statement` | `@branch.loop` | +1 cyclomatic, +1 cognitive |
| `catch_clause` | `@branch.catch` | +1 cyclomatic, +1 cognitive |
| `ternary_expression` | `@branch.ternary` | +1 cyclomatic, +1 cognitive |
| `switch_block_statement_group` / `switch_label` | `@branch.case` | +1 cyclomatic, +1 cognitive |
| `binary_expression` `"&&"` | `@branch.logical.and` | +1 cyclomatic, +1 cognitive |
| `binary_expression` `"||"` | `@branch.logical.or` | +1 cyclomatic, +1 cognitive |
| `method_invocation` | `@call` | +1 ABC C-count |
| `object_creation_expression` | `@call` | +1 ABC C-count |
| `assignment_expression` | `@assign` | +1 ABC A-count |
| `variable_declarator` (with value) | `@assign` | +1 ABC A-count |

## Assertion patterns

| Pattern | Matches |
|---------|---------|
| `^assert` | JUnit `assertNotNull(...)`, etc. |
| `^Assert` | `Assert.assertEquals(...)` (static import) |
| `^verify` | Mockito `verify(...)` |
| `^Verify` | `Verify.that(...)` |
| `^expect` | `expectedException.expect(...)` |
| `^fail` | `fail("message")` |

## Quirks and limitations

- **`instanceof` checks** inside `if` conditions are counted as regular
  `if_statement` branches — no special handling for pattern-matching
  `instanceof` (Java 16+).
- **Lambda expressions** are not tracked as function scopes; their branches
  count toward the enclosing method's complexity.
- **`switch` expressions** (Java 14+) may not be fully parsed by the current
  grammar revision — verify with a test file if you rely on switch-expression
  branch counts.
- **`object_creation_expression`** (`new Foo(...)`) counts as a call for
  ABC C-count, which may inflate scores in builder-heavy code.
- **Mutation testing** (`pretender mutation`) does not yet run PIT automatically.
  See [Mutation testing](../../docs/mutation.md) for the manual workflow.

## Example output

```
src/main/java/Service.java  cyclomatic=9  cognitive=13  function_lines=47  params=3
src/main/java/Parser.java  cyclomatic=15  cognitive=21  function_lines=68  params=4
  ↳ parse()  cyclomatic=15  [threshold: 10]
```