clj-assorted-utils.util — clj-assorted-utils 1.18.8

Utility and helper functions

add-shutdown-hook clj

(add-shutdown-hook f)

Adds a shutdown hook that will be executed when the JVM is shutdown. The supplied function f will be called when the JVM shuts down. Please note: when using multiple hooks, there is no guarantee with respect to the order in which the hooks will be executed.

boolean-array-type clj

byte-array-type clj

byte-seq-to-int clj

(byte-seq-to-int byte-seq)

Convert the byte sequence byte-seq to an integer.

change-int-in-byte-vector clj

(change-int-in-byte-vector v n f)

In the given vector v, change the byte representation of an integer by applying function f.

char-array-type clj

classname clj

(classname o)

Get classname without leading package names of the given object o.

compress-object-to-byte-array clj

(compress-object-to-byte-array obj)

(compress-object-to-byte-array obj alg)

Write an object into a byte array and compress it. A newly allocated byte array with the serialized and compressed object is returned. The compression algorithm can be specified via the second parameter. Currently GZIP (:gzip) and ZIP (:zip) are supported. The default is GZIP.

convert-from-clojure-to-java clj

(convert-from-clojure-to-java input)

Converts the given Clojure specific data structure (list, map, set, vector) into the equivalent "pure" Java data structure. The mapping is as follows: list and vector -> ArrayList, map -> HashMap, set -> HashSet. Nested data structures will be converted recursively.

CountDownFlag clj

counter clj

(counter)

(counter init)

