Merge branch 'master' into nnbd-non-migration-second

Author: jcollins-g

analysis_options.yaml

@@ -21,21 +21,39 @@ linter:
     - avoid_unused_constructor_parameters
     - annotate_overrides
     - avoid_init_to_null
-    - avoid_types_as_parameter_names
-    - camel_case_types
     - directives_ordering
-    - iterable_contains_unrelated_type
-    - list_remove_unrelated_type
     - no_adjacent_strings_in_list
     - package_api_docs
     - prefer_final_fields
-    - prefer_generic_function_type_aliases
     - prefer_initializing_formals
     - prefer_void_to_null
-    - provide_deprecation_message
     - slash_for_doc_comments
     - type_annotate_public_apis
-    - unawaited_futures
     #    - unnecessary_brace_in_string_interps
+    # Work in progress canonical score lints
+    - avoid_empty_else
+    - avoid_relative_lib_imports
+    - avoid_shadowing_type_parameters
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - curly_braces_in_flow_control_structures
+    - empty_catches
+    - file_names
+    - hash_and_equals
+    - iterable_contains_unrelated_type
+    - list_remove_unrelated_type
+    - no_duplicate_case_values
+    #    - non_constant_identifier_names
+    - package_prefixed_library_names
+    - prefer_generic_function_type_aliases
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_iterable_whereType
+    - prefer_typing_uninitialized_variables
+    - provide_deprecation_message
+    - unawaited_futures
     - unnecessary_overrides
+    - unrelated_type_equality_checks
+    - valid_regexps
     - void_checks

analysis_options_presubmit.yaml

@@ -20,15 +20,43 @@ analyzer:
 linter:
   rules:
     - always_declare_return_types
+    - avoid_single_cascade_in_expression_statements
+    - avoid_unused_constructor_parameters
     - annotate_overrides
     - avoid_init_to_null
-    - avoid_types_as_parameter_names
     - directives_ordering
     - no_adjacent_strings_in_list
     - package_api_docs
     - prefer_final_fields
-    - prefer_generic_function_type_aliases
+    - prefer_initializing_formals
+    - prefer_void_to_null
     - slash_for_doc_comments
     - type_annotate_public_apis
+    #    - unnecessary_brace_in_string_interps
+    # Work in progress canonical score lints
+    - avoid_empty_else
+    - avoid_relative_lib_imports
+    - avoid_shadowing_type_parameters
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - curly_braces_in_flow_control_structures
+    - empty_catches
+    - file_names
+    - hash_and_equals
+    - iterable_contains_unrelated_type
+    - list_remove_unrelated_type
+    - no_duplicate_case_values
+    #    - non_constant_identifier_names
+    - package_prefixed_library_names
+    - prefer_generic_function_type_aliases
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_iterable_whereType
+    - prefer_typing_uninitialized_variables
+    - provide_deprecation_message
     - unawaited_futures
-#    - unnecessary_brace_in_string_interps
+    - unnecessary_overrides
+    - unrelated_type_equality_checks
+    - valid_regexps
+    - void_checks

lib/dartdoc.dart

@@ -392,8 +392,8 @@ class Dartdoc {
       }
     }
     // Missing from search index
