dartfix 0.1.4

The dartfix tool is a command-line interface for making automated updates to your Dart code. The tool isn't in the Dart SDK; instead, it's distributed in the dartfix package.

Usage #

Important: Save a copy of your source code before making changes with dartfix. Unlike dartfmt, which makes only safe changes (usually to whitespace), dartfix can make changes that you might need to undo or modify.

Before you can use the dartfix tool, you need to install it, as described below. Then invoke it with the name of the directory that you want to update. When you're ready to make the suggested changes, add the --overwrite option.

$ dartfix examples/misc
... summary of recommended changes ...
$ dartfix examples/misc --overwrite

Features #

As of release 0.1.3, dartfix can make the following changes to your code:

  • Convert code to use the following features added to Dart in 2.1:

    • Find classes used as mixins, and convert them to use the mixin keyword instead of class.
    • Find double literals that end in .0, and remove the .0.
  • Move named constructor type arguments from the name to the type.
    For example, given class A<T> { A.from(Object obj) { } }, dartfix changes constructor invocations in the following way:

    Original code:
    A.from<String>(anObject) // Invokes the `A.from` named constructor.
    
    Code produced by dartfix:
    A<String>.from(anObject) // Same, but the type is directly after `A`.
    

Installing and updating dartfix #

The easiest way to use dartfix is to globally install it, so that it can be in your path:

$ pub global activate dartfix

Use the same command to update dartfix. We recommend updating dartfix whenever you update your Dart SDK or when a new feature is released.

Options #

--[no-]color
Use colors when printing messages. On by default.
-f, --force
Apply the recommended changes even if the input code has errors.
-h, --help
See a complete list of `dartfix` options.
-v, --verbose
Verbose output.
-w, --overwrite
Apply the recommended changes.

Filing issues #

If you want a new fix, first look at dartfix issues and star the fixes you want. If no issue exists for the fix, create a GitHub issue.

0.1.4 #

  • update protocol version constraints

0.1.3 #

  • update SDK constraints

0.1.2 #

  • update SDK constraints
  • add example.dart showing what can be "fixed"

0.1.1 #

  • Remove reading dartfix version from pubspec

0.1.0 #

  • Initial version

example/example.dart

// This file contains code that is modified by running dartfix.
// After running dartfix, the content of this file matches example-fixed.dart.

// Dart will automatically convert int literals to doubles.
// Running dartfix converts this double literal to an int.
const double myDouble = 4.0;

// This class is used as a mixin but does not use the new mixin syntax.
// Running dartfix converts this class to use the new syntax.
class MyMixin {
  final someValue = myDouble;
}

class MyClass with MyMixin {}

main() {
  print('myDouble = ${MyClass().someValue}');
}

Use this package as an executable

1. Install it

You can install the package from the command line:


$ pub global activate dartfix

2. Use it

The package has the following executables:


$ dartfix

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  dartfix: ^0.1.4

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter pub get

Alternatively, your editor might support pub get or flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:dartfix/handler/analysis_complete_handler.dart';
import 'package:dartfix/listener/bad_message_listener.dart';
import 'package:dartfix/listener/recording_listener.dart';
import 'package:dartfix/listener/timed_listener.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
37
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
100
Overall:
Weighted score of the above. [more]
68
Learn more about scoring.

We analyzed this package on Sep 20, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.5.0
  • pana: 0.12.21

Platforms

Detected platforms: Flutter, other

Platform components identified in package: io.

Health suggestions

Fix lib/src/driver.dart. (-0.50 points)

Analysis of lib/src/driver.dart reported 1 hint:

line 57 col 7: Future results in async function bodies must be awaited or marked unawaited using package:pedantic.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.1.0 <3.0.0
analysis_server_client 1.1.1 1.1.1
args ^1.4.0 1.5.2
cli_util ^0.1.3 0.1.3+2
path ^1.6.0 1.6.4
pub_semver ^1.4.2 1.4.2
Transitive dependencies
collection 1.14.12
Dev dependencies
analyzer ^0.33.0
test ^1.3.0