library_annotations

Attach library annotations to library directives.

Attach library annotations to library directives, rather than some other library-level element.

BAD:

@TestOn('browser')

import 'package:test/test.dart';

void main() {}

GOOD:

@TestOn('browser')
library;

import 'package:test/test.dart';

void main() {}

NOTE: An unnamed library, like library; above, is only supported in Dart 2.19 and later. Code which might run in earlier versions of Dart will need to provide a name in the library directive.

To enable the library_annotations rule, add library_annotations under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - library_annotations

If you're instead using the YAML map syntax to configure linter rules, add library_annotations: true under linter > rules:

linter:
  rules:
    library_annotations: true

Unless stated otherwise, the documentation on this site reflects Dart 3.6.2. Page last updated on 2025-01-27. View source or report an issue.