/src/src.deps.ts | fathym_common@v0.0.185

import * as fathymCommon from "https://deno.land/x/fathym_common@v0.0.185/src/src.deps.ts";

Pure functions for common tasks around collection types like arrays and objects.

Heavily inspired by Kotlin's Collections package.

import { intersect } from "https://deno.land/std@0.224.0/collections/intersect.ts";

const lisaInterests = ["Cooking", "Music", "Hiking"];
const kimInterests = ["Music", "Tennis", "Cooking"];
intersect(lisaInterests, kimInterests); // [ "Cooking", "Music" ]

Classes

ServerSentEventStream

Transforms server-sent message objects into strings for the client.

Variables

v DELIMITER
v posix deprecated
v SEPARATOR
v SEPARATOR_PATTERN
v STATUS_CODE	Contains the `STATUS_CODE` object which contains standard HTTP status codes and provides several type guards for handling status codes with type safety.
v STATUS_TEXT	A record of all the status codes text.
v win32 deprecated

Functions

f aggregateGroups	Applies the given aggregator to each group in the given grouping, returning the results together with the respective group keys
f associateBy	Transforms the given array into a Record, extracting the key of each element using the given selector. If the selector produces the same key for multiple elements, the latest one will be used (overriding the ones before it).
f associateWith	Builds a new Record using the given array as keys and choosing a value for each key using the given selector. If any of two pairs would have the same value the latest on will be used (overriding the ones before it).
f basename	Return the last portion of a `path`. Trailing directory separators are ignored, and optional suffix is removed.
f chunk	Splits the given array into chunks of the given size and returns them.
f common	Determines the common path from a set of paths, using an optional separator, which defaults to the OS default separator.
f deepMerge	Merges the two given Records, recursively merging any nested Records with the second collection overriding the first in case of conflict
f dirname	Return the directory path of a `path`.
f distinct	Returns all distinct elements in the given array, preserving order by first occurrence.
f distinctBy	Returns all elements in the given array that produce a distinct value using the given selector, preserving order by first occurrence.
f dropLastWhile	Returns a new array that drops all elements in the given collection until the last element that does not match the given predicate.
f dropWhile	Returns a new array that drops all elements in the given collection until the first element that does not match the given predicate.
f extname	Return the extension of the `path` with leading period.
f filterEntries	Returns a new record with all entries of the given record except the ones that do not match the given predicate.
f filterKeys	Returns a new record with all entries of the given record except the ones that have a key that does not match the given predicate.
f filterValues	Returns a new record with all entries of the given record except the ones that have a value that does not match the given predicate.
f findSingle	Returns an element if and only if that element is the only one matching the given condition. Returns `undefined` otherwise.
f firstNotNullishOf	Applies the given selector to elements in the given array until a value is produced that is neither `null` nor `undefined` and returns that value. Returns `undefined` if no such value is produced.
f format	Generate a path from `FormatInputPathObject` object.
f fromFileUrl	Converts a file URL to a path string.
f globToRegExp	Convert a glob string to a regular expression.
f includesValue	If the given value is part of the given object it returns true, otherwise it returns false. Doesn't work with non-primitive values: includesValue({x: {}}, {}) returns false.
f intersect	Returns all distinct elements that appear at least once in each of the given arrays.
f isAbsolute	Verifies whether provided path is absolute
f isClientErrorStatus	A type guard that determines if the status code is a client error.
f isErrorStatus	A type guard that determines if the status code is an error.
f isGlob	Test whether the given string is a glob
f isInformationalStatus	A type guard that determines if the status code is informational.
f isRedirectStatus	A type guard that determines if the status code is a redirection.
f isServerErrorStatus	A type guard that determines if the status code is a server error.
f isStatus	Returns whether the provided number is a valid HTTP status code.
f isSuccessfulStatus	A type guard that determines if the status code is successful.
f join	Join all given a sequence of `paths`,then normalizes the resulting path.
f joinGlobs	Like join(), but doesn't collapse "**/.." when `globstar` is true.
f joinToString	Transforms the elements in the given array to strings using the given selector. Joins the produced strings into one using the given `separator` and applying the given `prefix` and `suffix` to the whole string afterwards. If the array could be huge, you can specify a non-negative value of `limit`, in which case only the first `limit` elements will be appended, followed by the `truncated` string. Returns the resulting string.
f mapEntries	Applies the given transformer to all entries in the given record and returns a new record containing the results.
f mapKeys	Applies the given transformer to all keys in the given record's entries and returns a new record containing the transformed entries.
f mapNotNullish	Returns a new array, containing all elements in the given array transformed using the given transformer, except the ones that were transformed to `null` or `undefined`.
f mapValues	Applies the given transformer to all values in the given record and returns a new record containing the resulting keys associated to the last value that produced them.
f maxBy	Returns the first element that is the largest value of the given function or undefined if there are no elements.
f maxOf	Applies the given selector to all elements of the provided collection and returns the max value of all elements. If an empty array is provided the function will return undefined
f maxWith	Returns the first element having the largest value according to the provided comparator or undefined if there are no elements.
f minBy	Returns the first element that is the smallest value of the given function or undefined if there are no elements
f minOf	Applies the given selector to all elements of the given collection and returns the min value of all elements. If an empty array is provided the function will return undefined.
f minWith	Returns the first element having the smallest value according to the provided comparator or undefined if there are no elements
f normalize	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 `'.'`.
f normalizeGlob	Like normalize(), but doesn't collapse "**/.." when `globstar` is true.
f omit	Creates a new object by excluding the specified keys from the provided object.
f parse	Return a `ParsedPath` object of the `path`.
f partition	Returns a tuple of two arrays with the first one containing all elements in the given array that match the given predicate and the second one containing all that do not.
f partitionEntries	Returns a tuple of two records with the first one containing all entries of the given record that match the given predicate and the second one containing all that do not.
f permutations	Builds all possible orders of all elements in the given array Ignores equality of elements, meaning this will always return the same number of permutations for a given length of input.
f pick	Creates a new object by including the specified keys from the provided object.
f reduceGroups	Applies the given reducer to each group in the given grouping, returning the results together with the respective group keys.
f relative	Return the relative path from `from` to `to` based on current working directory.
f resolve	Resolves path segments into a `path`
f runningReduce	Calls the given reducer on each element of the given collection, passing its result as the accumulator to the next respective call, starting with the given initialValue. Returns all intermediate accumulator results.
f sample	Returns a random element from the given array.
f slidingWindows	Generates sliding views of the given array of the given size and returns a new array containing all of them.
f sortBy	Returns all elements in the given collection, sorted by their result using the given selector. The selector function is called only once for each element. Ascending or descending order can be specified.
f sumOf	Applies the given selector to all elements in the given collection and calculates the sum of the results.
f takeLastWhile	Returns all elements in the given array after the last element that does not match the given predicate.
f takeWhile	Returns all elements in the given collection until the first element that does not match the given predicate.
f toFileUrl	Converts a path string to a file URL.
f toNamespacedPath	Resolves path to a namespace path
f union	Returns all distinct elements that appear in any of the given arrays.
f unzip	Builds two separate arrays from the given array of 2-tuples, with the first returned array holding all first tuple elements and the second one holding all the second elements.
f withoutAll	Returns an array excluding all given values.
f zip	Builds N-tuples of elements from the given N arrays with matching indices, stopping when the smallest array's end is reached.

