tupelo.misc — tupelo 0.9.183

Miscellaneous functions.

*os-shell* clj

byte-signed->hex clj/s

(byte-signed->hex signed-byte)

Inputs: [signed-byte] Returns: s/Str

Converts a sequence of unsigned bytes [0..255] to a hex string, where each byte becomes 2 hex digits.

byte-signed->unsigned clj/s

(byte-signed->unsigned signed-byte)

Inputs: [signed-byte :- s/Int]

Converts a signed byte [-128..127] into an unsigned byte [0..255].

byte-unsigned->hex clj/s

(byte-unsigned->hex unsigned-byte)

Inputs: [unsigned-byte :- s/Int] Returns: s/Str

Converts a sequence of unsigned bytes [0..255] to a hex string, where each byte becomes 2 hex digits.

byte-unsigned->signed clj/s

(byte-unsigned->signed unsigned-int)

Inputs: [unsigned-int :- s/Int]

Converts an unsigned int value [0..255] into a signed byte [-128..127].

bytes-signed->hex-str clj/s

(bytes-signed->hex-str signed-bytes)

Inputs: [signed-bytes :- [s/Int]] Returns: s/Str

Converts a sequence of signed bytes [-128..127] to a hex string, where each byte becomes 2 hex digits.

bytes-signed->unsigned clj/s

(bytes-signed->unsigned byte-vals)

Inputs: [byte-vals]

Converts a vector of signed byte values [-128..127] into one of unsigned byte values [0..255]

bytes-unsigned->hex-str clj/s

(bytes-unsigned->hex-str unsigned-bytes)

Inputs: [unsigned-bytes :- [s/Int]] Returns: s/Str

Converts a sequence of unsigned bytes [0..255] to a hex string, where each byte becomes 2 hex digits.

bytes-unsigned->signed clj/s

(bytes-unsigned->signed byte-vals)

Inputs: [byte-vals]

Converts a vector of unsigned byte values [0..255] into one of signed byte values [-128..127]

caller-ns-func clj

(caller-ns-func)

Returns a map with the caller's namespace and function names as strings, like: {:ns-name 'tst.demo.core' :fn-name 'funky'}

dot clj

(dot)

Prints a single dot (flushed) to the console, keeping a running count of dots printed. Wraps to a newline when 100 dots have been printed. Displays the running dot count at the beginning of each line. Usage:

(ns xxx.core (:require [tupelo.misc :as tm])) (tm/dots-config! {:decimation 10} ) (tm/with-dots (doseq [ii (range 2345)] (tm/dot) (Thread/sleep 5)))

dot-counter-watch-fn clj

(dot-counter-watch-fn key dot-counter-ref old-count new-count)

dots-config! clj

(dots-config! ctx)

factorial clj/s

(factorial n)

Inputs: [n :- s/Int] Returns: s/Int

Computes the factorial of N

find-pattern clj/s

(find-pattern pattern-vec data-vec)

Inputs: [pattern-vec :- tsk/List data-vec :- tsk/List] Returns: [s/Int]

Searches for pattern-vec within data-vec, returning a lazy seq of indexes into data-vec.

get-os clj

(get-os)

get-path clj

(get-path path-str)

Wrapper for Java Paths/get to work around the varargs strangeness

hex->int clj/s

hex-chars clj/s

hex-str->signed-bytes clj/s

(hex-str->signed-bytes hex-str)

Inputs: [hex-str :- s/Str]

Converts a hex string to a vector of unsigned bytes

hex-str->unsigned-bytes clj/s

(hex-str->unsigned-bytes hex-str)

Inputs: [hex-str :- s/Str]

Converts a hex string to a vector of unsigned bytes

HID clj/s

hid->wid clj

(hid->wid hid)

Inputs: [hid :- HID] Returns: s/Keyword

Uses an HID to look up a human-friendly Word-ID (WID) from an English dictionary. Useful for debugging purposes.

hid? clj/s

(hid? arg)

Inputs: [arg] Returns: s/Bool

Returns true if the arg is a legal HexID

int->hex clj/s

log-uncaught-exceptions clj

(log-uncaught-exceptions)

new-hid clj/s

(new-hid)

Inputs: [] Returns: HID

Returns a new HexID

round-pow clj

(round-pow val pow)

Round a floating point number to 2 decimal places

sha-uuid clj/s

(sha-uuid)

Inputs: [] Returns: s/Str

Returns a string that is the SHA-1 hash of the Clojure: (clj-uuid/v1) ClojureScript: (cljs.core/random-uuid)

shell-cmd clj

(shell-cmd cmd-str)

Runs a command string in the default OS shell (/bin/bash); returns result in a Clojure map. Example:

(shell-cmd "ls -ldF *")

;=> {:exit 0 ; unix exit status (0 -> normal) :err '' ; text from any errors :out '...' ; text output as would printed to console }

str->byte-array clj/s

(str->byte-array str-val)

Inputs: [str-val :- s/Str]

str->sha clj/s≠

clj

Returns the SHA-1 hex string for a string

cljs

(str->sha str-val)

Inputs: [str-val :- s/Str]

take-dist clj/s

(take-dist n coll)

Returns a sequence of n items from a collection, distributed evenly between first & last elements, which are always included.

uuid->sha clj/s

(uuid->sha uuid)

Returns the SHA-1 hex string for a UUID's string representation

with-dots clj/s macro

(with-dots & body)

Increments indentation level of all spy, spyx, or spyxx expressions within the body.