Merge pull request #579 from dart-lang/merge-collection-package

Merge `package:collection`

Author: mosuem

.github/ISSUE_TEMPLATE/collection.md

@@ -0,0 +1,5 @@
+---
+name: "package:collection"
+about: "Create a bug or file a feature request against package:collection."
+labels: "package:collection"
+---

.github/labeler.yml

@@ -12,6 +12,10 @@
   - changed-files:
       - any-glob-to-any-file: 'pkgs/characters/**'
 
+"package:collection":
+  - changed-files:
+      - any-glob-to-any-file: 'pkgs/collection/**'
+
 "package:convert":
   - changed-files:
       - any-glob-to-any-file: 'pkgs/convert/**'

.github/workflows/collection.yaml

@@ -0,0 +1,77 @@
+name: package:collection
+
+on:
+  # Run CI on pushes to the main branch, and on PRs against main.
+  push:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/collection.yaml'
+      - 'pkgs/collection/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/collection.yaml'
+      - 'pkgs/collection/**'
+  schedule:
+    - cron: "0 0 * * 0"
+
+env:
+  PUB_ENVIRONMENT: bot.github
+
+defaults:
+  run:
+    working-directory: pkgs/collection/
+
+jobs:
+  # Check code formatting and static analysis on a single OS (linux)
+  # against Dart dev.
+  analyze:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        sdk: [dev]
+    steps:
+      - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938
+      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+        with:
+          sdk: ${{ matrix.sdk }}
+      - id: install
+        name: Install dependencies
+        run: dart pub get
+      - name: Check formatting
+        run: dart format --output=none --set-exit-if-changed .
+        if: always() && steps.install.outcome == 'success'
+      - name: Analyze code
+        run: dart analyze --fatal-infos
+        if: always() && steps.install.outcome == 'success'
+
+  # Run tests on a matrix consisting of two dimensions:
+  # 1. OS: ubuntu-latest, (macos-latest, windows-latest)
+  # 2. release channel: dev
+  test:
+    needs: analyze
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Add macos-latest and/or windows-latest if relevant for this package.
+        os: [ubuntu-latest]
+        sdk: [3.4, dev]
+    steps:
+      - uses: actions/checkout@d632683dd7b4114ad314bca15554477dd762a938
+      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+        with:
+          sdk: ${{ matrix.sdk }}
+      - id: install
+        name: Install dependencies
+        run: dart pub get
+      - name: Run VM tests
+        run: dart test --platform vm --test-randomize-ordering-seed=random
+        if: always() && steps.install.outcome == 'success'
+      - name: Run Chrome tests
+        run: dart test --platform chrome --test-randomize-ordering-seed=random
+        if: always() && steps.install.outcome == 'success'
+      - name: Run Chrome tests - wasm
+        run: dart test --platform chrome --compiler dart2wasm
+        if: always() && steps.install.outcome == 'success'

README.md

@@ -11,6 +11,7 @@ This repository is home to various Dart packages under the [dart.dev](https://pu
 | [args](pkgs/args/) | Library for defining parsers for parsing raw command-line arguments into a set of options and values. | [![pub package](https://img.shields.io/pub/v/args.svg)](https://pub.dev/packages/args) |
 | [async](pkgs/async/) | Utility functions and classes related to the 'dart:async' library.| [![pub package](https://img.shields.io/pub/v/async.svg)](https://pub.dev/packages/async) |
 | [characters](pkgs/characters/) | String replacement with operations that are Unicode/grapheme cluster aware. | [![pub package](https://img.shields.io/pub/v/characters.svg)](https://pub.dev/packages/characters) |
+| [collection](pkgs/collection/) | Collections and utilities functions and classes related to collections. | [![pub package](https://img.shields.io/pub/v/collection.svg)](https://pub.dev/packages/collection) |
 | [convert](pkgs/convert/) | Utilities for converting between data representations. | [![pub package](https://img.shields.io/pub/v/convert.svg)](https://pub.dev/packages/convert) |
 | [crypto](pkgs/crypto/) | Implementations of SHA, MD5, and HMAC cryptographic functions. | [![pub package](https://img.shields.io/pub/v/crypto.svg)](https://pub.dev/packages/crypto) |
 | [fixnum](pkgs/fixnum/) | Library for 32- and 64-bit signed fixed-width integers. | [![pub package](https://img.shields.io/pub/v/fixnum.svg)](https://pub.dev/packages/fixnum) |

pkgs/collection/.gitignore

@@ -0,0 +1,10 @@
+.buildlog
+.DS_Store
+.idea
+.pub/
+.dart_tool/
+.settings/
+build/
+packages
+.packages
+pubspec.lock

pkgs/collection/AUTHORS

@@ -0,0 +1,8 @@
+# Below is a list of people and organizations that have contributed
+# to the project. Names should be added to the list like so:
+#
+#   Name/Organization <email address>
+
+Google Inc.
+AAABramenko (https://github.com/AAAbramenko)
+TimWhiting [email protected]