keep-a-changelog 2.1.0 → 2.2.1

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/flags/mod.js

@@ -1,8 +1,40 @@
 "use strict";
-// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parse = void 0;
-const assert_js_1 = require("../_util/assert.js");
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+/**
+ * Command line arguments parser based on
+ * [minimist](https://github.com/minimistjs/minimist).
+ *
+ * This module is browser compatible.
+ *
+ * @example
+ * ```ts
+ * import { parse } from "https://deno.land/std@$STD_VERSION/flags/mod.ts";
+ *
+ * console.dir(parse(Deno.args));
+ * ```
+ *
+ * ```sh
+ * $ deno run https://deno.land/std/examples/flags.ts -a beep -b boop
+ * { _: [], a: 'beep', b: 'boop' }
+ * ```
+ *
+ * ```sh
+ * $ deno run https://deno.land/std/examples/flags.ts -x 3 -y 4 -n5 -abc --beep=boop foo bar baz
+ * { _: [ 'foo', 'bar', 'baz' ],
+ *   x: 3,
+ *   y: 4,
+ *   n: 5,
+ *   a: true,
+ *   b: true,
+ *   c: true,
+ *   beep: 'boop' }
+ * ```
+ *
+ * @module
+ */
+const asserts_js_1 = require("../_util/asserts.js");
 const { hasOwn } = Object;
 function get(obj, key) {
     if (hasOwn(obj, key)) {
@@ -11,7 +43,7 @@ function get(obj, key) {
 }
 function getForce(obj, key) {
     const v = get(obj, key);
-    (0, assert_js_1.assert)(v != null);
+    (0, asserts_js_1.assert)(v != null);
     return v;
 }
 function isNumber(x) {
@@ -27,35 +59,52 @@ function hasKey(obj, keys) {
         o = (get(o, key) ?? {});
     });
     const key = keys[keys.length - 1];
-    return key in o;
+    return hasOwn(o, key);
 }
-/** Take a set of command line arguments, with an optional set of options, and
- * return an object representation of those argument.
+/** Take a set of command line arguments, optionally with a set of options, and
+ * return an object representing the flags found in the passed arguments.
+ *
+ * By default, any arguments starting with `-` or `--` are considered boolean
+ * flags. If the argument name is followed by an equal sign (`=`) it is
+ * considered a key-value pair. Any arguments which could not be parsed are
+ * available in the `_` property of the returned object.
+ *
+ * By default, the flags module tries to determine the type of all arguments
+ * automatically and the return type of the `parse` method will have an index
+ * signature with `any` as value (`{ [x: string]: any }`).
  *
+ * If the `string`, `boolean` or `collect` option is set, the return value of
+ * the `parse` method will be fully typed and the index signature of the return
+ * type will change to `{ [x: string]: unknown }`.
+ *
+ * Any arguments after `'--'` will not be parsed and will end up in `parsedArgs._`.
+ *
+ * Numeric-looking arguments will be returned as numbers unless `options.string`
+ * or `options.boolean` is set for that argument name.
+ *
+ * @example
  * ```ts
- *      import { parse } from "./mod.ts";
- *      const parsedArgs = parse(Deno.args);
+ * import { parse } from "https://deno.land/std@$STD_VERSION/flags/mod.ts";
+ * const parsedArgs = parse(Deno.args);
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { parse } from "https://deno.land/std@$STD_VERSION/flags/mod.ts";
+ * const parsedArgs = parse(["--foo", "--bar=baz", "./quux.txt"]);
+ * // parsedArgs: { foo: true, bar: "baz", _: ["./quux.txt"] }
  * ```
  */
-function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, default: defaults = {}, stopEarly = false, string = [], unknown = (i) => i, } = {}) {
+function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, default: defaults = {}, stopEarly = false, string = [], collect = [], negatable = [], unknown = (i) => i, } = {}) {
+    const aliases = {};
     const flags = {
         bools: {},
         strings: {},
         unknownFn: unknown,
         allBools: false,
+        collect: {},
+        negatable: {},
     };
-    if (boolean !== undefined) {
-        if (typeof boolean === "boolean") {
-            flags.allBools = !!boolean;
-        }
-        else {
-            const booleanArgs = typeof boolean === "string" ? [boolean] : boolean;
-            for (const key of booleanArgs.filter(Boolean)) {
-                flags.bools[key] = true;
-            }
-        }
-    }
-    const aliases = {};
     if (alias !== undefined) {
         for (const key in alias) {
             const val = getForce(alias, key);
@@ -70,8 +119,29 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
             }
         }
     }
