https://github.com/aisk/pick

create curses based interactive selection list in the terminal
https://github.com/aisk/pick

cli curses python terminal

Last synced: about 2 months ago
JSON representation

create curses based interactive selection list in the terminal

• Host: GitHub
• URL: https://github.com/aisk/pick
• Owner: aisk
• License: mit
• Created: 2016-01-17T04:28:49.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2025-03-23T11:29:39.000Z (3 months ago)
• Last Synced: 2025-04-14T11:12:04.916Z (3 months ago)
• Topics: cli, curses, python, terminal
• Language: Python
• Homepage:
• Size: 261 KB
• Stars: 753
• Watchers: 14
• Forks: 65
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pick

[![image](https://github.com/aisk/pick/actions/workflows/ci.yml/badge.svg)](https://github.com/aisk/pick/actions/workflows/ci.yml)

[![PyPI](https://img.shields.io/pypi/v/pick.svg)](https://pypi.python.org/pypi/pick)

[![PyPI](https://img.shields.io/pypi/dm/pick)](https://pypi.python.org/pypi/pick)

**pick** is a small python library to help you create curses based

interactive selection list in the terminal.

|         Basic          |         Multiselect          |

| :--------------------: | :--------------------------: |

| ![](example/basic.gif) | ![](example/multiselect.gif) |

## Installation

    $ pip install pick

## Usage

**pick** comes with a simple api:

    >>> from pick import pick

    >>> title = 'Please choose your favorite programming language: '

    >>> options = ['Java', 'JavaScript', 'Python', 'PHP', 'C++', 'Erlang', 'Haskell']

    >>> option, index = pick(options, title)

    >>> print(option)

    >>> print(index)

**outputs**:

    >>> C++

    >>> 4

**pick** multiselect example:

    >>> from pick import pick

    >>> title = 'Please choose your favorite programming language (press SPACE to mark, ENTER to continue): '

    >>> options = ['Java', 'JavaScript', 'Python', 'PHP', 'C++', 'Erlang', 'Haskell']

    >>> selected = pick(options, title, multiselect=True, min_selection_count=1)

    >>> print(selected)

**outputs**:

    >>> [('Java', 0), ('C++', 4)]

## Options

- `options`: a list of options to choose from

- `title`: (optional) a title above options list

- `indicator`: (optional) custom the selection indicator, defaults to `*`

- `default_index`: (optional) set this if the default selected option

  is not the first one

- `multiselect`: (optional), if set to True its possible to select

  multiple items by hitting SPACE

- `min_selection_count`: (optional) for multi select feature to

  dictate a minimum of selected items before continuing

- `screen`: (optional), if you are using `pick` within an existing curses application set this to your existing `screen` object. It is assumed this has initialised in the standard way (e.g. via `curses.wrapper()`, or `curses.noecho(); curses.cbreak(); screen.kepad(True)`)

- `position`: (optional), if you are using `pick` within an existing curses application use this to set the first position to write to. e.g., `position=pick.Position(y=1, x=1)`

- `quit_keys`: (optional), if you want to quit early, you can pass a key codes.

  If the corresponding key are pressed, it will quit the menu.

## Community Projects

[pickpack](https://github.com/anafvana/pickpack): A fork of `pick` to select tree data.