2.9KB

Surový Trvalý odkaz Blame Historie

CLI

histui <verb>
<import> <file-1> <file-2> [format]
<export> <file>            [format]
<tui>    <file>            [options]
<init>   <shell>

Import

Read history entries from <file-1> into histuidb <file-2>.

Unless all lines are pure entry values, a format will have to be specified.

If no files are specified, precomposed formats shall be printed. E.g. format for “Bash with timestamps”.

Export

Dump the contents of histuidb <file> to stdout using [format].

Init

Used for printing reasonable default configuration for using histui with the selected shell.

The default configuration, if possible should have the following features:

override history search with invoking histui
sync further commands a histuidb

If no shell is specified, the available options shall be printed.

TUI

$ histui tui [options]
--command   : start in search mode
--normal    : start in normal mode

+---+---------------+
| p |               |
| o |   listing     |
| s |               |
+---+---------------+
|       ruler       |
+-------------------+
|       input       |
+-------------------+

Input

Echo entry value and exit with success.

Select an entry to load the context for. Without filtering this is effectless, however if the output was filtered, the search results are overwritten by the commands that were executed in the same shell as this one.

Clear any filtering or inspection.

Pop result frame.

Result stack

Everytime the user issues a search, or inspects an item the result stack is pushed.

The top search frame can/will be overwritten.

The user may pop or clear by hand.

The result stack is NOT persistent between sessions.

Format

%[flags][width]<specifier>

Flags

-   : left-justify within [width]
#  : relative (has effect on time specifiers)

Width

Number of characters to align to.

Specifiers

These specifiers root mainly from the C stdlib.

s   : history entry
n   : entry number
p   : shell id
a   : short weekday name
A   : full weekday name
u   : ISO 8601 decimal week day weekday (1-7)
b   : short month name
B   : full month name
C   : year (integer) devided by 100
d   : day of the month; 0 padded {"09"}
D   : short date ("MM/DD/YY")
H   : hour in 24h format {18}
I   : hour in 12h format {06}; 0 padded
r   : 12h time {12:38:21 PM}
R   : 24h time ("HH:MM")
S   : seconds; 0 padded {04}
M   : minutes; 0 padded {03}
T   : ISO 8601 time format ("HH:MM:SS")

Configuration

# Comment

if <conditional>
    # ...
elif <conditional>
    # ...
fi

bind <key-combination> <action>
set <option> <value>

Conditionals

<value-1> <operator> <value-2>

Values may be string literals, an environment valiable or a builtin variable.

PARENTNAME : argv0 of the process parrent

Environment

HISTUIFILE : histuidb to be used

2.9KB Surový Trvalý odkaz Blame Historie

CLI