Start the NNBD migration branch with additional github configuration and a basic "non-migration" of all libraries (#2739)

* Update analyzer version to 2.0.0

* grind build for analyzer 2

* First steps toward migrating

* Basic migration infrastruture for new NNBD branch

* use separate workflow file for nnbd branch, for clarity

* thinko

Author: jcollins-g

.github/workflows/nnbd-test.yaml

@@ -0,0 +1,70 @@
+name: Test
+
+on:
+  # Run CI on pushes to the main branch, and on PRs against main.
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+  schedule:
+    - cron: 0 15 * * *
+
+env:
+  PUB_ENVIRONMENT: bot.github
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        sdk: [dev, stable]
+        job: [main, flutter, sdk-analyzer, packages, sdk-docs]
+        include:
+          - os: macos-latest
+            sdk: dev
+            job: main
+          - os: windows-latest
+            sdk: dev
+            job: main
+        exclude:
+            # Do not try to run flutter against the "stable" sdk,
+            # it is unlikely to work and produces uninteresting
+            # results.
+          - sdk: stable
+            job: flutter
+          - sdk: stable
+            job: sdk-analyzer
+
+    steps:
+      - name: Configure git
+        if: runner.os == 'Windows'
+        run: git config --global core.autocrlf input
+      - uses: actions/checkout@v2
+      - uses: dart-lang/[email protected]
+        with:
+          sdk: ${{ matrix.sdk }}
+      - name: Install dependencies
+        run: dart pub get
+      - name: ${{ matrix.job }}
+        if: runner.os != 'Windows'
+        run: ./tool/travis.sh
+        env:
+          DARTDOC_BOT: ${{ matrix.job }}
+          #COVERAGE_TOKEN: true # this needs to be set to enable coverage
+      - name: ${{ matrix.job }}
+        if: runner.os == 'Windows' && matrix.job == 'main'
+        run: dart run grinder buildbot
+        env:
+          DARTDOC_BOT: ${{ matrix.job }}
+     # - id: coverage
+     #   name: Upload coverage
+     #   if: runner.os == 'Linux' && matrix.job == 'main' && matrix.sdk == 'dev'
+     #   uses: coverallsapp/[email protected]
+     #   with:
+     #     github-token: ${{ secrets.GITHUB_TOKEN }}
+     #     path-to-lcov: lcov.info
+     # - name: Echo coveralls api result
+     #   if: runner.os == 'Linux' && matrix.job == 'main' && matrix.sdk == 'dev'
+     #   run: echo ${{ steps.coverage.outputs['coveralls-api-result'] }}

.github/workflows/test.yaml

@@ -1,11 +1,11 @@
-name: Test
+name: Test - NNBD branch
 
 on:
   # Run CI on pushes to the main branch, and on PRs against main.
   push:
-    branches: [ master ]
+    branches: [ nnbd ]
   pull_request:
-    branches: [ master ]
+    branches: [ nnbd ]
   schedule:
     - cron: 0 15 * * *
 
@@ -19,23 +19,15 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        sdk: [dev, stable]
-        job: [main, flutter, sdk-analyzer, packages, sdk-docs]
+        sdk: [dev]
+        job: [nnbd, flutter, sdk-analyzer, packages, sdk-docs]
         include:
           - os: macos-latest
             sdk: dev
-            job: main
+            job: nnbd
           - os: windows-latest
             sdk: dev
-            job: main
-        exclude:
-            # Do not try to run flutter against the "stable" sdk,
-            # it is unlikely to work and produces uninteresting
-            # results.
-          - sdk: stable
-            job: flutter
-          - sdk: stable
-            job: sdk-analyzer
+            job: nnbd
 
     steps:
       - name: Configure git
@@ -54,8 +46,8 @@ jobs:
           DARTDOC_BOT: ${{ matrix.job }}
           #COVERAGE_TOKEN: true # this needs to be set to enable coverage
       - name: ${{ matrix.job }}
-        if: runner.os == 'Windows' && matrix.job == 'main'
-        run: dart run grinder buildbot
+        if: runner.os == 'Windows' && matrix.job == 'nnbd'
+        run: dart run grinder buildbot-no-publish
         env:
           DARTDOC_BOT: ${{ matrix.job }}
      # - id: coverage

bin/dartdoc.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 library dartdoc.bin;
 
 import 'dart:async';

lib/dartdoc.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 /// A documentation generator for Dart.
 ///
 /// Library interface is currently under heavy construction and may change

lib/options.dart

@@ -1,3 +1,5 @@
+// @dart=2.9
+
 import 'dart:io' show stderr, exitCode;
 
 import 'package:analyzer/file_system/file_system.dart';

lib/src/comment_references/model_comment_reference.dart

@@ -2,6 +2,9 @@
 // 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.
 //
+
+// @dart=2.9
+
 import 'package:analyzer/dart/ast/ast.dart';
 import 'package:analyzer/dart/element/element.dart';
 import 'package:analyzer/file_system/file_system.dart';

lib/src/comment_references/parser.dart

@@ -2,6 +2,9 @@
 // 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.
 //
+
+// @dart=2.9
+
 import 'package:charcode/charcode.dart';
 import 'package:meta/meta.dart';
 

lib/src/dartdoc_options.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 ///
 /// dartdoc's dartdoc_options.yaml configuration file follows similar loading
 /// semantics to that of analysis_options.yaml,

lib/src/element_type.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 /// The models used to represent Dart code.
 library dartdoc.element_type;
 

lib/src/experiment_options.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 ///
 /// Implementation of Dart language experiment option handling for dartdoc.
 /// See https://github.com/dart-lang/sdk/blob/master/docs/process/experimental-flags.md.

lib/src/generator/dartdoc_generator_backend.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:analyzer/file_system/file_system.dart';
 import 'package:dartdoc/dartdoc.dart';
 import 'package:dartdoc/options.dart';

lib/src/generator/empty_generator.dart

@@ -1,3 +1,5 @@
+// @dart=2.9
+
 library dartdoc.empty_generator;
 
 import 'package:dartdoc/src/dartdoc_options.dart';

lib/src/generator/generator.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 /// A library containing an abstract documentation generator.
 library dartdoc.generator;
 

lib/src/generator/generator_frontend.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:dartdoc/src/generator/generator.dart';
 import 'package:dartdoc/src/logging.dart';
 import 'package:dartdoc/src/model/model.dart';

lib/src/generator/generator_utils.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'dart:convert';
 
 import 'package:collection/collection.dart';

lib/src/generator/html_generator.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 library dartdoc.html_generator;
 
 import 'package:analyzer/file_system/file_system.dart';

lib/src/generator/markdown_generator.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:analyzer/file_system/file_system.dart';
 import 'package:dartdoc/options.dart';
 import 'package:dartdoc/src/generator/dartdoc_generator_backend.dart';

lib/src/generator/resource_loader.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 /// Make it possible to load resources from the dartdoc code repository.
 library dartdoc.resource_loader;
 

lib/src/generator/template_data.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:dartdoc/src/model/model.dart';
 
 typedef ContainerSidebar = String Function(

lib/src/generator/templates.aot_renderers_for_html.dart

@@ -7,6 +7,7 @@
 // the variable is not used; generally when the section is checking if a
 // non-bool, non-Iterable field is non-null.
 // ignore_for_file: unused_local_variable
+// @dart=2.9
 
 import 'dart:convert' as _i18;
 

lib/src/generator/templates.aot_renderers_for_md.dart

@@ -7,6 +7,7 @@
 // the variable is not used; generally when the section is checking if a
 // non-bool, non-Iterable field is non-null.
 // ignore_for_file: unused_local_variable
+// @dart=2.9
 
 import 'dart:convert' as _i18;
 

lib/src/generator/templates.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 @Renderer(#renderCategory, Context<CategoryTemplateData>(), 'category',
     visibleTypes: _visibleTypes)
 @Renderer(#renderClass, Context<ClassTemplateData>(), 'class')

lib/src/generator/templates.runtime_renderers.dart

@@ -5,6 +5,7 @@
 
 // ignore_for_file: camel_case_types, deprecated_member_use_from_same_package
 // ignore_for_file: unused_import
+// @dart=2.9
 import 'package:dartdoc/dartdoc.dart';
 import 'package:dartdoc/src/generator/template_data.dart';
 import 'package:dartdoc/src/model/annotation.dart';

lib/src/io_utils.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 /// This is a helper library to make working with io easier.
 library dartdoc.io_utils;
 

lib/src/logging.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'dart:convert';
 import 'dart:io' show stderr, stdout;
 

lib/src/markdown_processor.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 /// Utility code to convert markdown comments to html.
 library dartdoc.markdown_processor;
 

lib/src/matching_link_result.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:dartdoc/src/element_type.dart';
 import 'package:dartdoc/src/model/comment_referable.dart';
 import 'package:dartdoc/src/model/model.dart';

lib/src/model/accessor.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:analyzer/dart/element/element.dart';
 import 'package:analyzer/source/line_info.dart';
 import 'package:analyzer/src/dart/element/member.dart' show ExecutableMember;

lib/src/model/annotation.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:analyzer/dart/element/element.dart';
 import 'package:dartdoc/src/element_type.dart';
 import 'package:dartdoc/src/model/feature.dart';

lib/src/model/canonicalization.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:dartdoc/src/comment_references/model_comment_reference.dart';
 import 'package:dartdoc/src/model/model.dart';
 

lib/src/model/categorization.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:dartdoc/src/model/model.dart';
 
 final RegExp _categoryRegExp = RegExp(

lib/src/model/category.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:analyzer/dart/element/element.dart';
 import 'package:analyzer/file_system/file_system.dart';
 import 'package:dartdoc/src/comment_references/model_comment_reference.dart';

lib/src/model/class.dart

@@ -2,6 +2,8 @@
 // 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.
 
+// @dart=2.9
+
 import 'package:analyzer/dart/element/element.dart';
 import 'package:analyzer/dart/element/type.dart';
 import 'package:dartdoc/src/element_type.dart';