Name: dart2_fix
Owner: Dart
Description: A tool to migrate API usage to Dart 2
Created: 2018-03-27 17:23:11.0
Updated: 2018-05-17 19:25:43.0
Pushed: 2018-05-17 19:26:25.0
Homepage: https://pub.dartlang.org/packages/dart2_fix
Size: 49
Language: Dart
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
A tool to migrate API usage to Dart 2.
dart2_fix
is a command line utility that can automatically migrate some Dart 1 API usages in your
source code to Dart 2 ones. Currently, it focuses on updating deprecated constant names; for example:
dart:convert
's UTF8
to utf8
dart:core
's Duration.ZERO
to Duration.zero
dart:math
's PI
to pi
For more information about preparing your code for Dart 2, please see the Dart 2 migration guide.
To install, run pub global activate dart2_fix
. Then, from your project directory, run:
pub global run dart2_fix
When run without any arguments, it will check your project, but will not make changes; it'll indicate what would be changed if asked to make modifications. For example:
/test/runner/load_suite_test.dart
ne 56 ? Duration.ZERO => Duration.zero
ne 60 ? Duration.ZERO => Duration.zero
ne 86 ? Duration.ZERO => Duration.zero
/tool/host.dart
ne 169 ? JSON => json
ne 173 ? JSON => json
d 5 fixes in 2.3s.
pply these fixes, run again using the --apply argument.
To actually modify your project source code, run with the --apply
argument (pub global run dart2_fix --apply
):
ting test...
/test/runner/load_suite_test.dart
fixes applied for Duration.ZERO => Duration.zero
/tool/host.dart
fixes applied for JSON => json
ied 5 fixes in 1.9s.
To run this tool on Flutter code, use:
ter packages pub global activate dart2_fix
then - to check your code - run:
ter packages pub global run dart2_fix
and to apply fixes, run:
ter packages pub global run dart2_fix --apply
No. Currently this only fixes the renaming of various deprecated constant
names. Some of the less uniform constant renamings are not handled by this
tool. For example Endianness.BIG_ENDIAN
has been renamed to Endian.big
but
this will not be caught. After running this tool, remaining issues can be found
by running the dart analyzer (or flutter analyze) and fixing any deprecation
warnings.
This tool can't catch conflicts between the new constant names and any fields or
local variables that you might have in scope. If you get new analysis warnings
or runtime failures after running this tool, check to see whether one of the
changes made has caused a naming conflict with something else in scope. The
most common cause of this is having a local variable named json
in a scope
where JSON.decode
gets renamed to json.decode
. To help with fixing these
kinds of conflicts, the following top level members have been added to
dart:convert
: jsonDecode
, jsonEncode
, base64Decode
, base64Encode
, and
base64UrlEncode
. These top level members are equivalent to json.decode
,
json.decode
, etc, and can be used to avoid naming conflicts where required.
Please file feature requests and bugs at the issue tracker.