Technical Debt

The cost of additional rework caused by choosing an easy (limited) solution now instead of using a better approach that would take longer. The metric count debt based on pattern:

• todo comment

void fooBar() {
  // TODO: need migrate on logger
  debugPrint('log');
}

• suppressing rules comment

// ignore_for_file: unused_local_variable

void fooBar() {
  // ignore: invalid_assignment
  int x = '';
}

• cast to dynamic

void fooBar() {
  final a = Foo() as dynamic;
}

• Deprecated annotation comment

@Deprecated('Use Bar class')
class Foo {}

• Non migrated files on nullsafety

// @dart=2.9

void fooBar() {
  debugPrint('log');
}

You can configure cost of every supported case, and specify unit type of the debt.

Config example

dart_code_linter:
  ...
  metrics:
    ...
    technical-debt:
      threshold: 1
      todo-cost: 161
      ignore-cost: 320
      ignore-for-file-cost: 396
      as-dynamic-cost: 322
      deprecated-annotations-cost: 37
      file-nullsafety-migration-cost: 41
      unit-type: "USD"
    ...

Example

// @dart=2.9

// ignore_for_file: always_declare_return_types

@Deprecated('Use Bar class')
class Foo {}

// TODO(developer): flutter style todo comment
void fooBar() {
  // ignore: always_put_control_body_on_new_line
  final a = Foo() as dynamic;
}

Technical Debt for the example function is 955 USD.