Merge branch 'main' into merge-platform-package

.github/ISSUE_TEMPLATE/args.md

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

.github/ISSUE_TEMPLATE/logging.md

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

.github/ISSUE_TEMPLATE/os_detect.md

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

.github/ISSUE_TEMPLATE/path.md

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

.github/labeler.yml

@@ -24,6 +24,18 @@
   - changed-files:
       - any-glob-to-any-file: 'pkgs/fixnum/**'
 
+"package:logging":
+  - changed-files:
+      - any-glob-to-any-file: 'pkgs/logging/**'
+
+"package:os_detect":
+  - changed-files:
+      - any-glob-to-any-file: 'pkgs/os_detect/**'
+
+"package:path":
+  - changed-files:
+      - any-glob-to-any-file: 'pkgs/path/**'
+
 "package:platform":
   - changed-files:
       - any-glob-to-any-file: 'pkgs/platform/**'

.github/workflows/logging.yaml

@@ -0,0 +1,70 @@
+name: package:logging
+
+on:
+  # Run CI on pushes to the main branch, and on PRs against main.
+  push:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/logging.yaml'
+      - 'pkgs/logging/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/logging.yaml'
+      - 'pkgs/logging/**'
+  schedule:
+    - cron: "0 0 * * 0"
+env:
+  PUB_ENVIRONMENT: bot.github
+
+defaults:
+  run:
+    working-directory: pkgs/logging/
+
+jobs:
+  # Check code formatting and static analysis.
+  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 of platforms and sdk versions.
+  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
+        if: always() && steps.install.outcome == 'success'
+      - name: Run Chrome tests
+        run: dart test --platform chrome
+        if: always() && steps.install.outcome == 'success'

.github/workflows/os_detect.yaml

@@ -0,0 +1,73 @@
+name: package:os_detect
+
+on:
+  # Run CI on pushes to the main branch, and on PRs against main.
+  push:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/os_detect.yaml'
+      - 'pkgs/os_detect/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/os_detect.yaml'
+      - 'pkgs/os_detect/**'
+  schedule:
+    - cron: "0 0 * * 0"
+env:
+  PUB_ENVIRONMENT: bot.github
+
+defaults:
+  run:
+    working-directory: pkgs/os_detect/
+
+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, windows-latest, macos-latest]
+        sdk: [3.0.0, 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
+        if: always() && steps.install.outcome == 'success'
+      - name: Run Chrome tests
+        run: dart test --platform chrome
+        if: always() && steps.install.outcome == 'success'

.github/workflows/path.yaml

@@ -0,0 +1,64 @@
+name: package:path
+
+on:
+  # Run CI on pushes to the main branch, and on PRs against main.
+  push:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/path.yaml'
+      - 'pkgs/path/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/path.yaml'
+      - 'pkgs/path/**'
+  schedule:
+    - cron: "0 0 * * 0"
+env:
+  PUB_ENVIRONMENT: bot.github
+
+defaults:
+  run:
+    working-directory: pkgs/path/
+
+jobs:
+  # Check code formatting and static analysis on a single OS (linux)
+  # against Dart dev and stable.
+  analyze:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        sdk: [dev]
+    steps:
+      - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332
+      - 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'
+
+  test:
+    needs: analyze
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        sdk: [3.4, dev]
+    steps:
+      - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332
+      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+        with:
+          sdk: ${{ matrix.sdk }}
+      - run: dart pub get
+      - run: dart test --platform vm,chrome
+      - name: Run Chrome tests - wasm
+        run: dart test --platform chrome --compiler dart2wasm
+        if: always() && steps.install.outcome == 'success'

CONTRIBUTING.md

@@ -38,7 +38,7 @@ new file please also add this. The year should be a single number stating the
 year the file was created (don't use a range like "2011-2012"). Additionally, if
 you edit an existing file, you shouldn't update the year.
 
-    // Copyright (c) 2023, the Dart project authors.  Please see the AUTHORS file
+    // Copyright (c) 2024, the Dart project authors.  Please see the AUTHORS file
     // 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.
 
@@ -48,4 +48,4 @@ This project follows
 [Google's Open Source Community Guidelines](https://opensource.google/conduct/).
 
 We pledge to maintain an open and welcoming environment. For details, see our
-[code of conduct](https://dart.dev/code-of-conduct).
+[code of conduct](https://dart.dev/code-of-conduct).

README.md

@@ -14,6 +14,9 @@ This repository is home to various Dart packages under the [dart.dev](https://pu
 | [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) |
+| [logging](pkgs/logging/) | Provides APIs for debugging and error logging. | [![pub package](https://img.shields.io/pub/v/logging.svg)](https://pub.dev/packages/logging) |
+| [os_detect](pkgs/os_detect/) | Platform independent OS detection. | [![pub package](https://img.shields.io/pub/v/os_detect.svg)](https://pub.dev/packages/os_detect) |
+| [path](pkgs/path/) | A string-based path manipulation library for all of the path operations you know and love. | [![pub package](https://img.shields.io/pub/v/path.svg)](https://pub.dev/packages/path) |
 | [platform](pkgs/platform/) | A pluggable, mockable platform information abstraction for Dart. | [![pub package](https://img.shields.io/pub/v/platform.svg)](https://pub.dev/packages/platform) |
 
 ## Publishing automation

pkgs/args/example/arg_parser/pubspec.yaml

@@ -6,8 +6,10 @@ name: arg_parser_example
 version: 1.0.0
 description: An example of using ArgParser
 publish_to: 'none'
+
 environment:
-  sdk: '>=2.14.0 <3.0.0'
+  sdk: ^3.0.0
+
 dependencies:
   args:
     path: ../..

pkgs/args/example/command_runner/pubspec.yaml

@@ -6,8 +6,10 @@ name: command_runner_example
 version: 1.0.0
 description: An example of using CommandRunner
 publish_to: 'none'
+
 environment:
-  sdk: '>=2.14.0 <3.0.0'
+  sdk: ^3.0.0
+
 dependencies:
   args:
     path: ../..

pkgs/logging/.gitignore

@@ -0,0 +1,3 @@
+.dart_tool
+.packages
+pubspec.lock

pkgs/logging/AUTHORS

@@ -0,0 +1,10 @@
+# Names should be added to this file with this pattern:
+#
+# For individuals:
+#   Name <email address>
+#
+# For organizations:
+#   Organization <fnmatch pattern>
+#
+Google Inc. <*@google.com>
+Anton Astashov <anton.astashov@gmail.com>