Merge branch 'main' into feat/new-code-excerpter

Author: parlough

.github/workflows/dart.yml

@@ -86,16 +86,16 @@ jobs:
         if: "always() && steps.packages_code_excerpter_pub_upgrade.conclusion == 'success'"
         working-directory: packages/code_excerpter
   job_003:
-    name: "analyzer_and_format; Dart 3.2.0; PKG: packages/excerpter; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
+    name: "analyzer_and_format; Dart 3.2.0; PKGS: packages/excerpter, packages/inject_dartpad; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
     runs-on: ubuntu-latest
     steps:
       - name: Cache Pub hosted dependencies
         uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84
         with:
           path: "~/.pub-cache/hosted"
-          key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.2.0;packages:packages/excerpter;commands:format-analyze"
+          key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.2.0;packages:packages/excerpter-packages/inject_dartpad;commands:format-analyze"
           restore-keys: |
-            os:ubuntu-latest;pub-cache-hosted;sdk:3.2.0;packages:packages/excerpter
+            os:ubuntu-latest;pub-cache-hosted;sdk:3.2.0;packages:packages/excerpter-packages/inject_dartpad
             os:ubuntu-latest;pub-cache-hosted;sdk:3.2.0
             os:ubuntu-latest;pub-cache-hosted
             os:ubuntu-latest
@@ -119,17 +119,30 @@ jobs:
         run: dart analyze --fatal-infos .
         if: "always() && steps.packages_excerpter_pub_upgrade.conclusion == 'success'"
         working-directory: packages/excerpter
+      - id: packages_inject_dartpad_pub_upgrade
+        name: packages/inject_dartpad; dart pub upgrade
+        run: dart pub upgrade
+        if: "always() && steps.checkout.conclusion == 'success'"
+        working-directory: packages/inject_dartpad
+      - name: "packages/inject_dartpad; dart format --output=none --set-exit-if-changed ."
+        run: "dart format --output=none --set-exit-if-changed ."
+        if: "always() && steps.packages_inject_dartpad_pub_upgrade.conclusion == 'success'"
+        working-directory: packages/inject_dartpad
+      - name: "packages/inject_dartpad; dart analyze --fatal-infos ."
+        run: dart analyze --fatal-infos .
+        if: "always() && steps.packages_inject_dartpad_pub_upgrade.conclusion == 'success'"
+        working-directory: packages/inject_dartpad
   job_004:
-    name: "analyzer_and_format; Dart dev; PKGS: packages/code_excerpt_updater, packages/code_excerpter, packages/excerpter; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
+    name: "analyzer_and_format; Dart dev; PKGS: packages/code_excerpt_updater, packages/code_excerpter, packages/excerpter, packages/inject_dartpad; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos .`"
     runs-on: ubuntu-latest
     steps:
       - name: Cache Pub hosted dependencies
         uses: actions/cache@704facf57e6136b1bc63b828d79edcd491f0ee84
         with:
           path: "~/.pub-cache/hosted"
-          key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:packages/code_excerpt_updater-packages/code_excerpter-packages/excerpter;commands:format-analyze"
+          key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:packages/code_excerpt_updater-packages/code_excerpter-packages/excerpter-packages/inject_dartpad;commands:format-analyze"
           restore-keys: |
-            os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:packages/code_excerpt_updater-packages/code_excerpter-packages/excerpter
+            os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:packages/code_excerpt_updater-packages/code_excerpter-packages/excerpter-packages/inject_dartpad
             os:ubuntu-latest;pub-cache-hosted;sdk:dev
             os:ubuntu-latest;pub-cache-hosted
             os:ubuntu-latest
@@ -179,6 +192,19 @@ jobs:
         run: dart analyze --fatal-infos .
         if: "always() && steps.packages_excerpter_pub_upgrade.conclusion == 'success'"
         working-directory: packages/excerpter