+    if (boolean !== undefined) {
+        if (typeof boolean === "boolean") {
+            flags.allBools = !!boolean;
+        }
+        else {
+            const booleanArgs = typeof boolean === "string"
+                ? [boolean]
+                : boolean;
+            for (const key of booleanArgs.filter(Boolean)) {
+                flags.bools[key] = true;
+                const alias = get(aliases, key);
+                if (alias) {
+                    for (const al of alias) {
+                        flags.bools[al] = true;
+                    }
+                }
+            }
+        }
+    }
     if (string !== undefined) {
-        const stringArgs = typeof string === "string" ? [string] : string;
+        const stringArgs = typeof string === "string"
+            ? [string]
+            : string;
         for (const key of stringArgs.filter(Boolean)) {
             flags.strings[key] = true;
             const alias = get(aliases, key);
@@ -82,6 +152,34 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
             }
         }
     }
+    if (collect !== undefined) {
+        const collectArgs = typeof collect === "string"
+            ? [collect]
+            : collect;
+        for (const key of collectArgs.filter(Boolean)) {
+            flags.collect[key] = true;
+            const alias = get(aliases, key);
+            if (alias) {
+                for (const al of alias) {
+                    flags.collect[al] = true;
+                }
+            }
+        }
+    }
+    if (negatable !== undefined) {
+        const negatableArgs = typeof negatable === "string"
+            ? [negatable]
+            : negatable;
+        for (const key of negatableArgs.filter(Boolean)) {
+            flags.negatable[key] = true;
+            const alias = get(aliases, key);
+            if (alias) {
+                for (const al of alias) {
+                    flags.negatable[al] = true;
+                }
+            }
+        }
+    }
     const argv = { _: [] };
     function argDefined(key, arg) {
         return ((flags.allBools && /^--[^=]+$/.test(arg)) ||
@@ -89,8 +187,9 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
             !!get(flags.strings, key) ||
             !!get(aliases, key));
     }