Convenience function for creating a more powerful counter. The created counter allows to have arbitrary single-argument functions passed for manipulating the internal value. When the created counter is called with no argument the current value is returned. Example: (use 'clj-assorted-utils.util) (let [cntr (counter 123)] (println (cntr)) (cntr inc) (cntr dec) (cntr #(- % 123)) (cntr))

create-string-to-file-output clj

(create-string-to-file-output out-file)

(create-string-to-file-output out-file arg-map)

create-threaded-lineseq-reader clj

(create-threaded-lineseq-reader in-file process-fn)

delay-eval clj macro

(delay-eval d & body)

Evaluates the supplied body with the given delay 'd' ([ms]).

delta-counter clj

(delta-counter)

Creates a counter for calculating deltas. The returned delta counter function expects two arguments, a keyword and a numerical value. When called for the first time the initial value will be associated to an internal counter and zero is returned. When called subsequently with the same keyword, the difference between the current value and the stored value is calculated and this delta is returned. The internal counter is then set to the new value. Example: (let [cntr (counter) delta-cntr (delta-counter)] (= 0 (delta-cntr :cntr (cntr))) (cntr inc) (cntr inc) (cntr inc) (= 3 (delta-cntr :cntr (cntr))) (= 0 (delta-cntr :cntr (cntr))))

dir-exists? clj

(dir-exists? d)

Returns true if f exists and is a directory.

double-array-type clj

exec clj

(exec cmd)

Execute the given command.

exec-blocking clj

(exec-blocking cmd)

Execute the given command and block until execution has finished.

exec-with-out clj

(exec-with-out cmd stdout-fn)

(exec-with-out cmd stdout-fn stderr-fn)

Execute the given command and process the output written to stdout with stdout-fn. stdout-fn is run in an own thread. The data written to stdout is passed to stdout-fn line-by-line. When a value of nil is read processing stops and the process in which cmd was executed is destroyed.

executor clj

(executor)

Create an executor for executing fns in an own thread.

exists? clj

(exists? f)

Returns true if f exists in the filesystem.

file-exists? clj

(file-exists? f)

Returns true if f exists and is a file.

Flag clj protocol

await-flag clj

(await-flag this)

Block the current thread until the flag was set.

flag-set? clj

(flag-set? this)

Test if flag had been set. Returns true if flag was set and false otherwise.

set-flag clj

(set-flag this)

Set flag to true.

float-array-type clj

fn-name clj

(fn-name f)

Get the name of the given fn f.

get-arch clj

get-defn-arglists clj

(get-defn-arglists f)

Get the arglists of a function that was defined with defn. This function is intended to be used from within a macor. For a macro version of this functionality please use get-defn-arglists-m.

get-defn-arglists-m clj macro

(get-defn-arglists-m f)

Macro version of get-defn-arglists.

get-fn-arglists clj

(get-fn-arglists f)

Returns a map that contains the actual fn that was passed as argument and its arglists. The result will be a map of form: {:fn f :args <f-args>}. This function is intended to be used from within a macor. For a macro version of this functionality please use get-fn-arglists-m.

get-fn-arglists-m clj macro

(get-fn-arglists-m f)

Macro version of get-fn-arglists.

get-int-from-byte-vector clj

(get-int-from-byte-vector v n)

From given vector of bytes v get the integer starting at offset n. Starting at offset n the next 4 bytes will be converted to an integer.

get-os clj

get-system-property clj

(get-system-property p)

Get system property p. p is a String naming the property go get.

get-with-default clj

(get-with-default m k d)

Get a value for the given key k from a map m and if the value does not exist return the default d.

inc-counter clj

(inc-counter c)

Increment the given simple counter c.

int-array-type clj

int-to-byte-vector clj

(int-to-byte-vector val)

Convert the given integer val to a vector of 4 bytes.

is-dir? clj

(is-dir? d)

Returns true if f is a directory.

is-file? clj

(is-file? f)

Returns true if f is a file.

is-os? clj

(is-os? os)

long-array-type clj

map-quote-vec clj

(map-quote-vec c)

mkdir clj

(mkdir d)

Create directory d and if required all parent directories. This is equivalent to 'mkdir -p d' on Linux systems.

mkfifo clj

(mkfifo f)

object-to-byte-array clj

(object-to-byte-array obj)

Write the given object into a byte array. A newly allocated byte arry with the serialized object is returned.

prepare-counter clj

(prepare-counter)

(prepare-counter init)

Prepare a simple counter. Use @ to access the value.

prepare-flag clj

(prepare-flag)

(prepare-flag n)

Prepare a flag with default value false.

print-err clj

(print-err & s)

print to stderr.

print-err-ln clj

(print-err-ln & s)

Deprecated! Use println-err instead.

println-err clj

(println-err & s)

println to stderr.

process-input-stream-line-by-line clj

(process-input-stream-line-by-line input-stream function)

Process the given input stream line-by-line. The data read from the stream is passed to the given function. The function is executed in an own thread.

process-line-by-line clj

(process-line-by-line location f)

Process input from location line-by-line. Each line is passed to f. The processing is done with a clojure reader. So all locations supported by reader are automatically supported as well.

reduce-selected-map-entries clj

(reduce-selected-map-entries m f selected-keys)

Reduce the values of all selected keys of a map m by applying the function f.

rm clj

(rm f)

Delete file f.

rmdir clj

(rmdir d)

Delete d if d is an empty directory.

run-once clj

(run-once exec f d)

(run-once exec f d tu)

Run f using executor exec once with delay d. Optionally a time unit tu can be given. tu defaults to TimeUnit/MILLISECONDS.

run-repeat clj

(run-repeat exec f d)

(run-repeat exec f id d)

(run-repeat exec f id d tu)

Run f repeatedly using executor exec with delay d. Optionally an initial delay, id, and a time unit tu can be given. Time unit is a static member of TimeUnit, e.g., TimeUnit/SECONDS and defaults to TimeUnit/MILLISECONDS.

short-array-type clj

shutdown clj

(shutdown exec)

Shut executor down.

shutdown-now clj

(shutdown-now exec)

Force executor shut down.

sleep clj

(sleep ms)

Sleep for the given number of milliseconds.

stringify-keyword clj

(stringify-keyword k)

If a keyword is passed returns the name of the keyword. Else the input is left unchanged.

stringify-map clj

(stringify-map m)

Convert all keywords in a map to their respective names. This, essentially, is an extended version of clojure.walk/stringify-keys, which only converts the keys to strings.

touch clj

(touch f)

If f does not exist, create it.

vec-replace clj

(vec-replace v n delta)

In given vector v replace the content of v starting at index n with delta.

with-eo-str clj macro

(with-eo-str & body)

Macro that executes body capturing its stdout and stderr output. This returns a map with the following structure: {:all both-stdout-and-std-err-output-in-proper-order :stderr stderr-output :stdout stdout-output}

with-err-str clj macro

(with-err-str & body)

Analog to with-out-str, just for err: https://clojuredocs.org/clojure.core/with-out-str

with-err-str-cb clj macro

(with-err-str-cb cb-fn & body)

Callback version of with-err-str. This version executes the function cb-fn for every element that was added to the writer. cb-fn is executed after the element was added to the writer.

with-err-str-custom clj macro

(with-err-str-custom write-fn & body)

Customizable version of with-err-str. This version executes the function write-fn for every element that is added to the writer. The element that is added to the writer is the string representation of the return value of write-fn.

with-out-str-cb clj macro

(with-out-str-cb cb-fn & body)

Callback version of with-out-str: https://clojuredocs.org/clojure.core/with-out-str This version executes the function cb-fn for every element that was added to the writer. cb-fn is executed after the element was added to the writer.

with-out-str-custom clj macro

(with-out-str-custom write-fn & body)

Customizable version of with-out-str: https://clojuredocs.org/clojure.core/with-out-str This version executes the function write-fn for every element that is added to the writer. The element that is added to the writer is the string representation of the return value of write-fn.

xml-string-to-map clj

(xml-string-to-map xml-str)

Takes an XML definition in form of a string and outputs the corresponding map.

xml-string-to-map-stringified clj

(xml-string-to-map-stringified xml-str)

Convert the XML string xml-str to a map with all keywords converted to strings.