Skip to main content
Pro+

Fix

Fixes issues produced by dcm analyze, dcm check-unused-code, dcm check-unused-files or dcm check-dependencies commands.

info

Some quick fixes can break your code (e.g. the avoid-unused-parameters fix removes a parameter, but any invocation will still have an argument for that parameter). It's up to you to choose the fixes and to ensure that the code works after they are applied.

To execute the command, run:

$ dcm fix lib # or dcm f lib

Full command description:

Usage: dcm fix [arguments] <directories>
-h, --help                                       Print this usage information.


-t, --type=<lints>                               Type of issues to fix.
                                                 [lints (default), unused-code, unused-files, dependencies]
    --unsafe                                     Include unsafe fixes (fixes that can change the meaning/intent of your code). Works only for lints.
    --apply-to=<.*.g.dart>                       List of file to apply fixes to (all by default).
    --dry-run                                    Preview the proposed changes but make no changes.


    --include-rules=<rule-id1,rule-id2,...>      Include additional lint rules that are not listed in the config.
    --exclude-rules=<rule-id1,rule-id2,...>      Exclude lint rules from the fixes calculation.
    --only-rules=<rule-id1,rule-id2,...>         Calculate fixes for only listed rules.


Unused code options:
    --no-exclude-overridden                      Do not treat overridden members as always used.


Formatter options:
-l, --line-length                                Wrap lines longer than this.
-i, --indent                                     Add this many spaces of leading indentation.
    --cascading-widget-extensions                Format widget extensions in a more readable way.


-c, --print-config                               Print resolved config.


    --root-folder=<./>                           Root folder.
                                                 (defaults to the current directory)
-s, --sdk-path=<directory-path>                  Dart SDK directory path.
                                                 If the project has a `.fvm/flutter_sdk` symlink, it will be used if the SDK is not found.
-e, --exclude=<{**/*.g.dart,**/*.freezed.dart}>  Files to exclude (in Glob syntax).
                                                 (defaults to "{**/*.g.dart,**/*.freezed.dart}")


    --[no-]congratulate                          Don't show output even when there are no issues.


    --verbose                                    Show verbose logs.


    --ci-key                                     The license key to run on CI server.
    --email                                      The email used to purchase the license.


    --no-analytics                               Disable sending anonymous usage statistics.


    --exclude-public-api (--ep)                  Exclude publicly exported code from the analysis output.

Currently Supported Rules​

Almost all rules that have 🛠 are supported by dcm fix.

Rules with auto-fixes, but not fixable by dcm fix:

Of the 143 rules that support auto-fixes, here is the list of those (48 rule) that cannot be fixed from the CLI:

  • avoid-banned-annotations
  • avoid-banned-imports
  • avoid-bloc-public-methods
  • avoid-bloc-public-fields
  • avoid-cascade-after-if-null
  • avoid-casting-to-extension-type
  • avoid-declaring-call-method
  • avoid-double-slash-imports
  • avoid-duplicate-cascades
  • avoid-duplicate-map-keys
  • avoid-duplicate-mixins
  • avoid-duplicate-patterns
  • avoid-duplicate-test-assertions
  • avoid-empty-test-groups
  • avoid-equal-expressions
  • avoid-importing-entrypoint-exports
  • avoid-missing-image-alt
  • avoid-missing-tr
  • avoid-mutable-rx-variables
  • avoid-non-final-exception-class-fields
  • avoid-renaming-representation-getters
  • avoid-suspicious-super-overrides
  • avoid-top-level-members-in-tests
  • avoid-unnecessary-if
  • avoid-unsafe-collection-methods
  • correct-game-instantiating
  • match-positional-field-names-on-assignment
  • move-records-to-typedefs
  • move-variable-outside-iteration
  • prefer-action-button-tooltip
  • prefer-any-or-every
  • prefer-correct-bloc-provider
  • prefer-correct-error-name
  • prefer-correct-future-return-type
  • prefer-correct-setter-parameter-name
  • prefer-correct-stream-return-type
  • prefer-correct-throws
  • prefer-dedicated-media-query-methods
  • prefer-define-hero-tag
  • prefer-explicit-type-arguments
  • prefer-match-file-name
  • prefer-parentheses-with-if-null
  • prefer-private-extension-type-field
  • prefer-public-exception-classes
  • prefer-specific-cases-first
  • prefer-text-rich
  • prefer-widget-private-members
  • tag-name

Unsafe Fixes​

Some fixes can change the meaning/intent of your code and are considered unsafe. Such fixes are disabled by default.

To enabled unsafe fixes, pass the --unsafe CLI option.

Rules with unsafe fixes:
  • avoid-unused-parameters
  • avoid-unnecessary-super
  • avoid-unnecessary-nullable-return-type
  • use-existing-variable

Overriding the Rules Set​

By default, the command takes the rules list from the configuration, but you can override this behavior with several CLI options:

  1. --include-rules allows you to add rules that are not listed in your config, but you want to apply their fixes as well
  2. Use --exclude-rules to exclude rules listed in your config from fixes calculation
  3. Use --only-rules to run calculate fixes only for the given list of rules

Dry Run​

If you want to see the proposed changes without applying them, run the command with the --dry-run option. It will output the code that will be changed marking removed code with the red color and the code that will be added with the green.

Removing Unused Code​

To remove unused code with dcm fix set the --type option to unused-code --type=unused-code. To exclude publicly exported code, don't forget to pass --exclude-public-api.

Removing Unused Files​

To remove unused files with dcm fix set the --type option to unused-files --type=unused-files. To exclude publicly exported code, don't forget to pass --exclude-public-api.

Fixing Dependency Issues​

To fix dependency issus with dcm fix set the --type option to dependencies --type=dependencies.