Skip to main content

Pick an option in the terminal with a simple GUI

Project description

pick

image PyPI PyPI

pick is a small python library to help you create curses based interactive selection list in the terminal.

Basic Multiselect

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

Community Projects

pickpack: A fork of pick to select tree data.

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

pick-2.0.2.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

pick-2.0.2-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

Details for the file pick-2.0.2.tar.gz.

File metadata

  • Download URL: pick-2.0.2.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.0 Darwin/21.6.0

File hashes

Hashes for pick-2.0.2.tar.gz
Algorithm Hash digest
SHA256 fe40c945fc90a4bc5cc92200d78e32a6b2a43ed8eff67416ef946f805fbf90a7
MD5 76ef0a4674418afd4b0c0eb2b1861f87
BLAKE2b-256 9ff2862ec324ef116fa0e22297a6f95cd0a1b9ed0abf57b6560e1d6e46f0aae7

See more details on using hashes here.

File details

Details for the file pick-2.0.2-py3-none-any.whl.

File metadata

  • Download URL: pick-2.0.2-py3-none-any.whl
  • Upload date:
  • Size: 4.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.0 Darwin/21.6.0

File hashes

Hashes for pick-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 22f6fb1669cddedf5f5de779c76b43161480170b30afbc7822c02cfda755a09a
MD5 4b7d12e45bfde4468e9c627b646c9f05
BLAKE2b-256 d5de86d17e2589bf315652bafba277c01e8538a0cbb752258467aa62c21fd13c

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