https://github.com/anafvana/groupick

Create a curses-based interactive selection in the terminal and assign options to groups.
https://github.com/anafvana/groupick

curses group gui pick python

Last synced: 6 months ago
JSON representation

Create a curses-based interactive selection in the terminal and assign options to groups.

• Host: GitHub
• URL: https://github.com/anafvana/groupick
• Owner: anafvana
• License: mit
• Created: 2022-09-20T13:12:22.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2023-04-03T22:22:25.000Z (about 3 years ago)
• Last Synced: 2024-04-24T15:18:56.937Z (about 2 years ago)
• Topics: curses, group, gui, pick, python
• Language: Python
• Homepage:
• Size: 258 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# groupick

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

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

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

**groupick** is a small python library based on [wong2's pick](https://github.com/wong2/pick) which allows you to create a curses-based interactive selection in the terminal. With **groupick** you can assign options to groups.

![](example/basic.gif)

## Installation

    $ pip install groupick

## Usage

**groupick** comes with a simple api:

    >>> from groupick import groupick

    >>> instructions = "Assign languages to groups 'a', 'b' or '1'."

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

    >>> groups:set = {"a", "b", 1}

    >>> selected = groupick(options, groups, instructions, indicator="=>", default_index=2)

    >>> print(f"Here is your assignment: {selected}")

**output**:

    >>> {'1': [], 'a': [("JavaScript", 1)], 'b': []}

## Options

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

- `groups`: a list of ints and/or characters symbolising groups (max-length per item is 1)

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

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

- `default_index`: (optional) index of item where cursor starts at by default

- `handle_all`: (optional) define whether it is mandatory to assign all options to groups, defaults to `False`

- `screen`: (optional), if you are using `groupick` within an existing curses application, pass 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)`)

## Community Projects

[wong2's pick](https://github.com/wong2/pick): Original pick project, for selecting one or more options (no grouping)

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