v0.3.1
pyunch is a minimal process launcher inspired by dmenu.
Invoke it, start typing, hit enter when the entry you want to run is highlighted.
$ pyunch-index
$ pyunch
pyunch, by default, reads $HOME/.config/pyunch/indices, collects JSON documents in reverse sort order, and updates a dictionary with their contents. The dictionary keys become the values displayed by pyunch, while the list values are then supplied to subprocess.Popen()
.
pyunch-index
is a command line utility for generating indices of executables from file system paths. By default it will scan all the paths in $PATH, gathering executables and generating an index that will be written to $HOME/.config/pyunch/indices/1-path_index.json.
$ pyunch --help
usage: pyunch [-h] [-i INDEX_DIR] [-x WIDTH] [-y HEIGHT]
[--yposition YPOSITION] [--xposition XPOSITION]
[--xoffset XOFFSET] [--yoffset YOFFSET]
[--background BACKGROUND] [--foreground FOREGROUND]
[--activeBackground ACTIVEBACKGROUND]
[--activeForeground ACTIVEFOREGROUND]
[--disabledForeground DISABLEDFOREGROUND]
[--highlightBackground HIGHLIGHTBACKGROUND]
[--highlightColor HIGHLIGHTCOLOR]
[--insertBackground INSERTBACKGROUND]
[--selectColor SELECTCOLOR]
[--selectBackground SELECTBACKGROUND]
[--selectForeground SELECTFOREGROUND]
[--troughColor TROUGHCOLOR] [--version] [-f FONT]
[--font-size FONT_SIZE]
optional arguments:
-h, --help show this help message and exit
-i INDEX_DIR, --index-dir INDEX_DIR
The directory containing the json indices
-x WIDTH, --width WIDTH
The width of the window
-y HEIGHT, --height HEIGHT
The height of the window
--yposition YPOSITION
The y position (top, bottom, or center) of the window
--xposition XPOSITION
The x position (left, right, or center) of the window
--xoffset XOFFSET The offset to apply to the x position
--yoffset YOFFSET The offset to apply to the y position
--background BACKGROUND
--foreground FOREGROUND
--activeBackground ACTIVEBACKGROUND
--activeForeground ACTIVEFOREGROUND
--disabledForeground DISABLEDFOREGROUND
--highlightBackground HIGHLIGHTBACKGROUND
--highlightColor HIGHLIGHTCOLOR
--insertBackground INSERTBACKGROUND
--selectColor SELECTCOLOR
--selectBackground SELECTBACKGROUND
--selectForeground SELECTFOREGROUND
--troughColor TROUGHCOLOR
--version Print the version and exit
-f FONT, --font FONT
--font-size FONT_SIZE
$ pyunch-index --help
usage: pyunch-index [-h] [--no-environmental] [--recurse] [-p PATH]
[-d OUT_DIR] [-f OUT_FILE] [--update]
optional arguments:
-h, --help show this help message and exit
--no-environmental Don't grab the $PATH environmental variable
automatically
--recurse Recursively scan provided paths. WARNING: THIS CAN
MAKE THINGS RUN SLOWLY IN DEEP DIRECTORY STRUCTURES.
-p PATH, --path PATH Manually specify paths to parse looking for
executables.
-d OUT_DIR, --out-dir OUT_DIR
The directory to save the index to
-f OUT_FILE, --out-file OUT_FILE
The file name to save the index to
--update Update a file which is already in place
Brian Balsamo [email protected]