-    var missing_from_search = visited.difference(found);
-    for (var s in missing_from_search) {
+    var missingFromSearch = visited.difference(found);
+    for (var s in missingFromSearch) {
       _warn(packageGraph, PackageWarning.missingFromSearchIndex, s,
           path.normalize(origin),
           referredFrom: fullPath);

lib/src/dartdoc_options.dart

@@ -335,7 +335,7 @@ class ToolConfiguration {
     for (var entry in yamlMap.entries) {
       var name = entry.key.toString();
       var toolMap = entry.value;
-      var description;
+      String description;
       List<String> command;
       List<String> setupCommand;
       if (toolMap is Map) {
@@ -1130,7 +1130,7 @@ abstract class _DartdocFileOption<T> implements DartdocOption<T> {
       yamlData = yamlData[key] ?? {};
     }
 
-    var returnData;
+    dynamic returnData;
     if (_isListString) {
       if (yamlData is YamlList) {
         returnData = <String>[];

lib/src/generator/dartdoc_generator_backend.dart

@@ -77,7 +77,7 @@ abstract class DartdocGeneratorBackend implements GeneratorBackend {
       TemplateData data) {
     var content = template.renderString(data);
     if (!options.useBaseHref) {
-      content = content.replaceAll(HTMLBASE_PLACEHOLDER, data.htmlBase);
+      content = content.replaceAll(htmlBasePlaceholder, data.htmlBase);
     }
     writer.write(filename, content,
         element: data.self is Warnable ? data.self : null);
@@ -89,7 +89,7 @@ abstract class DartdocGeneratorBackend implements GeneratorBackend {
     var json = generator_util.generateCategoryJson(
         categories, options.prettyIndexJson);
     if (!options.useBaseHref) {
-      json = json.replaceAll(HTMLBASE_PLACEHOLDER, '');
+      json = json.replaceAll(htmlBasePlaceholder, '');
     }
     writer.write(_pathContext.join('categories.json'), '${json}\n');
   }
@@ -99,7 +99,7 @@ abstract class DartdocGeneratorBackend implements GeneratorBackend {
     var json = generator_util.generateSearchIndexJson(
         indexedElements, options.prettyIndexJson);
     if (!options.useBaseHref) {
-      json = json.replaceAll(HTMLBASE_PLACEHOLDER, '');
+      json = json.replaceAll(htmlBasePlaceholder, '');
     }
     writer.write(_pathContext.join('index.json'), '${json}\n');
   }
@@ -228,5 +228,6 @@ abstract class DartdocGeneratorBackend implements GeneratorBackend {
   }
 
   @override
-  void generateAdditionalFiles(FileWriter writer, PackageGraph graph) {}
+  Future<void> generateAdditionalFiles(
+      FileWriter writer, PackageGraph graph) async {}
 }

lib/src/generator/generator_frontend.dart

@@ -329,5 +329,5 @@ abstract class GeneratorBackend {
       FileWriter writer, PackageGraph graph, Library library, Typedef typedef);
 
   /// Emit files not specific to a Dart language element.
-  void generateAdditionalFiles(FileWriter writer, PackageGraph graph);
+  Future<void> generateAdditionalFiles(FileWriter writer, PackageGraph graph);
 }

lib/src/generator/html_generator.dart

@@ -38,7 +38,8 @@ class HtmlGeneratorBackend extends DartdocGeneratorBackend {
   }
 
   @override
-  void generateAdditionalFiles(FileWriter writer, PackageGraph graph) async {
+  Future<void> generateAdditionalFiles(
+      FileWriter writer, PackageGraph graph) async {
     await _copyResources(writer);
     if (options.favicon != null) {
       // Allow overwrite of favicon.

lib/src/generator/template_data.dart

@@ -46,7 +46,7 @@ abstract class TemplateData<T extends Documentable> {
 
   String get bareHref {
     if (self is Indexable) {
-      return (self as Indexable).href.replaceAll(HTMLBASE_PLACEHOLDER, '');
+      return (self as Indexable).href.replaceAll(htmlBasePlaceholder, '');
     }
     return '';
   }

lib/src/generator/templates.renderers.dart

@@ -3,7 +3,7 @@
 // To change the contents of this library, make changes to the builder source
 // files in the tool/mustachio/ directory.
 
-// ignore_for_file: camel_case_types, unnecessary_cast, unused_element, unused_import
+// ignore_for_file: camel_case_types, unnecessary_cast, unused_element, unused_import, non_constant_identifier_names
 import 'package:analyzer/file_system/file_system.dart';
 import 'package:dartdoc/src/generator/template_data.dart';
 import 'package:dartdoc/dartdoc.dart';

lib/src/markdown_processor.dart

@@ -163,23 +163,23 @@ final RegExp operatorPrefix = RegExp(r'^operator[ ]*');
 
 final HtmlEscape htmlEscape = const HtmlEscape(HtmlEscapeMode.element);
 
-final List<md.InlineSyntax> _markdown_syntaxes = [
+final List<md.InlineSyntax> _markdownSyntaxes = [
   _InlineCodeSyntax(),
   _AutolinkWithoutScheme(),
   md.InlineHtmlSyntax(),
   md.StrikethroughSyntax(),
   md.AutolinkExtensionSyntax(),
 ];
 
-final List<md.BlockSyntax> _markdown_block_syntaxes = [
+final List<md.BlockSyntax> _markdownBlockSyntaxes = [
   const md.FencedCodeBlockSyntax(),
   const md.HeaderWithIdSyntax(),
   const md.SetextHeaderWithIdSyntax(),
   const md.TableSyntax(),
 ];
 
 // Remove these schemas from the display text for hyperlinks.
-final RegExp _hide_schemes = RegExp('^(http|https)://');
+final RegExp _hideSchemes = RegExp('^(http|https)://');
 
 class MatchingLinkResult {
   final ModelElement element;
@@ -951,8 +951,8 @@ class MarkdownDocument extends md.Document {
     }
 
     return MarkdownDocument(
-        inlineSyntaxes: _markdown_syntaxes,
-        blockSyntaxes: _markdown_block_syntaxes,
+        inlineSyntaxes: _markdownSyntaxes,
+        blockSyntaxes: _markdownBlockSyntaxes,
         linkResolver: linkResolver);
   }
 
@@ -1020,7 +1020,7 @@ class _AutolinkWithoutScheme extends md.AutolinkSyntax {
   @override
   bool onMatch(md.InlineParser parser, Match match) {
     var url = match[1];
-    var text = htmlEscape.convert(url).replaceFirst(_hide_schemes, '');
+    var text = htmlEscape.convert(url).replaceFirst(_hideSchemes, '');
     var anchor = md.Element.text('a', text);
     anchor.attributes['href'] = url;
     parser.addNode(anchor);