-    function setKey(obj, keys, value) {
+    function setKey(obj, name, value, collect = true) {
         let o = obj;
+        const keys = name.split(".");
         keys.slice(0, -1).forEach(function (key) {
             if (get(o, key) === undefined) {
                 o[key] = {};
@@ -98,11 +197,13 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
             o = get(o, key);
         });
         const key = keys[keys.length - 1];
-        if (get(o, key) === undefined ||
-            get(flags.bools, key) ||
-            typeof get(o, key) === "boolean") {
+        const collectable = collect && !!get(flags.collect, name);
+        if (!collectable) {
             o[key] = value;
         }
+        else if (get(o, key) === undefined) {
+            o[key] = [value];
+        }
         else if (Array.isArray(get(o, key))) {
             o[key].push(value);
         }
@@ -110,26 +211,23 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
             o[key] = [get(o, key), value];
         }
     }
-    function setArg(key, val, arg = undefined) {
+    function setArg(key, val, arg = undefined, collect) {
         if (arg && flags.unknownFn && !argDefined(key, arg)) {
             if (flags.unknownFn(arg, key, val) === false)
                 return;
         }
         const value = !get(flags.strings, key) && isNumber(val) ? Number(val) : val;
-        setKey(argv, key.split("."), value);
+        setKey(argv, key, value, collect);
         const alias = get(aliases, key);
         if (alias) {
             for (const x of alias) {
-                setKey(argv, x.split("."), value);
+                setKey(argv, x, value, collect);
             }
         }
     }
     function aliasIsBoolean(key) {
         return getForce(aliases, key).some((x) => typeof get(flags.bools, x) === "boolean");
     }
-    for (const key of Object.keys(flags.bools)) {
-        setArg(key, defaults[key] === undefined ? false : defaults[key]);
-    }
     let notFlags = [];
     // all args after "--" are not parsed
     if (args.includes("--")) {
@@ -140,7 +238,7 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
         const arg = args[i];
         if (/^--.+=/.test(arg)) {
             const m = arg.match(/^--([^=]+)=(.*)$/s);
-            (0, assert_js_1.assert)(m != null);
+            (0, asserts_js_1.assert)(m != null);
             const [, key, value] = m;
             if (flags.bools[key]) {
                 const booleanValue = value !== "false";
@@ -150,14 +248,14 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
                 setArg(key, value, arg);
             }
         }
-        else if (/^--no-.+/.test(arg)) {
+        else if (/^--no-.+/.test(arg) && get(flags.negatable, arg.replace(/^--no-/, ""))) {
             const m = arg.match(/^--no-(.+)/);
-            (0, assert_js_1.assert)(m != null);
-            setArg(m[1], false, arg);
+            (0, asserts_js_1.assert)(m != null);
+            setArg(m[1], false, arg, false);
         }
         else if (/^--.+/.test(arg)) {
             const m = arg.match(/^--(.+)/);
-            (0, assert_js_1.assert)(m != null);
+            (0, asserts_js_1.assert)(m != null);
             const [, key] = m;
             const next = args[i + 1];
             if (next !== undefined &&
@@ -233,16 +331,27 @@ function parse(args, { "--": doubleDash = false, alias = {}, boolean = false, de
             }
         }
     }
-    for (const key of Object.keys(defaults)) {
+    for (const [key, value] of Object.entries(defaults)) {
         if (!hasKey(argv, key.split("."))) {
-            setKey(argv, key.split("."), defaults[key]);
+            setKey(argv, key, value);
             if (aliases[key]) {
                 for (const x of aliases[key]) {
-                    setKey(argv, x.split("."), defaults[key]);
+                    setKey(argv, x, value);
                 }
             }
         }
     }
+    for (const key of Object.keys(flags.bools)) {
+        if (!hasKey(argv, key.split("."))) {
+            const value = get(flags.collect, key) ? [] : false;
+            setKey(argv, key, value, false);
+        }
+    }
+    for (const key of Object.keys(flags.strings)) {
+        if (!hasKey(argv, key.split(".")) && get(flags.collect, key)) {
+            setKey(argv, key, [], false);
+        }
+    }
     if (doubleDash) {
         argv["--"] = [];
         for (const key of notFlags) {

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/_constants.js

@@ -1,4 +1,5 @@
 "use strict";
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/_interface.js

@@ -1,4 +1,4 @@
 "use strict";
-// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 Object.defineProperty(exports, "__esModule", { value: true });

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/_util.js

@@ -1,4 +1,5 @@
 "use strict";
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/common.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.common = void 0;

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/glob.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/mod.js

@@ -1,7 +1,7 @@
 "use strict";
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported mostly from https://github.com/browserify/path-browserify/
-// This module is browser compatible.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -30,6 +30,24 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SEP_PATTERN = exports.SEP = exports.toNamespacedPath = exports.toFileUrl = exports.sep = exports.resolve = exports.relative = exports.parse = exports.normalize = exports.join = exports.isAbsolute = exports.fromFileUrl = exports.format = exports.extname = exports.dirname = exports.delimiter = exports.basename = exports.posix = exports.win32 = void 0;
+/**
+ * Utilities for working with OS-specific file paths.
+ *
+ * Codes in the examples uses POSIX path but it automatically use Windows path
+ * on Windows. Use methods under `posix` or `win32` object instead to handle non
+ * platform specific path like:
+ * ```ts
+ * import { posix, win32 } from "https://deno.land/std@$STD_VERSION/path/mod.ts";
+ * const p1 = posix.fromFileUrl("file:///home/foo");
+ * const p2 = win32.fromFileUrl("file:///home/foo");
+ * console.log(p1); // "/home/foo"
+ * console.log(p2); // "\\home\\foo"
+ * ```
+ *
+ * This module is browser compatible.
+ *
+ * @module
+ */
 const os_js_1 = require("../_util/os.js");
 const _win32 = __importStar(require("./win32.js"));
 const _posix = __importStar(require("./posix.js"));

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/posix.js

@@ -24,6 +24,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toFileUrl = exports.fromFileUrl = exports.parse = exports.format = exports.extname = exports.basename = exports.dirname = exports.toNamespacedPath = exports.relative = exports.join = exports.isAbsolute = exports.normalize = exports.resolve = exports.delimiter = exports.sep = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.
@@ -78,6 +79,8 @@ function resolve(...pathSegments) {
 exports.resolve = resolve;
 /**
  * Normalize the `path`, resolving `'..'` and `'.'` segments.
+ * Note that resolving these segments does not necessarily mean that all will be eliminated.
+ * A `'..'` at the top-level will be preserved, and an empty path is canonically `'.'`.
  * @param path to be normalized
  */
 function normalize(path) {
@@ -231,8 +234,8 @@ function toNamespacedPath(path) {
 }
 exports.toNamespacedPath = toNamespacedPath;
 /**
- * Return the directory name of a `path`.
- * @param path to determine name for
+ * Return the directory path of a `path`.
+ * @param path to determine the directory path for
  */
 function dirname(path) {
     (0, _util_js_1.assertPath)(path);
@@ -281,7 +284,7 @@ function basename(path, ext = "") {
         let firstNonSlashEnd = -1;
         for (i = path.length - 1; i >= 0; --i) {
             const code = path.charCodeAt(i);
-            if (code === _constants_js_1.CHAR_FORWARD_SLASH) {
+            if ((0, _util_js_1.isPosixPathSeparator)(code)) {
                 // If we reached a path separator that was not part of a set of path
                 // separators at the end of the string, stop now
                 if (!matchedSlash) {
@@ -291,38 +294,38 @@ function basename(path, ext = "") {
             }
             else {
                 if (firstNonSlashEnd === -1) {
-                    // We saw the first non-path separator, remember this index in case
-                    // we need it if the extension ends up not matching
+                    // We saw the first non-path separator, mark this as the end of our
+                    // path component in case we don't match a whole suffix
                     matchedSlash = false;
                     firstNonSlashEnd = i + 1;
+                    end = firstNonSlashEnd;
                 }
                 if (extIdx >= 0) {
-                    // Try to match the explicit extension
+                    // Try to match the explicit suffix
                     if (code === ext.charCodeAt(extIdx)) {
                         if (--extIdx === -1) {
-                            // We matched the extension, so mark this as the end of our path
+                            // We matched whole suffix, so mark this as the end of our path
                             // component
                             end = i;
                         }
                     }
                     else {
-                        // Extension does not match, so our result is the entire path
-                        // component
+                        // Suffix character does not match, so bail out early
+                        // from checking rest of characters
                         extIdx = -1;
-                        end = firstNonSlashEnd;
                     }
                 }
             }
         }
+        if (end === -1)
+            return "";
         if (start === end)
             end = firstNonSlashEnd;
-        else if (end === -1)
-            end = path.length;
         return path.slice(start, end);
     }
     else {
         for (i = path.length - 1; i >= 0; --i) {
-            if (path.charCodeAt(i) === _constants_js_1.CHAR_FORWARD_SLASH) {
+            if ((0, _util_js_1.isPosixPathSeparator)(path.charCodeAt(i))) {
                 // If we reached a path separator that was not part of a set of path
                 // separators at the end of the string, stop now
                 if (!matchedSlash) {
@@ -344,8 +347,9 @@ function basename(path, ext = "") {
 }
 exports.basename = basename;
 /**
- * Return the extension of the `path`.
+ * Return the extension of the `path` with leading period.
  * @param path with extension
+ * @returns extension (ex. for `file.ts` returns `.ts`)
  */
 function extname(path) {
     (0, _util_js_1.assertPath)(path);
@@ -502,7 +506,7 @@ exports.parse = parse;
  * Converts a file URL to a path string.
  *
  * ```ts
- *      import { fromFileUrl } from "./posix.ts";
+ *      import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/posix.ts";
  *      fromFileUrl("file:///home/foo"); // "/home/foo"
  * ```
  * @param url of a file URL
@@ -519,7 +523,7 @@ exports.fromFileUrl = fromFileUrl;
  * Converts a path string to a file URL.
  *
  * ```ts
- *      import { toFileUrl } from "./posix.ts";
+ *      import { toFileUrl } from "https://deno.land/std@$STD_VERSION/path/posix.ts";
  *      toFileUrl("/home/foo"); // new URL("file:///home/foo")
  * ```
  * @param path to convert to file URL

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/separator.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SEP_PATTERN = exports.SEP = void 0;

package/script/deps/deno.land/{std@0.120.0 → std@0.173.0}/path/win32.js

@@ -24,13 +24,14 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toFileUrl = exports.fromFileUrl = exports.parse = exports.format = exports.extname = exports.basename = exports.dirname = exports.toNamespacedPath = exports.relative = exports.join = exports.isAbsolute = exports.normalize = exports.resolve = exports.delimiter = exports.sep = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.
 const dntShim = __importStar(require("../../../../_dnt.shims.js"));
 const _constants_js_1 = require("./_constants.js");
 const _util_js_1 = require("./_util.js");
-const assert_js_1 = require("../_util/assert.js");
+const asserts_js_1 = require("../_util/asserts.js");
 exports.sep = "\\";
 exports.delimiter = ";";
 /**
@@ -355,7 +356,7 @@ function join(...paths) {
     //   path.join('//server', 'share') -> '\\\\server\\share\\')
     let needsReplace = true;
     let slashCount = 0;
-    (0, assert_js_1.assert)(firstPart != null);
+    (0, asserts_js_1.assert)(firstPart != null);
     if ((0, _util_js_1.isPathSeparator)(firstPart.charCodeAt(0))) {
         ++slashCount;
         const firstLen = firstPart.length;
@@ -538,8 +539,8 @@ function toNamespacedPath(path) {
 }
 exports.toNamespacedPath = toNamespacedPath;
 /**
- * Return the directory name of a `path`.
- * @param path to determine name for
+ * Return the directory path of a `path`.
+ * @param path to determine the directory path for
  */
 function dirname(path) {
     (0, _util_js_1.assertPath)(path);
@@ -673,33 +674,33 @@ function basename(path, ext = "") {
             }
             else {
                 if (firstNonSlashEnd === -1) {
-                    // We saw the first non-path separator, remember this index in case
-                    // we need it if the extension ends up not matching
+                    // We saw the first non-path separator, mark this as the end of our
+                    // path component in case we don't match a whole suffix
                     matchedSlash = false;
                     firstNonSlashEnd = i + 1;
+                    end = firstNonSlashEnd;
                 }
                 if (extIdx >= 0) {
-                    // Try to match the explicit extension
+                    // Try to match the explicit suffix
                     if (code === ext.charCodeAt(extIdx)) {
                         if (--extIdx === -1) {
-                            // We matched the extension, so mark this as the end of our path
+                            // We matched whole suffix, so mark this as the end of our path
                             // component
                             end = i;
                         }
                     }
                     else {
-                        // Extension does not match, so our result is the entire path
-                        // component
+                        // Suffix character does not match, so bail out early
+                        // from checking rest of characters
                         extIdx = -1;
-                        end = firstNonSlashEnd;
                     }
                 }
             }
         }
+        if (end === -1)
+            return "";
         if (start === end)
             end = firstNonSlashEnd;
-        else if (end === -1)
-            end = path.length;
         return path.slice(start, end);
     }
     else {
@@ -726,8 +727,9 @@ function basename(path, ext = "") {
 }
 exports.basename = basename;
 /**
- * Return the extension of the `path`.
+ * Return the extension of the `path` with leading period.
  * @param path with extension
+ * @returns extension (ex. for `file.ts` returns `.ts`)
  */
 function extname(path) {
     (0, _util_js_1.assertPath)(path);
@@ -954,7 +956,7 @@ exports.parse = parse;
  * Converts a file URL to a path string.
  *
  * ```ts
- *      import { fromFileUrl } from "./win32.ts";
+ *      import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/win32.ts";
  *      fromFileUrl("file:///home/foo"); // "\\home\\foo"
  *      fromFileUrl("file:///C:/Users/foo"); // "C:\\Users\\foo"
  *      fromFileUrl("file://localhost/home/foo"); // "\\\\localhost\\home\\foo"
@@ -980,7 +982,7 @@ exports.fromFileUrl = fromFileUrl;
  * Converts a path string to a file URL.
  *
  * ```ts
- *      import { toFileUrl } from "./win32.ts";
+ *      import { toFileUrl } from "https://deno.land/std@$STD_VERSION/path/win32.ts";
  *      toFileUrl("\\home\\foo"); // new URL("file:///home/foo")
  *      toFileUrl("C:\\Users\\foo"); // new URL("file:///C:/Users/foo")
  *      toFileUrl("\\\\127.0.0.1\\home\\foo"); // new URL("file://127.0.0.1/home/foo")