unnecessary_library_name

Não tenha nome de biblioteca em uma declaração library.

NÃO tenha nome de biblioteca em uma declaração library.

Nomes de biblioteca não são necessários.

Uma biblioteca não precisa de declaração de biblioteca, mas uma pode ser adicionada para anexar documentação e metadados de biblioteca. A declaração library; é suficiente para esses usos.

O único uso de um nome de biblioteca é para que um arquivo part se refira à sua biblioteca dona, mas arquivos part devem preferir usar uma URI em string para se referir de volta ao arquivo da biblioteca, e não a um nome de biblioteca.

Se um nome de biblioteca for adicionado a uma declaração de biblioteca, isso introduz o risco de conflitos de nome. É um erro de compilação se duas bibliotecas no mesmo programa tiverem o mesmo nome. Para evitar isso, nomes de biblioteca tendem a ser longos, incluindo o nome do pacote e o caminho, só para evitar colisões acidentais. Isso torna esses nomes difíceis de ler e nada úteis como documentação.

RUIM:

/// This library has a long name.
library magnificator.src.helper.bananas;

library utils; // Not as verbose, but risks conflicts.

BOM:

/// This library is awesome.
library;
​
part "apart.dart"; // contains: `part of "good_library.dart";`

Para ativar a regra unnecessary_library_name, adicione unnecessary_library_name em linter > rules no seu arquivo analysis_options.yaml:

linter:
  rules:
    - unnecessary_library_name

Se você usa a sintaxe de mapa YAML para configurar as regras de lint, adicione unnecessary_library_name: true em linter > rules:

linter:
  rules:
    unnecessary_library_name: true