feat(transducers): add randomID()

thi-ng · Sep 17, 2018 · b488d2b · b488d2b
1 parent f001314
commit b488d2b
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 0 deletions.
diff --git a/packages/transducers/src/func/random-id.ts b/packages/transducers/src/func/random-id.ts
@@ -0,0 +1,22 @@
+import { choices } from "../iter/choices";
+import { take } from "../xform/take";
+
+/**
+ * Generates and returns a random string of `len` characters (default
+ * 4), plus optional given `prefix` and using only provided `syms`
+ * characters (default lowercase a-z).
+ *
+ * ```
+ * randomID()
+ * "qgdt"
+ *
+ * randomID(8, "id-", "0123456789ABCDEF")
+ * "id-94EF6E1A"
+ * ```
+ *
+ * @param len
+ * @param prefix
+ * @param syms
+ */
+export const randomID = (len = 4, prefix = "", syms = "abcdefghijklmnopqrstuvwxyz") =>
+    [prefix, ...take(len, choices(syms))].join("");
diff --git a/packages/transducers/src/index.ts b/packages/transducers/src/index.ts
@@ -115,6 +115,7 @@ export * from "./func/key-selector";
 export * from "./func/lookup";
 export * from "./func/odd";
 export * from "./func/peek";
+export * from "./func/random-id";
 export * from "./func/renamer";
 export * from "./func/swizzler";
 export * from "./func/weighted-random";