pkg/linter/lib/src/rules/super_goes_last.dart

// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import '../analyzer.dart';

const _desc =
    r'Place the `super` call last in a constructor initialization list.';

const _details = r'''
NOTE: This rule is removed in Dart 3.0.0; it is no longer functional.

**DO** place the `super` call last in a constructor initialization list.

Field initializers are evaluated in the order that they appear in the
constructor initialization list.  If you place a `super()` call in the middle of
an initializer list, the superclass's initializers will be evaluated right then
before evaluating the rest of the subclass's initializers.

What it doesn't mean is that the superclass's constructor body will be executed
then.  That always happens after all initializers are run regardless of where
`super` appears.  It's vanishingly rare that the order of initializers matters,
so the placement of `super` in the list almost never matters either.

Getting in the habit of placing it last improves consistency, visually
reinforces when the superclass's constructor body is run, and may help
performance.

**BAD:**
```dart
View(Style style, List children)
    : super(style),
      _children = children {
```

**GOOD:**
```dart
View(Style style, List children)
    : _children = children,
      super(style) {
```

''';

class SuperGoesLast extends LintRule {
  static const LintCode code = LintCode('super_goes_last',
      "Place the 'super' call last in an initialization list.",
      correctionMessage:
          "Try moving the 'super' invocation to the end of the initialization "
          'list.');

  SuperGoesLast()
      : super(
            name: 'super_goes_last',
            description: _desc,
            details: _details,
            state: State.removed(since: dart3),
            categories: {Category.style});

  @override
  LintCode get lintCode => code;
}