elliotisms


Functions, classes, helpers I find myself using constantly. Probably not super helpful.

$3

Functions can be imported in parts in the form elliotisms/, so for example:

``
import createBuildNumber from 'elliotisms/create-build-number'
`

The List

$3

creates a build number based on the current date and time. It's useful for casual versioning. Returns: String.

$3

creates a test directory with random files, and random content.

Arguments:
- directoryPath (string): The path where the test directory will be created.
- fileCount (number): The number of random files to create.
- fileSize (number): The size of each random file in bytes.

Returns:
- A promise that resolves when the directory and files are created.

$3

This function creates a folder if it does not exist.

Arguments:
- directoryPath (string): The path of the directory to create.

Returns:
- A promise that resolves to the absolute path of the created directory.

$3

This function deletes a directory and all files in it. It's useful for cleaning up after tests. Returns: Promise.

$3

Ensures a .env file exists at the project root by copying from .example.env if missing. Returns: Promise (void).

$3

Creates an observable object that automatically syncs to a JSON file when properties change, with debounced writes and save-on-exit behavior.

Arguments:
- initialData (object, default {}): Initial object state.
- fileName (string, default observedObject.json): Output JSON filename (saved next to the module).
- debounceTime (number, default 200): Debounce delay in milliseconds.

Usage:
`
import ObservableObject from 'elliotisms/object-sync'
const store = new ObservableObject({ count: 0 })
store.observedObject.count += 1
`

$3

Formats a given date/time into a human-friendly relative string (e.g., "2 days ago"). Supports compact output and custom strings.

Arguments:
- data (Date | string | number): A Date, parseable string, or timestamp.
- options (object): { compact?: boolean, customStrings?: object, granularity?: 'auto' | 'detailed' }.

Returns:
- String (e.g., "3h", "yesterday", "2 months ago") or null if no input.

$3

Just my version of process exec. Takes in a single command string.

$3

FS/promises 'exists' function. Returns: Boolean.

$3

I really love fdir for its speed. This is a simple wrapper around it. Returns: Promise.

Arguments:
- directoryPath (string): The path of the directory to read.

Returns:
- A promise that resolves to an array of file paths.

$3

This function checks if an array includes a value. It's useful for checking if an array includes a value that is close to the value you are looking for.

$3

This function gets the path of the script that is currently running. It's useful for getting the path of the script that is currently running.

###kosher-string
The much-needed "is this a real string and value" check.

$3

$3

Used in the build number function. Self-explanatory.

$3

Returns a nice date string in my timezone.

$3

Returns a nice milliseconds string.

$3

Batches promises. e.g, running fetch requests in batches.

$3

Replaces all occurrences of a string in another string.

$3

Takes in a filepath, and if it's valid, returns a filepath that won't overwrite anything. Increments the filename, if necessary. Used to output a file while making sure no overwriting is hapening.

$3

Converts a string to a slug based on my own arbitrary feelings about how formatting should be.

$3

Time since weird al yankovic was born.

$3

Truncates a filename to a certain length.

Arguments:
- filename (string): The original filename.
- maxLength (number): The maximum length of the truncated filename.

Returns:
- A string representing the truncated filename.

$3

xxhash-addon's xxhash3 implementation is probably the fastest hash function I've ever seen. This is a wrapper around it. All glory to the creator.

$3

This ID is 10^{15} smaller than nanoid`.

Arguments: - length (number): The length of the generated ID.

Returns: - A string representing the generated ID.