Skip to main content

Interactively select an entry from your bash/zsh history.

Project description

selecta - Interactively search and select entries from your bash/zsh history.

Python package

This is a Python3 clone of François Fleuret's excellent selector tool.

Screencast

Usage

Just type some characters and see which entries match your words.

You can search for whole sentences by prefixing your search with a double quote.

Use up and down arrows to navigate the list.

Escape/Backspace on the result list returns to the search input.

Escape on the search input closes selecta.

Press Enter to copy the selected entry to the console.

CTRL+a toggles case sensitivity

CTRL+r toggles regex search

Installation

pip install selecta

Install the keyboard shortcut ALT+{key}:

selecta_add_keybinding {the alt key you want to use}

This will append one of the following lines to your ~/.bashrc/zshrc:

bind -x '"\C-[{key}":"\selecta --bash -y <(history)"'
bindkey -s "^[{key}" "selecta --zsh -y <(history)^M"

Upgrade from older version to 0.2.x

Delete your old keybinding from .bashrc/.zshrc and register the new version with:

selecta_add_keybinding

--help output

    usage: selecta [-h] [-i] [-b] [-z] [-e] [-a] [-d] [-y] [--bash] [--zsh]
                   [infile]

    positional arguments:
      infile                the file which lines you want to select eg. <(history)

    optional arguments:
      -h, --help            show this help message and exit
      -i, --reverse-order   reverse the order of the lines
      -b, --remove-bash-prefix
                            remove the numeric prefix from bash history
      -z, --remove-zsh-prefix
                            remove the time prefix from zsh history
      -e, --regexp          start in regexp mode
      -a, --case-sensitive  start in case-sensitive mode
      -d, --remove-duplicates
                            remove duplicated lines
      -y, --show-matches    highlight the part of each line which matches the
                            substrings or regexp
      --bash                standard for bash history search, same as -b -i -d
      --zsh                 standard for zsh history search, same as -b -i -d

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

selecta-0.2.2.tar.gz (11.5 kB view details)

Uploaded Source

File details

Details for the file selecta-0.2.2.tar.gz.

File metadata

  • Download URL: selecta-0.2.2.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for selecta-0.2.2.tar.gz
Algorithm Hash digest
SHA256 0a3055f6556d4e651cca325a7bf5d9f188a1d01124a035195a59e2f0f67facf8
MD5 c4bc11afb51a4493ec7c309326d67f5b
BLAKE2b-256 d4406b81142daf09ac911fead4c2e2db948cb9ba0aa2f5cc9a09119fc64b70e4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page