@nestia/e2e 7.0.0-dev.20250607 → 7.0.0

package/src/GaffComparator.ts

@@ -1,64 +1,64 @@
-/**
- * Gaff comparator.
- *
- * `GaffComparator` is a set of comparator functions for `Array.sort()` function,
- * which can be used with {@link TestValidator.sort} function. If you want to see
- * how to use them, see the below example link.
- *
- * @example https://github.com/samchon/nestia-template/blob/master/src/test/features/api/bbs/test_api_bbs_article_index_sort.ts
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace GaffComparator {
-  /**
-   * String(s) comparator.
-   *
-   * @param getter Getter of string(s) from input
-   * @returns Comparator function
-   */
-  export const strings =
-    <T>(getter: (input: T) => string | string[]) =>
-    (x: T, y: T): number => {
-      const a: string[] = wrap(getter(x));
-      const b: string[] = wrap(getter(y));
-
-      const idx: number = a.findIndex((v, i) => v !== b[i]);
-      return idx !== -1 ? compare(a[idx], b[idx]) : 0;
-    };
-
-  /**
-   * Date(s) comparator.
-   *
-   * @param getter Getter of date(s) from input
-   * @returns Comparator function
-   */
-  export const dates =
-    <T>(getter: (input: T) => string | string[]) =>
-    (x: T, y: T): number => {
-      const take = (v: T) =>
-        wrap(getter(v)).map((str) => new Date(str).getTime());
-      const a: number[] = take(x);
-      const b: number[] = take(y);
-
-      const idx: number = a.findIndex((v, i) => v !== b[i]);
-      return idx !== -1 ? a[idx] - b[idx] : 0;
-    };
-
-  /**
-   * Number(s) comparator.
-   *
-   * @param closure Getter of number(s) from input
-   * @returns Comparator function
-   */
-  export const numbers =
-    <T>(closure: (input: T) => number | number[]) =>
-    (x: T, y: T): number => {
-      const a: number[] = wrap(closure(x));
-      const b: number[] = wrap(closure(y));
-
-      const idx: number = a.findIndex((v, i) => v !== b[i]);
-      return idx !== -1 ? a[idx] - b[idx] : 0;
-    };
-
-  const compare = (x: string, y: string) => x.localeCompare(y);
-  const wrap = <T>(elem: T | T[]): T[] => (Array.isArray(elem) ? elem : [elem]);
-}
+/**
+ * Gaff comparator.
+ *
+ * `GaffComparator` is a set of comparator functions for `Array.sort()` function,
+ * which can be used with {@link TestValidator.sort} function. If you want to see
+ * how to use them, see the below example link.
+ *
+ * @example https://github.com/samchon/nestia-template/blob/master/src/test/features/api/bbs/test_api_bbs_article_index_sort.ts
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace GaffComparator {
+  /**
+   * String(s) comparator.
+   *
+   * @param getter Getter of string(s) from input
+   * @returns Comparator function
+   */
+  export const strings =
+    <T>(getter: (input: T) => string | string[]) =>
+    (x: T, y: T): number => {
+      const a: string[] = wrap(getter(x));
+      const b: string[] = wrap(getter(y));
+
+      const idx: number = a.findIndex((v, i) => v !== b[i]);
+      return idx !== -1 ? compare(a[idx], b[idx]) : 0;
+    };
+
+  /**
+   * Date(s) comparator.
+   *
+   * @param getter Getter of date(s) from input
+   * @returns Comparator function
+   */
+  export const dates =
+    <T>(getter: (input: T) => string | string[]) =>
+    (x: T, y: T): number => {
+      const take = (v: T) =>
+        wrap(getter(v)).map((str) => new Date(str).getTime());
+      const a: number[] = take(x);
+      const b: number[] = take(y);
+
+      const idx: number = a.findIndex((v, i) => v !== b[i]);
+      return idx !== -1 ? a[idx] - b[idx] : 0;
+    };
+
+  /**
+   * Number(s) comparator.
+   *
+   * @param closure Getter of number(s) from input
+   * @returns Comparator function
+   */
+  export const numbers =
+    <T>(closure: (input: T) => number | number[]) =>
+    (x: T, y: T): number => {
+      const a: number[] = wrap(closure(x));
+      const b: number[] = wrap(closure(y));
+
+      const idx: number = a.findIndex((v, i) => v !== b[i]);
+      return idx !== -1 ? a[idx] - b[idx] : 0;
+    };
+
+  const compare = (x: string, y: string) => x.localeCompare(y);
+  const wrap = <T>(elem: T | T[]): T[] => (Array.isArray(elem) ? elem : [elem]);
+}

package/src/RandomGenerator.ts

