NEWS.md

History of random:utils releases

2.0.11 (2026-03-03)

• Dependencies updated.
• Documentation updated.

2.0.9 (2026-03-02)

• In utils-db (io.randomseed.utils.db.types), DB type adapters (readers and setters) are now dynamically registered via classpath-scanned adders.edn resources. Hard dependencies on utils-ip and phone-number removed from utils-db. New functions: add-all-readers, add-all-setters, register-reader-adder, register-setter-adder.
• In utils-db, added new namespace io.randomseed.utils.db.coercion with extensible in-coercer and out-coercer multimethods for column-level coercion, plus convenience re-exports of core db abstractions.
• In utils-db, added new namespace io.randomseed.utils.db.sql with SQL-building helpers.
• In utils-identity, added independent DB adapter namespace io.randomseed.utils.db.types.identity with a next.jdbc setter for the Identity type, self-registering via adders.edn.
• In utils-ip, added independent DB adapter namespace io.randomseed.utils.db.types.ip with next.jdbc reader and setter for IP address types (IPAddress, InetAddress, IPv4Address, IPv6Address), self-registering via adders.edn.
• In utils-crypto (io.randomseed.utils.crypto), hardened memory hygiene: derived key bytes are now zeroed (Arrays/fill) after use in encrypt-key and decrypt-key; char[] obtained from Console.readPassword is zeroed after conversion to string in read-pwd.
• In utils-auth (io.randomseed.utils.auth.pwd), re-encrypted password bytes are now zeroed after comparison in check-pwd.
• In utils-ip (io.randomseed.utils.ip), removed spurious locking on locally-constructed Tries in preprocess-ip-list (they are not shared); improved docstring to clarify idempotency and thread-safety contract.
• Dependencies: phone-number bumped to 9.0.23-4.

2.0.8 (2026-03-01)

• Typo fixed in deps.edn.

2.0.7 (2026-03-01)

• Added utils-identity module.
• Fixed a bug in utils-db causing NOPCache to be returned.
• Dependencies updated (removed redundant dependencies).

2.0.6 (2026-02-27)

• Added utils-auth module.

2.0.5 (2026-02-16)

• Clarified and covered with tests that get-data / get-data! use namespaced extension commands: :io.randomseed.utils.bot/data and :io.randomseed.utils.bot/data!.
• In utils-time (io.randomseed.utils.time), removed a reflection warning in compact duration parsing by making BigDecimal constructor dispatch explicit.

2.0.4 (2026-02-15)

• In utils-bus (io.randomseed.utils.bot), normalized built-in bot control commands to simple keywords: :config, :session, :pause, :ping, :stop.
• Updated wrappers to use simple control commands (get-config, get-session, pause, ping, stop!, update-local-config!).
• Added regression tests confirming:
  • built-in wrappers send simple control keywords,
  • qualified custom commands are delegated to bot-specific handlers.

2.0.3 (2026-02-08)

Added io.randomseed.utils.qe with q= macro for safe referential equality.

2.0.2 (2026-01-19)

Tests added to utils-bus.

2.0.1 (2026-01-18)

Package building fixes.

2.0.0 (2026-01-18)

Random Utilities is now distributed as 10 packages:

• utils-bus: asynchronous worker bus
• utils-core: helpers for basic type conversions and checks
• utils-crypto: cryptographic helpers
• utils-db: database abstractions with caching
• utils-ip: IP address support functions
• utils-log: opinionated logging facility
• utils-reitit: Reitit support abstractions
• utils-time: date and time operations
• utils-validators: data validation helpers
• utils: meta-package which holds dependencies for all of the above

1.2.39 (2026-01-13)

• Added to io.randomseed.utils: plaintext->base64-url-safe, base64-url-safe->plaintext, plaintext->base64, base64->plaintext, base64-url-safe->bin, bin->base64-url-safe, base64->bin, bin->base64, bin->plaintext.
• Added to io.randomseed.utils.crypto: salt-b64->bin, salt-bin->b64, key-b64->bin, key-bin->b64, key-text-bin.
• Fixed interactive password and key readers to allow option overrides in io.randomseed.utils.crypto.
• Added tests for io.randomseed.utils.crypto.

1.2.38 (2026-01-12)

• Improved io.randomseed.utils.time/parse-duration.
• Speed optimizations and specification alignment in io.randomseed.utils.map/qassoc.
• Added io.randomseed.utils/some-keyword-down, io.randomseed.utils/some-keyword-down-tr.
• Added tests for io.randomseed.utils.map and io.randomseed.utils.time.

1.2.37 (2026-01-05)

• Fixed logging issues when JAnsi is enabled, added context restoring.

1.2.36 (2026-01-04)

• Added -simple variants of string processing functions and macros.
• Syntactic cleanups.

1.2.35 (2025-12-24)

• Fixed regions with false assumption that namespace of an identifier cannot be nil.

1.2.34 (2023-06-24)

• qsome now short-circuits on predicate being nil or false.

1.2.33 (2023-05-28)

• Added strs-simple, qsome, or-some, some-fn*, qstrb and optimized strs, strspc and strspc-squeezed macros.

1.2.32 (2023-03-20)

• Added memoize+ fast memoization function.

1.2.31 (2023-03-05)

• Fixed binary variants of strs, strspc and strspc-squeezed.

1.2.30 (2023-03-05)

• Fixed string conversion in strs macro.
• Added strspc and strspc-squeezed macros.

1.2.29 (2023-03-05)

• Added strs macro and strb function.

1.2.28 (2023-03-02)