Interfaces

I GlobOptions	Options for `globToRegExp`.
I ParsedPath	A parsed path object generated by path.parse() or consumed by path.format().
I ServerSentEventMessage	Represents a message in the Server-Sent Event (SSE) protocol.

Type Aliases

T ArrayValueType	Get array values type
T ClientErrorStatus	An HTTP status that is a client error (4XX).
T DeepMerge	Merge deeply two objects
T DeepMergeOptions	Deep merge options
T ErrorStatus	An HTTP status that is an error (4XX and 5XX).
T ExpandRecursively	Force intellisense to expand the typing to hide merging typings
T FormatInputPathObject
T GlobToRegExpOptions
T InformationalStatus	An HTTP status that is a informational (1XX).
T JoinToStringOptions	Options for `joinToString`.
T MapKeyType	Get map values types
T MapValueType	Get map values types
T Merge	Merge two objects
T MergeAllArrays	Merge all sets types definitions from keys present in both objects
T MergeAllMaps	Merge all sets types definitions from keys present in both objects
T MergeAllRecords	Merge all records types definitions from keys present in both objects
T MergeAllSets	Merge all sets types definitions from keys present in both objects
T MergeRightOmitComplexes	Merge two objects, with left precedence
T MergingStrategy	Merging strategy
T ObjectXorKeys	Object with keys in either T or U but not in both
T OmitComplexes	Exclude map, sets and array from type
T Order	Order option for `SortByOptions`.
T PartialByType	Filter of keys matching a given type
T RedirectStatus	An HTTP status that is a redirect (3XX).
T ServerErrorStatus	An HTTP status that is a server error (5XX).
T SetValueType	Get set values type
T SortByOptions	Options for `sortBy`.
T StatusCode	An HTTP status code.
T StatusText	An HTTP status text.
T SuccessfulStatus	An HTTP status that is a success (2XX).