Crate gstuff

Modules

oneshot

Reason for having this is that neither multiqueue nor crossbeam_channel implement UnwindSafe currently.

Macros

ERR

Returns a Err(String), prepending the current location (file name and line number) to the string.

ERRL

Prepends file name and line number to the given message.

find_parse_replace_s

Uses nom to find all matches of the given $submac parser and replace them with the parser’s evaluations.

gstring

A helper to build a string on the stack.

parse_replace_s

Uses nom to find all matches of the given $submac parser and replace them with the $submac results.

take_until_find_parse_s

$starts is an optional Pattern used to optimize the $remainder search.

take_until_parse_s

Implements the /(?x) (.*?) (remainder)/ pattern: looks for remainder first, then returns a tuple with the prefix and the remainder.

try_f

Returns on error, prepending the current location to a stringified error, then passing the string to From::from.

try_fu

Lifts an error into a boxed future. Box<Future<Item=_, Error=_>>.

try_fus

Lifts an error into a boxed future. Box<Future<Item=_, Error=String>>.

try_s

Returns on error, converting the Err value to String and prepending the current location.

try_sp

Like try_s, but takes a reference.

Structs

FileLock

Allows several threads or processes to compete for a shared resource by tracking resource ownership with a file.
If the lock file is older than ttl_sec then it is removed, allowing us to recover from a thread or process dying while holding the lock.

ISATTY

True if the standard output is a terminal.

ProcEn

Process entry in /proc.

ProcIt

Iterate over processes in /proc.

Functions

any_to_str

Useful with panic handlers.

cmd

Run a command, printing it first. Stdout and stderr are forwarded through (inherit).

duration_to_float

Converts the duration into a number of seconds with fractions.

duration_to_ms

Converts the duration into a number of milliseconds.

filename

Shortcut to path->filename conversion.

last_modified_sec

Last-modified of the file in seconds since the UNIX epoch, with fractions.
Returns 0 if the file does not exists.

netstring

Takes a netstring from the front of the slice.

now_float

The current number of seconds since UNIX epoch, with fractions.

now_ms

The current number of milliseconds since UNIX epoch.

slurp

Read contents of the file into a Vec.

slurp_prog

Runs a command in a shell, returning stderr+stdout on success.

status_line

Clears the line to the right, prints the given text, moves the caret all the way to the left.

status_line_clear

Clears the status line ff stdout isatty and status_line isn’t empty.

with_hostname

Wraps gethostname to fetch the current hostname into a temporary buffer.

with_status_line

Clear the status line, run the code, then restore the status line.