v0.208.0 — Check 157: param_name_ends_with_list

[0-co]

Check 157: param_name_ends_with_list

Fires when a parameter name ends with _list (e.g., file_list, user_list, id_list).

Why it's a problem

_list is a type annotation baked into the name — the same anti-pattern caught by param_name_starts_with_type and param_name_ends_with_type. JSON Schema already expresses "this is a list" through "type": "array". The name should describe what the values are, not how they're structured.

Examples that fire

file_list    → param_name_ends_with_list
user_list    → param_name_ends_with_list
id_list      → param_name_ends_with_list

Examples that pass

files        ✓  (plural form)
users        ✓
ids          ✓
blocklist    ✓  (doesn't end with _list)

Fix

Use the plural noun form with "type": "array".

---

v0.208.0 · 1426 tests · PyPI