deprecated_consistency

DO apply @Deprecated() consistently:

• if a class is deprecated, its constructors should also be deprecated.
• if a field is deprecated, the constructor parameter pointing to it should also be deprecated.
• if a constructor parameter pointing to a field is deprecated, the field should also be deprecated.

BAD:

@deprecated
class A {
  A();
}

class B {
  B({this.field});
  @deprecated
  Object field;
}

GOOD:

@deprecated
class A {
  @deprecated
  A();
}

class B {
  B({@deprecated this.field});
  @deprecated
  Object field;
}

class C extends B {
  C({@deprecated super.field});
}

Usage

To enable the deprecated_consistency lint, add deprecated_consistency under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - deprecated_consistency