@@ -1,162 +1,162 @@
-/**
- * Random data generator.
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export namespace RandomGenerator {
-  /* ----------------------------------------------------------------
-        IDENTIFICATIONS
-    ---------------------------------------------------------------- */
-  const CHARACTERS = "abcdefghijklmnopqrstuvwxyz";
-  const LETTERS: string = "0123456789" + CHARACTERS;
-
-  /**
-   * Generate random alphabets
-   *
-   * @param length Length of alphabets
-   * @returns Generated alphabets
-   */
-  export const alphabets = (length: number): string =>
-    new Array(length)
-      .fill("")
-      .map(() => CHARACTERS[randint(0, CHARACTERS.length - 1)])
-      .join("");
-
-  /**
-   * Generate random alpha-numeric characters.
-   *
-   * Generate random string constructed with only alphabets and numbers.
-   *
-   * @param length Length of characters
-   * @returns Generated string
-   */
-  export const alphaNumeric = (length: number): string =>
-    new Array(length)
-      .fill("")
-      .map(() => LETTERS[randint(0, LETTERS.length - 1)])
-      .join("");
-
-  /**
-   * Generate random name.
-   *
-   * @param length Length of paragraph, default is 2 or 3
-   * @returns Generated name
-   */
-  export const name = (length: number = randint(2, 3)): string =>
-    paragraph(length)();
-
-  /**
-   * Generate random paragraph.
-   *
-   * @param sentences Number of sentences
-   * @returns Paragraph generator
-   */
-  export const paragraph =
-    (sentences: number = randint(2, 5)) =>
-    /**
-     * @param wordMin Minimum number of characters in a sentence
-     * @param wordMax Maximum number of characters in a sentence
-     * @returns Generated paragraph
-     */
-    (wordMin: number = 3, wordMax: number = 7): string =>
-      new Array(sentences)
-        .fill("")
-        .map(() => alphabets(randint(wordMin, wordMax)))
-        .join(" ");
-
-  /**
-   * Generate random content.
-   *
-   * @param paragraphs Number of paragraphs
-   * @returns Currying function
-   */
-  export const content =
-    (paragraphs: number = randint(3, 8)) =>
-    /**
-     * @param sentenceMin Minimum number of sentences in a paragraph
-     * @param sentenceMax Maximum number of sentences in a paragraph
-     * @returns Currying function
-     */
-    (sentenceMin: number = 10, sentenceMax: number = 40) =>
-    /**
-     * @param wordMin Minimum number of characters in a sentence
-     * @param wordMax Maximum number of characters in a sentence
-     * @returns Content generator
-     */
-    (wordMin: number = 1, wordMax: number = 7): string =>
-      new Array(paragraphs)
-        .fill("")
-        .map(() =>
-          paragraph(randint(sentenceMin, sentenceMax))(wordMin, wordMax),
-        )
-        .join("\n\n");
-
-  /**
-   * Generate random substring.
-   *
-   * @param content Target content
-   * @returns Random substring
-   */
-  export const substring = (content: string): string => {
-    const first: number = randint(0, content.length - 1);
-    const last: number = randint(first + 1, content.length);
-
-    return content.substring(first, last).trim();
-  };
-
-  /**
-   * Generate random mobile number.
-   *
-   * @param prefix Prefix string, default is "010"
-   * @returns Random mobile number
-   * @example 0103340067
-   */
-  export const mobile = (prefix: string = "010"): string =>
-    [
-      prefix,
-      (() => {
-        const value = randint(0, 9999);
-        return value.toString().padStart(value < 1_000 ? 3 : 4, "0");
-      })(),
-      randint(0, 9999).toString().padStart(4, "0"),
-    ].join("");
-
-  /**
-   * Generate random date.
-   *
-   * @param from Start date
-   * @param range Range of random milliseconds
-   * @returns Random date
-   */
-  export const date =
-    (from: Date) =>
-    (range: number): Date =>
-      new Date(from.getTime() + randint(0, range));
-
-  /**
-   * Pick random elements from an array.
-   *
-   * @param array Target array
-   * @param count Number of count to pick
-   * @returns Sampled array
-   */
-  export const sample =
-    <T>(array: T[]) =>
-    (count: number): T[] => {
-      count = Math.min(count, array.length);
-      const indexes: Set<number> = new Set();
-      while (indexes.size < count) indexes.add(randint(0, array.length - 1));
-      return Array.from(indexes).map((index) => array[index]);
-    };
-
-  /**
-   * Pick random element from an array.
-   *
-   * @param array Target array
-   * @returns picked element
-   */
-  export const pick = <T>(array: T[]): T => array[randint(0, array.length - 1)];
-}
-
-const randint = (min: number, max: number): number =>
-  Math.floor(Math.random() * (max - min + 1)) + min;
+/**
+ * Random data generator.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export namespace RandomGenerator {
+  /* ----------------------------------------------------------------
+        IDENTIFICATIONS
+    ---------------------------------------------------------------- */
+  const CHARACTERS = "abcdefghijklmnopqrstuvwxyz";
+  const LETTERS: string = "0123456789" + CHARACTERS;
+
+  /**
+   * Generate random alphabets
+   *
+   * @param length Length of alphabets
+   * @returns Generated alphabets
+   */
+  export const alphabets = (length: number): string =>
+    new Array(length)
+      .fill("")
+      .map(() => CHARACTERS[randint(0, CHARACTERS.length - 1)])
+      .join("");
+
+  /**
+   * Generate random alpha-numeric characters.
+   *
+   * Generate random string constructed with only alphabets and numbers.
+   *
+   * @param length Length of characters
+   * @returns Generated string
+   */
+  export const alphaNumeric = (length: number): string =>
+    new Array(length)
+      .fill("")
+      .map(() => LETTERS[randint(0, LETTERS.length - 1)])
+      .join("");
+
+  /**
+   * Generate random name.
+   *
+   * @param length Length of paragraph, default is 2 or 3
+   * @returns Generated name
+   */
+  export const name = (length: number = randint(2, 3)): string =>
+    paragraph(length)();
+
+  /**
+   * Generate random paragraph.
+   *
+   * @param sentences Number of sentences
+   * @returns Paragraph generator
+   */
+  export const paragraph =
+    (sentences: number = randint(2, 5)) =>
+    /**
+     * @param wordMin Minimum number of characters in a sentence
+     * @param wordMax Maximum number of characters in a sentence
+     * @returns Generated paragraph
+     */
+    (wordMin: number = 3, wordMax: number = 7): string =>
+      new Array(sentences)
+        .fill("")
+        .map(() => alphabets(randint(wordMin, wordMax)))
+        .join(" ");
+
+  /**
+   * Generate random content.
+   *
+   * @param paragraphs Number of paragraphs
+   * @returns Currying function
+   */
+  export const content =
+    (paragraphs: number = randint(3, 8)) =>
+    /**
+     * @param sentenceMin Minimum number of sentences in a paragraph
+     * @param sentenceMax Maximum number of sentences in a paragraph
+     * @returns Currying function
+     */
+    (sentenceMin: number = 10, sentenceMax: number = 40) =>
+    /**
+     * @param wordMin Minimum number of characters in a sentence
+     * @param wordMax Maximum number of characters in a sentence
+     * @returns Content generator
+     */
+    (wordMin: number = 1, wordMax: number = 7): string =>
+      new Array(paragraphs)
+        .fill("")
+        .map(() =>
+          paragraph(randint(sentenceMin, sentenceMax))(wordMin, wordMax),
+        )
+        .join("\n\n");
+
+  /**
+   * Generate random substring.
+   *
+   * @param content Target content
+   * @returns Random substring
+   */
+  export const substring = (content: string): string => {
+    const first: number = randint(0, content.length - 1);
+    const last: number = randint(first + 1, content.length);
+
+    return content.substring(first, last).trim();
+  };
+
+  /**
+   * Generate random mobile number.
+   *
+   * @param prefix Prefix string, default is "010"
+   * @returns Random mobile number
+   * @example 0103340067
+   */
+  export const mobile = (prefix: string = "010"): string =>
+    [
+      prefix,
+      (() => {
+        const value = randint(0, 9999);
+        return value.toString().padStart(value < 1_000 ? 3 : 4, "0");
+      })(),
+      randint(0, 9999).toString().padStart(4, "0"),
+    ].join("");
+
+  /**
+   * Generate random date.
+   *
+   * @param from Start date
+   * @param range Range of random milliseconds
+   * @returns Random date
+   */
+  export const date =
+    (from: Date) =>
+    (range: number): Date =>
+      new Date(from.getTime() + randint(0, range));
+
+  /**
+   * Pick random elements from an array.
+   *
+   * @param array Target array
+   * @param count Number of count to pick
+   * @returns Sampled array
+   */
+  export const sample =
+    <T>(array: T[]) =>
+    (count: number): T[] => {
+      count = Math.min(count, array.length);
+      const indexes: Set<number> = new Set();
+      while (indexes.size < count) indexes.add(randint(0, array.length - 1));
+      return Array.from(indexes).map((index) => array[index]);
+    };
+
+  /**
+   * Pick random element from an array.
+   *
+   * @param array Target array
+   * @returns picked element
+   */
+  export const pick = <T>(array: T[]): T => array[randint(0, array.length - 1)];
+}
+
+const randint = (min: number, max: number): number =>
+  Math.floor(Math.random() * (max - min + 1)) + min;