Merge pull request #403 from dart-lang/merge-path-package

Merge `package:path`

.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

@@ -31,3 +31,7 @@
 "package:os_detect":
   - changed-files:
       - any-glob-to-any-file: 'pkgs/os_detect/**'
+
+"package:path":
+  - changed-files:
+      - any-glob-to-any-file: 'pkgs/path/**'

.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'

README.md

@@ -16,6 +16,7 @@ This repository is home to various Dart packages under the [dart.dev](https://pu
 | [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) |
 
 ## Publishing automation
 

pkgs/path/.gitignore

@@ -0,0 +1,16 @@
+# Don’t commit the following directories created by pub.
+.buildlog
+.pub/
+.dart_tool/
+.idea/
+build/
+.packages
+
+# Or the files created by dart2js.
+*.dart.js
+*.js_
+*.js.deps
+*.js.map
+
+# Include when developing application packages.
+pubspec.lock

pkgs/path/CHANGELOG.md

@@ -0,0 +1,186 @@
+## 1.9.1
+
+- Require Dart 3.4
+- Move to `dart-lang/core` monorepo.
+
+## 1.9.0
+
+* Allow percent-encoded colons (`%3a`) in drive letters in `fromUri`.
+* Fixed an issue with the `split` method doc comment.
+* Require Dart 3.0
+
+## 1.8.3
+
+* Support up to 16 arguments in join function and up to 15 arguments in absolute function. 
+
+## 1.8.2
+
+* Enable the `avoid_dynamic_calls` lint.
+* Populate the pubspec `repository` field.
+
+## 1.8.1
+
+* Don't crash when an empty string is passed to `toUri()`.
+
+## 1.8.0
+
+* Stable release for null safety.
+
+## 1.8.0-nullsafety.3
+
+* Update SDK constraints to `>=2.12.0-0 <3.0.0` based on beta release
+  guidelines.
+
+## 1.8.0-nullsafety.2
+
+* Allow prerelease versions of the 2.12 sdk.
+
+## 1.8.0-nullsafety.1
+
+* Allow 2.10 stable and 2.11.0 dev SDK versions.
+
+## 1.8.0-nullsafety
+
+* Migrate to null safety.
+
+## 1.7.0
+
+* Add support for multiple extension in `context.extension()`.
+
+## 1.6.4
+
+* Fixed a number of lints that affect the package health score.
+
+* Added an example.
+
+## 1.6.3
+
+* Don't throw a FileSystemException from `current` if the working directory has
+  been deleted, but we have a cached one we can use.
+
+## 1.6.2
+
+* Set max SDK version to `<3.0.0`, and adjust other dependencies.
+
+## 1.6.1
+
+* Drop the `retype` implementation for compatibility with the latest SDK.
+
+## 1.6.0
+
+* Add a `PathMap` class that uses path equality for its keys.
+
+* Add a `PathSet` class that uses path equality for its contents.
+
+## 1.5.1
+
+* Fix a number of bugs that occurred when the current working directory was `/`
+  on Linux or Mac OS.
+
+## 1.5.0
+
+* Add a `setExtension()` top-level function and `Context` method.
+
+## 1.4.2
+
+* Treat `package:` URLs as absolute.
+
+* Normalize `c:\foo\.` to `c:\foo`.
+
+## 1.4.1
+
+* Root-relative URLs like `/foo` are now resolved relative to the drive letter
+  for `file` URLs that begin with a Windows-style drive letter. This matches the
+  [WHATWG URL specification][].
+
+[WHATWG URL specification]: https://url.spec.whatwg.org/#file-slash-state
+
+* When a root-relative URLs like `/foo` is converted to a Windows path using
+  `fromUrl()`, it is now resolved relative to the drive letter. This matches
+  IE's behavior.
+
+## 1.4.0
+
+* Add `equals()`, `hash()` and `canonicalize()` top-level functions and
+  `Context` methods. These make it easier to treat paths as map keys.
+
+* Properly compare Windows paths case-insensitively.
+
+* Further improve the performance of `isWithin()`.
+
+## 1.3.9
+
+* Further improve the performance of `isWithin()` when paths contain `/.`
+  sequences that aren't `/../`.
+
+## 1.3.8
+
+* Improve the performance of `isWithin()` when the paths don't contain
+  asymmetrical `.` or `..` components.
+
+* Improve the performance of `relative()` when `from` is `null` and the path is
+  already relative.
+
+* Improve the performance of `current` when the current directory hasn't
+  changed.
+
+## 1.3.7
+
+* Improve the performance of `absolute()` and `normalize()`.
+
+## 1.3.6
+
+* Ensure that `path.toUri` preserves trailing slashes for relative paths.
+
+## 1.3.5
+
+* Added type annotations to top-level and static fields.
+
+## 1.3.4
+
+* Fix dev_compiler warnings.
+
+## 1.3.3
+
+* Performance improvement in `Context.relative` - don't call `current` if `from`
+  is not relative.
+
+## 1.3.2
+
+* Fix some analyzer hints.
+
+## 1.3.1
+
+* Add a number of performance improvements.
+
+## 1.3.0
+
+* Expose a top-level `context` field that provides access to a `Context` object
+  for the current system.
+
+## 1.2.3
+
+* Don't cache path Context based on cwd, as cwd involves a system-call to
+  compute.
+
+## 1.2.2
+
+* Remove the documentation link from the pubspec so this is linked to
+  pub.dev by default.
+
+# 1.2.1
+
+* Many members on `Style` that provided access to patterns and functions used
+  internally for parsing paths have been deprecated.
+
+* Manually parse paths (rather than using RegExps to do so) for better
+  performance.
+
+# 1.2.0
+
+* Added `path.prettyUri`, which produces a human-readable representation of a
+  URI.
+
+# 1.1.0
+
+* `path.fromUri` now accepts strings as well as `Uri` objects.

pkgs/path/LICENSE

@@ -0,0 +1,27 @@
+Copyright 2014, the Dart project authors. 
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of Google LLC nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.