searchf
Utility program to interactively search keywords in text files. Works in terminals thanks to curses.
Installation
sudo apt install pipx
pipx install searchf
Requirements:
- Python 3.9 or greater
- Terminal with color support (ie.
TERM=screen-256colororTERM=xterm-256color).
Features
- Filters can either include or exclude file content
- Filters can persist to disk
- Multiple highlight and colorization modes (press
hto cycle through all modes) - Color palettes (press
cto cycle through all palettes) - Various other display modes (
ltoggles line numbers visibility,ktoggles line wrapping, ...) - Multiple views (press
1,2,3to switch) with possibility to pass filters of one view to another view (try!,@,#) - Common search key bindings (
/, thennfor next,pfor previous) - Common key bindings to scroll up/down pages or goto line
- Terminal resizing
Usage
searchf <FILE>
- Press
fto enter keyword in a new filter - Press
?for help
Press ENTER to define the first keyword of a filter and reveal only the lines containing that keyword. Press + to add another keyword to the current filter in order to further narrow down the lines currently displayed.
A filter is a list of keywords that a line must contain to match and get highlighted in a specific color. By defining multiple filters, you can reveal more content of the file. By default, lines not matching any filter are hidden, but you can progressively reveal context surrounding matching lines by pressing m multiple times, all the way to the whole content of the file. Filters can also be used to filter out content you do not want to see (press x to toggle this mode).
Why?
This tool is born from my need to interactively search into log files, with the ability to backtrack when hitting dead ends (hence the use of push/pop of filter and keyword), and to go down some exploratory paths on the side (hence the support of views). I use it most when I'm not fully aware of what I am searching for...
To be more specific, I often have to dig into build log files, which are a raw aggregate of many heterogenous sources (numerous compiler output, deployment scripts, test run and results, ...) resulting in rather unstructured output. The only commonality being that everything is more or less line-oriented. When a build failure occurs, searchf helps me find hints of the root cause which can be hiding about anywhere.
So this tool ends up making little or no assumption on the input file, which can be anything, unstructured and heterogenous, as long as it is line oriented.
Development
Please refer to DEV.md for further information.
1 maintainer
Metadata
1 maintainer
Release files for searchf 1.28
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| searchf-1.28.tar.gz | 49.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| searchf-1.28-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 104.2 kB
Release files / searchf-1.28.tar.gz
| Download URL | searchf-1.28.tar.gz |
|---|---|
| Size | 49.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
935c392485b7a1875f278533a2a24c8c53e2d793f9bb14c396aef8fcf390b612
|
|
BLAKE2b-256 checksum How to use checksums |
fd5c711f6be6c5d2bfc66ee53232425d8e4117b0706e2830e64784ec7b817fa2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / searchf-1.28-py3-none-any.whl
| Download URL | searchf-1.28-py3-none-any.whl |
|---|---|
| Size | 55.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
565dacaf28ae9857e6999ea4654521d3e8c042a01d103d8d7ef99e6f8ac07c42
|
|
BLAKE2b-256 checksum How to use checksums |
05d342fcb29a1e4e310c356e9157c9b7b756381e186e560e990152fd32e40195
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
