Pick an option in the terminal with a simple GUI

These details have not been verified by PyPI

Project links

Project description

pick

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

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

2.4.0

Sep 15, 2024

2.4.0b1 pre-release

Jun 27, 2024

2.3.2

Apr 25, 2024

2.3.1

Apr 24, 2024

2.3.0

Apr 22, 2024

2.2.0

Nov 21, 2022

2.1.0

Nov 6, 2022

2.0.2

Sep 20, 2022

2.0.1

Sep 20, 2022

This version

2.0.0

Aug 31, 2022

1.6.0

Aug 31, 2022

1.5.0

Aug 30, 2022

1.4.0

Jul 24, 2022

1.3.1

Jul 24, 2022

1.3.0

Jul 14, 2022

1.2.0

Dec 6, 2021

1.1.1

Dec 6, 2021

1.1.0

Dec 5, 2021

1.0.0

Aug 17, 2020

0.6.7

Feb 2, 2020

0.6.6

Jan 29, 2020

0.6.5

Jan 29, 2020

0.6.4

Apr 17, 2018

0.6.3

Mar 19, 2017

0.6.2

Mar 2, 2017

0.6.1

May 24, 2016

0.6.0

Apr 20, 2016

0.5.0

Feb 22, 2016

0.4.0

Jan 20, 2016

0.3.1

Jan 18, 2016

0.3.0

Jan 17, 2016

0.2.0

Jan 17, 2016

0.1.0

Jan 15, 2016

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.0.tar.gz (4.7 kB view details)

Uploaded Aug 31, 2022 Source

Built Distribution

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

Uploaded Aug 31, 2022 Python 3

File details

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

File metadata

Download URL: pick-2.0.0.tar.gz
Upload date: Aug 31, 2022
Size: 4.7 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.1.13 CPython/3.10.0 Darwin/21.5.0

File hashes

Hashes for pick-2.0.0.tar.gz
Algorithm	Hash digest
SHA256	`74b78edf05204eb17c0c0739dc809b2f52079c256fc8229047670823022cc586`
MD5	`dd3ab948885f3183eac53c0c5b31841d`
BLAKE2b-256	`d858f049f5b2d44d0215174db10b00823f7844a09e762a9cfab43452cf07957f`

See more details on using hashes here.

File details

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

File metadata

Download URL: pick-2.0.0-py3-none-any.whl
Upload date: Aug 31, 2022
Size: 4.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.1.13 CPython/3.10.0 Darwin/21.5.0

File hashes

Hashes for pick-2.0.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`6ee76e0e50a45d02863d7bd36bc836b4320e6a0991bdb9916cf866fe36b610bd`
MD5	`4a16b9eb4da50ea164b6bfb2a06b54b5`
BLAKE2b-256	`f39660e64b442eb0ed7084c54a8b38bd70c354c92ae47ae30d095806f2f19248`