|
59 | 59 | values.** Inside a `satisfies(AttributeKey, Consumer)` lambda the parameter (e.g., `taskId`) is |
60 | 60 | an `AbstractStringAssert<?>` (for string keys), `AbstractLongAssert<?>` (for long keys), etc. |
61 | 61 | Fluent assertion calls like `taskId.contains(jobName)` or `taskId.startsWith(prefix)` are |
62 | | -already proper AssertJ assertions — they throw on failure. Do **not** wrap them in |
| 62 | +already proper AssertJ assertions - they throw on failure. Do **not** wrap them in |
63 | 63 | `assertThat(value.contains(x)).isTrue()`, which degrades the failure message. |
64 | 64 |
|
65 | | -- For `satisfies(AttributeKey, lambda)` outer parameters, use `val`. |
| 65 | +- For `satisfies(AttributeKey, lambda)` outer parameters, use `val` in Java. |
| 66 | + In Scala, use `value` instead, since `val` is a reserved word. |
66 | 67 | Do not use short generic alternatives like `k` or `v` for the outer parameter. |
67 | 68 | - If an attribute-assertion `satisfies(...)` lambda contains a nested inner lambda and a second |
68 | | - parameter name is required, keep the outer parameter as `val` and use `v` for the nested |
69 | | - parameter. |
| 69 | + parameter name is required, keep the outer parameter as `val` in Java or `value` in Scala, |
| 70 | + and use `v` for the nested parameter. |
70 | 71 | - This naming guidance does **not** apply to non-attribute `satisfies(...)` usages such as |
71 | 72 | `span.satisfies(...)`, `point.satisfies(...)`, or `assertThat(result).satisfies(...)`. |
72 | 73 | In those cases, prefer a descriptive subject name like `spanData`, `pointData`, `resource`, |
|
0 commit comments