Merge branch 'main' into fix/expect-custom-equality-case

README.md

@@ -45,18 +45,25 @@ Check out the documentation [here](https://deno.land/std?doc).
    import * as fs from "https://deno.land/std@$STD_VERSION/fs/mod.ts";
    ```
 
-1. Do not import symbols with an underscore in the name.
+1. Do not import symbols with a name _prefixed_ by an underscore (they're not
+   intended for public use).
 
    Bad:
-   ```ts
+   ```ts, ignore
    import { _format } from "https://deno.land/std@$STD_VERSION/path/_common/format.ts";
    ```
 
-1. Do not import modules with an underscore in the path.
+1. Do not import modules with a directory or filename _prefixed_ by an
+   underscore (they're not intended for public use).
 
    Bad:
+   ```ts, ignore
+   import { createLPS } from "https://deno.land/std@$STD_VERSION/streams/_common.ts";
+   ```
+
+   Good:
    ```ts
-   import { filterInPlace } from "https://deno.land/std@$STD_VERSION/collections/_utils.ts";
+   import { TextLineStream } from "https://deno.land/std@$STD_VERSION/streams/text_line_stream.ts";
    ```
 
 1. Do not import test modules or test data.

assert/assert_rejects.ts

@@ -5,6 +5,8 @@ import { assertIsError } from "./assert_is_error.ts";
 /**
  * Executes a function which returns a promise, expecting it to reject.
  *
+ * To assert that a synchronous function throws, use {@linkcode assertThrows}.
+ *
  * @example
  * ```ts
  * import { assertRejects } from "https://deno.land/std@$STD_VERSION/assert/assert_rejects.ts";
@@ -22,6 +24,8 @@ export function assertRejects(
  * If it does not, then it throws. An error class and a string that should be
  * included in the error message can also be asserted.
  *
+ * To assert that a synchronous function throws, use {@linkcode assertThrows}.
+ *
  * @example
  * ```ts
  * import { assertRejects } from "https://deno.land/std@$STD_VERSION/assert/assert_rejects.ts";

assert/assert_throws.ts

@@ -6,6 +6,9 @@ import { AssertionError } from "./assertion_error.ts";
  * Executes a function, expecting it to throw. If it does not, then it
  * throws.
  *
+ * To assert that an asynchronous function rejects, use
+ * {@linkcode assertRejects}.
+ *
  * @example
  * ```ts
  * import { assertThrows } from "https://deno.land/std@$STD_VERSION/assert/assert_throws.ts";
@@ -23,6 +26,9 @@ export function assertThrows(
  * throws. An error class and a string that should be included in the
  * error message can also be asserted.
  *
+ * To assert that an asynchronous function rejects, use
+ * {@linkcode assertRejects}.
+ *
  * @example
  * ```ts
  * import { assertThrows } from "https://deno.land/std@$STD_VERSION/assert/assert_throws.ts";

collections/mod.ts

@@ -54,3 +54,5 @@ export * from "./drop_last_while.ts";
 export * from "./reduce_groups.ts";
 export * from "./sample.ts";
 export * from "./running_reduce.ts";
+export * from "./pick.ts";
+export * from "./omit.ts";

collections/omit.ts

@@ -0,0 +1,26 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+
+/**
+ * Creates a new object by excluding the specified keys from the provided object.
+ *
+ * @example
+ * ```ts
+ * import { omit } from "https://deno.land/std@$STD_VERSION/collections/omit.ts";
+ * import { assertEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_equals.ts";
+ *
+ * const obj = { a: 5, b: 6, c: 7, d: 8 };
+ * const omitted = omit(obj, ["a", "c"]);
+ *
+ * assertEquals(omitted, { b: 6, d: 8 });
+ * ```
+ */
+export function omit<T extends object, K extends keyof T>(
+  obj: Readonly<T>,
+  keys: readonly K[],
+): Omit<T, K> {
+  const excludes = new Set(keys);
+  const has = excludes.has.bind(excludes);
+  return Object.fromEntries(
+    Object.entries(obj).filter(([k, _]) => !has(k as K)),
+  ) as Omit<T, K>;
+}

collections/omit_test.ts

@@ -0,0 +1,38 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+
+import { assertEquals, assertNotStrictEquals } from "../assert/mod.ts";
+import { omit } from "./omit.ts";
+
+Deno.test({
+  name: "omit() returns a new object from the provided object",
+  fn() {
+    const obj = { a: 5, b: 6, c: 7, d: 8 };
+    const omitted = omit(obj, []);
+
+    assertEquals(omitted, { a: 5, b: 6, c: 7, d: 8 });
+    assertNotStrictEquals(omitted, obj);
+  },
+});
+
+Deno.test({
+  name:
+    "omit() returns a new object from the provided object without the provided keys",
+  fn() {
+    const obj = { a: 5, b: 6, c: 7, d: 8 };
+    const omitted = omit(obj, ["a", "c"]);
+
+    assertEquals(omitted, { b: 6, d: 8 });
+    assertNotStrictEquals(omitted, obj);
+  },
+});
+
+Deno.test({
+  name: "omit() returns an empty object when the provided keys is empty",
+  fn() {
+    const obj = { a: 5, b: 6, c: 7, d: 8 };
+    const omitted = omit(obj, ["a", "b", "c", "d"]);
+
+    assertEquals(omitted, {});
+    assertNotStrictEquals(omitted, obj);
+  },
+});

collections/pick.ts

@@ -0,0 +1,22 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+
+/**
+ * Creates a new object by including the specified keys from the provided object.
+ *
+ * @example
+ * ```ts
+ * import { pick } from "https://deno.land/std@$STD_VERSION/collections/pick.ts";
+ * import { assertEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_equals.ts";
+ *
+ * const obj = { a: 5, b: 6, c: 7, d: 8 };
+ * const picked = pick(obj, ["a", "c"]);
+ *
+ * assertEquals(picked, { a: 5, c: 7 });
+ * ```
+ */
+export function pick<T extends object, K extends keyof T>(
+  obj: Readonly<T>,
+  keys: readonly K[],
+): Pick<T, K> {
+  return Object.fromEntries(keys.map((k) => [k, obj[k]])) as Pick<T, K>;
+}

collections/pick_test.ts

@@ -0,0 +1,39 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+
+import { assertEquals, assertNotStrictEquals } from "../assert/mod.ts";
+import { pick } from "./pick.ts";
+
+Deno.test({
+  name: "pick() returns a new empty object when no keys are provided",
+  fn() {
+    const obj = { a: 5, b: 6, c: 7, d: 8 };
+    const picked = pick(obj, []);
+
+    assertEquals(picked, {});
+    assertNotStrictEquals(picked, obj);
+  },
+});
+
+Deno.test({
+  name:
+    "pick() returns a new object from the provided object with the provided keys",
+  fn() {
+    const obj = { a: 5, b: 6, c: 7, d: 8 };
+    const picked = pick(obj, ["a", "c"]);
+
+    assertEquals(picked, { a: 5, c: 7 });
+    assertNotStrictEquals(picked, obj);
+  },
+});
+
+Deno.test({
+  name:
+    "pick() returns a new object from the provided object with the provided keys (all keys are provided)",
+  fn() {
+    const obj = { a: 5, b: 6, c: 7, d: 8 };
+    const picked = pick(obj, ["a", "b", "c", "d"]);
+
+    assertEquals(picked, { a: 5, b: 6, c: 7, d: 8 });
+    assertNotStrictEquals(picked, obj);
+  },
+});

log/base_handler.ts

@@ -1,5 +1,5 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
-import { getLevelByName, LevelName } from "./levels.ts";
+import { getLevelByName, getLevelName, LevelName, LogLevel } from "./levels.ts";
 import type { LogRecord } from "./logger.ts";
 
 export type FormatterFunction = (logRecord: LogRecord) => string;
@@ -11,14 +11,33 @@ export interface BaseHandlerOptions {
 }
 
 export class BaseHandler {
-  level: number;
-  levelName: LevelName;
+  #levelName: LevelName;
+  #level: LogLevel;
   formatter: FormatterFunction;
 
-  constructor(levelName: LevelName, options: BaseHandlerOptions = {}) {
-    this.level = getLevelByName(levelName);
-    this.levelName = levelName;
-    this.formatter = options.formatter || DEFAULT_FORMATTER;
+  constructor(
+    levelName: LevelName,
+    { formatter = DEFAULT_FORMATTER }: BaseHandlerOptions = {},
+  ) {
+    this.#levelName = levelName;
+    this.#level = getLevelByName(levelName);
+    this.formatter = formatter;
+  }
+
+  get level() {
+    return this.#level;
+  }
+  set level(level: LogLevel) {
+    this.#level = level;
+    this.#levelName = getLevelName(level);
+  }
+
+  get levelName() {
+    return this.#levelName;
+  }
+  set levelName(levelName: LevelName) {
+    this.#levelName = levelName;
+    this.#level = getLevelByName(levelName);
   }
 
   handle(logRecord: LogRecord) {

media_types/_util_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { consumeMediaParam, consumeToken, consumeValue } from "./_util.ts";
 
 Deno.test({
-  name: "media_types::util - consumeToken()",
+  name: "consumeToken()",
   fn() {
     const fixtures = [
       ["foo bar", "foo", " bar"],
@@ -19,7 +19,7 @@ Deno.test({
 });
 
 Deno.test({
-  name: "media_types::util - consumeValue()",
+  name: "consumeValue()",
   fn() {
     const fixtures = [
       ["foo bar", "foo", " bar"],
@@ -44,7 +44,7 @@ Deno.test({
 });
 
 Deno.test({
-  name: "media_types::util - consumeMediaParam()",
+  name: "consumeMediaParam()",
   fn() {
     const fixtures = [
       [" ; foo=bar", "foo", "bar", ""],

media_types/content_type_test.ts

@@ -4,7 +4,7 @@ import { contentType } from "./content_type.ts";
 import { assertEquals } from "../assert/mod.ts";
 
 Deno.test({
-  name: "media_types - contentType()",
+  name: "contentType()",
   fn() {
     const fixtures = [
       [".json", "application/json; charset=UTF-8"],
@@ -22,7 +22,7 @@ Deno.test({
 });
 
 Deno.test({
-  name: "media_types - contentType()",
+  name: "contentType() implies types",
   fn() {
     let _str: string;
     // For well-known content types, the return type is a string.

media_types/extension_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { extension } from "./mod.ts";
 
 Deno.test({
-  name: "media_types - extension()",
+  name: "extension()",
   fn() {
     const fixtures: [string, string | undefined][] = [
       ["image/gif", "gif"],

media_types/extensions_by_type_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { extensionsByType } from "./extensions_by_type.ts";
 
 Deno.test({
-  name: "media_types - extensionsByType()",
+  name: "extensionsByType()",
   fn() {
     const fixtures: [string, string[] | undefined][] = [
       ["image/gif", ["gif"]],

media_types/format_media_type_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { formatMediaType } from "./mod.ts";
 
 Deno.test({
-  name: "media_types - formatMediaType",
+  name: "formatMediaType()",
   fn() {
     const fixtures = [
       ["noslash", { X: "Y" }, "noslash; x=Y"],

media_types/get_charset_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { getCharset } from "./mod.ts";
 
 Deno.test({
-  name: "media-types - getCharset()",
+  name: "getCharset()",
   fn() {
     const fixtures = [
       ["text/plain", "UTF-8"],

media_types/parse_media_type_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { parseMediaType } from "./mod.ts";
 
 Deno.test({
-  name: "media_types - parseMediaType()",
+  name: "parseMediaType()",
   fn() {
     const nameFoo = { "name": "foo" };
     const fixtures: [string, string, Record<string, string> | undefined][] = [

media_types/type_by_extension_test.ts

@@ -4,7 +4,7 @@ import { assertEquals } from "../assert/mod.ts";
 import { typeByExtension } from "./mod.ts";
 
 Deno.test({
-  name: "media_types - typeByExtension",
+  name: "typeByExtension()",
   fn() {
     const fixtures = [
       ["js", "application/javascript"],