pkg/linter/test/rules/unnecessary_underscores_test.dart

// Copyright (c) 2025, 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 'package:test_reflective_loader/test_reflective_loader.dart';

import '../rule_test_support.dart';

void main() {
  defineReflectiveSuite(() {
    defineReflectiveTests(UnnecessaryUnderscoresTest);
  });
}

@reflectiveTest
class UnnecessaryUnderscoresTest extends LintRuleTest {
  @override
  String get lintRule => 'unnecessary_underscores';

  test_commentReferenceFunction() async {
    await assertNoDiagnostics('''
/// This is a reference to [__].
void f(int __) {}
''');
  }

  test_commentReferenceMethod() async {
    await assertNoDiagnostics('''
class C {
  /// This is a reference to [__].
  void m(int __) {}
}
''');
  }

  test_commentReferencePrimaryConstructor() async {
    await assertNoDiagnostics('''
class C(int __) {
  /// This is a reference to [__].
  this;
}
''');
  }

  test_enum_field_unused() async {
    await assertNoDiagnostics(r'''
enum E {
  __,
}
''');
  }

  test_field_originPrimaryConstructor_unused() async {
    await assertNoDiagnostics(r'''
// ignore: unused_field_from_primary_constructor
class C(final int __);
''');
  }

  test_field_unused() async {
    await assertNoDiagnostics(r'''
class C {
  int __ = 0;
}
''');
  }

  test_forPart_unused() async {
    await assertDiagnosticsFromMarkup(r'''
void f() {
  for (var [!__!] = 0; ; ) {}
}
''');
  }

  test_forPart_used() async {
    await assertNoDiagnostics(r'''
void f() {
  for (var __ = 0; ; ++__) {}
}
''');
  }

  test_function_parameter_unused() async {
    await assertDiagnosticsFromMarkup(r'''
void f(int _, int [!__!]) {}
''');
  }

  test_function_parameter_unused_preWildcards() async {
    await assertNoDiagnostics(r'''
// @dart = 3.6

void f(int _, int __) {}
''');
  }

  test_function_parameter_used() async {
    await assertNoDiagnostics(r'''
void f(int _, int __) {
  print(__);
}
''');
  }

  test_local_unused() async {
    await assertDiagnosticsFromMarkup(r'''
void f() {
  var [!__!] = 0;
}
''');
  }

  test_local_used() async {
    await assertNoDiagnostics(r'''
void f() {
  var __ = 0;
  print(__);
}
''');
  }

  test_localFunction_parameter_unused() async {
    await assertDiagnosticsFromMarkup(r'''
void f() {
  g(int [!__!]) {}
}
''');
  }

  test_localFunction_parameter_used() async {
    await assertNoDiagnostics(r'''
void f() {
  g(int __) {
    print(__);
  }
}
''');
  }

  test_localFunction_unused() async {
    await assertNoDiagnostics(r'''
f() {
  __() {}
}
''');
  }

  test_method_unused() async {
    await assertNoDiagnostics(r'''
class A {
  __() {}
}
''');
  }

  test_parameter_declaring_unused() async {
    await assertNoDiagnostics(r'''
// ignore: unused_field_from_primary_constructor
class C(final int _, final int __);
''');
  }

  test_topLevelFunction_unused() async {
    await assertNoDiagnostics(r'''
__() {}
''');
  }

  test_topLevelVariable_unused() async {
    await assertNoDiagnostics(r'''
int __ = 0;
''');
  }
}