+      - id: packages_inject_dartpad_pub_upgrade
+        name: packages/inject_dartpad; dart pub upgrade
+        run: dart pub upgrade
+        if: "always() && steps.checkout.conclusion == 'success'"
+        working-directory: packages/inject_dartpad
+      - name: "packages/inject_dartpad; dart format --output=none --set-exit-if-changed ."
+        run: "dart format --output=none --set-exit-if-changed ."
+        if: "always() && steps.packages_inject_dartpad_pub_upgrade.conclusion == 'success'"
+        working-directory: packages/inject_dartpad
+      - name: "packages/inject_dartpad; dart analyze --fatal-infos ."
+        run: dart analyze --fatal-infos .
+        if: "always() && steps.packages_inject_dartpad_pub_upgrade.conclusion == 'success'"
+        working-directory: packages/inject_dartpad
   job_005:
     name: "unit_test; Dart 3.1.0; PKGS: packages/code_excerpt_updater, packages/code_excerpter; `dart test`"
     runs-on: ubuntu-latest

cloud_build/staging_container/Dockerfile cloud_build/firebase-ghcli/Dockerfile

@@ -0,0 +1,18 @@
+## Summary
+This directory contains a Dockerfile that provides access to firebase tools and
+the Github CLI. This image is used to deploy various Dart/Flutter websites to
+firebase in both production and staging, and is also used to comment on Github
+PRs.
+
+
+## Installed tools
+* Github CLI
+* Node/NPM
+* Firebase Tools
+
+
+## Additional information
+When the dockerfile or cloud build template in this directory is changed in a
+PR, the cloud build template is triggered and a new version of the image is
+deployed as the latest version in Container Registry under the `flutter-dev`
+project in GCP.

cloud_build/firebase-ghcli/README.md

@@ -0,0 +1,6 @@
+steps:
+- name: 'gcr.io/cloud-builders/docker'
+  args: ['build', '-t', 'gcr.io/$PROJECT_ID/firebase-ghcli', 'cloud_build/firebase-ghcli']
+images:
+- 'gcr.io/$PROJECT_ID/firebase-ghcli'
+tags: ['dash-firebase-ghcli']

cloud_build/firebase-ghcli/cloudbuild.yaml

@@ -0,0 +1,11 @@
+# Dart-related files
+.dart_tool
+pubspec.lock
+
+# IDE-related files
+*.iml
+.idea/
+.vscode/
+
+# Platform-related files
+.DS_Store

cloud_build/staging_container/README.md

@@ -0,0 +1,51 @@
+## DartPad injection
+
+To embed a DartPad with arbitrary Dart in to your web page, add the
+JS file found at `lib/inject_dartpad.js` with a `<script>` tag,
+set up to run after the DOM is ready.
+
+This might look something like the following, depending on where
+your version of the JS file is stored.
+
+```html
+<script defer src="inject_dartpad.js"></script>
+```
+
+### Declare code to inject
+
+The script looks for each inline `<code>` element on the page
+that is the only child of a `<pre>` element and
+has the `data-dartpad="true"` property.
+
+```html
+<pre>
+  <code class="language-dart" data-dartpad="true">
+    ...Code here...
+  </code>
+</pre>
+```
+
+If the code is correctly formatted, the script will replace
+both elements with a DartPad iframe containing your specified code.
+
+The DartPad defaults to the embed style and dark theme. To configure
+this and other behavior, add one or more of the following options:
+
+- `data-embed="false"`
+  To use the standalone UI version of DartPad.
+- `data-theme="light"`
+  To use the light theme in the embed.
+- `data-run="true"`
+  To run the included code once loaded.
+- `data-width="<CSS width>"`
+  To specify the initial width of the injected iframe element.
+- `data-height="<CSS height>"`
+  To specify the initial height of the injected iframe element.
+
+### Developing script
+
+To work on the script itself, modify the code within `/web/inject_dartpad.dart`.
+To compile the code to JavaScript, use the latest Dart SDK,
+verify you have the latest dependencies (`dart pub upgrade`), and then
+run `dart run tool/compile.dart`.
+The updated file will be written to `/lib/inject_dartpad.js`.

cloud_build/staging_container/cloudbuild.yaml

@@ -0,0 +1 @@
+include: package:analysis_defaults/analysis.yaml

packages/inject_dartpad/.gitignore

@@ -0,0 +1,12 @@
+targets:
+  $default:
+    builders:
+      build_web_compilers|entrypoint:
+        generate_for:
+          - web/**.dart
+        options:
+          dart2js_args:
+            - --no-frequency-based-minification
+            - --no-source-maps
+            - --show-package-warnings
+            - -O4