• Version bump for core.cache.

1.2.27 (2023-02-25)

• Speed optimizations (referential equality checks, optimistic conversions, type hints).

1.2.26 (2023-02-14)

• Database caching functions are now using a special keyword instead of false to mark and group cache misses.

1.2.25 (2022-12-09)

• Added defdoc! macro.

1.2.24 (2022-11-22)

• Removed reflection warnings.
• Fixed common validators.

1.2.23 (2022-11-21)

• Improved db/invalidator.
• Added console appenders.

1.2.22 (2022-10-30)

• Added map/qupdate.
• Optimized map/qassoc for nil values as source maps.

1.2.21 (2022-10-28)

• Switched to a custom implementation of fast assoc.

1.2.20 (2022-10-26)

• Multiple map transforming functions optimized for speed.

1.2.19 (2022-10-25)

• Multiple database accessing functions optimized for speed.

1.2.18 (2022-09-18)

• map/update-missing now takes only unary functions by default, without shifting the arguments.

1.2.17 (2022-09-09)

• map/assoc-if and map/assoc-if-not can now handle multiple pairs.

1.2.16 (2022-09-01)

• Added some-str-down.

• Performance improvements in: empty-string?, not-empty-string?, some-str, some-str-up, some-str-simple, some-str-simple-up, some-str-simple-down, some-string.

1.2.15 (2022-08-30)

• Optimizations in ip/bytes-to-ipv4 and ip/bytes-to-ipv6.
• Bug fixed in db/get-cached-prop (list -> list*).

1.2.14 (2022-08-28)

• Added str-squeeze-spc, some-str-squeeze-spc.

1.2.13 (2022-08-25)

• IP predicates improved, safer unsigned bytes support.

1.2.12 (2022-08-25)

• Multiple improvements in IP address conversion functions.

1.2.11 (2022-08-09)

• Added db.types/add-setter-phone-number.

1.2.10 (2022-08-08)

• Added multary variant of settings getter produced by db/make-setting-getter.
• Added multary variant of db/cached-setting-get.
• Keying improved in cached settings (was vector-based, now it's keyword-based).

1.2.9 (2022-07-28)

• Improved validators/explain and validators/validate.
• Introduced 3 operational modes of required parameters validation:
  • matching all of the required parameters,
  • matching at least 1 required parameter,
  • matching at least n required parameters.
• Replaced when with if where appropriate.

1.2.8 (2022-07-25)

• Added validators/explain.

1.2.7 (2022-07-17)

• Added map/map-values-with-path and map/map-values-with-rpath.

1.2.6 (2022-07-15)

• Common validators improved.

1.2.5 (2022-05-26)

• Memoization improved.

1.2.4 (2022-05-15)

• Added var/update.

1.2.3 (2022-04-27)

• Lazy map support functions added compatible with com.intuitiveexplanations/lazy-map: map/lazy, map/to-lazy, map/lazy?, map/select-keys-lazy, map/merge-lazy.

1.2.2 (2022-04-22)

• Added db.types/add-setter-uuid.

1.2.1 (2022-04-21)

• Removed type hints for primitive locals.

1.2.0 (2022-04-20)

• Numeric ID keys support in generic database getters and setters
• Database builders and converters greatly simplified (removed some of the predefined options)
• More verbose error reporting during de-serialization
• Added io.randomseed.utils.db.types with opinionated database readers and writers
• Improved some-str-* functions, added filtering out empty strings in some-str-spc
• Added string processing functions: to-lisp-str, to-snake-str, to-lisp-simple-str, to-snake-simple-str replace-first, to-lisp-str-replace-first, to-snake-str-replace-first, to-lisp-slashed-str, to-snake-slashed-str.

1.1.6 (2022-04-16)

• Added some-symbol, some-symbol-up, some-symbol-simple, simple-symbol-up.

1.1.5 (2022-04-14)

• Fixed a bug in map/nil-keys and map/nil-existing-keys causing error when there was no matching key.

1.1.4 (2022-04-03)

• Added console reading functions: read-line-with-prompt, crypto/read-pwd, crypto/read-key.
• Added high-level text getting functions: ask, crypto/ask-pass, crypto/ask-key.

1.1.3 (2022-04-02)

• Database setter generator simplified.

1.1.2 (2022-04-01)

• Removed Clojure 11.1.0 dependency.
• Added backward compatibility with Clojure versions < 11.1.0.

1.1.1 (2022-04-01)

• Dependencies adjusted for Clojure 1.11.0.
• Updated CircleCI image reference.

1.1.0 (2022-04-01)

• Renamed parse-long to some-long.
• Removed random-uuid.
• Renamed uuid to to-uuid.

1.0.7 (2022-04-01)

• Fixed a bug causing empty keywords not being detected by empty-ident?.
• Added not-empty-string? and not-empty-ident?.
• Improved valuable? and not-valuable?.
• Added macros: not-valuable, when-not-valuable.

1.0.6 (2022-03-30)

• Added empty-string? and empty-ident?.
• Improved valence testing.

1.0.5 (2022-03-29)

• Added Reitit support functions.

1.0.4 (2022-03-28)

• Improved valence testing in valuable? and not-valuable?.

1.0.3 (2022-03-24)

• Fixed typo causing db/make-getter to produce unusable ternary function.

1.0.2 (2022-01-02)

• Better handling of sequential collections in time/parse-duration.

1.0.1 (2021-12-30)

• Improvements in time/parse-duration (multiple arguments support).

1.0.0 (2021-12-28)

• Initial release.