Skip to main content

simple and pretty tool for selecting items by keyboard in terminal

Project description

easyselect by gmanka

a useful library that allows the user to select between multiple items in the console using the keyboard. Supports very long lists that don't fit on the screen, rich styles, control with buttons up, down, left, right, wasd, j, h, home, end, page up, page down

navigation

installation^

pip install easyselect

usage^

from easyselect import Sel

yes_or_no = Sel(
    items = [
        'yes',
        'no',
    ]
)

answer = yes_or_no.choose()
print(answer)

print text while choosing^

yes_or_no = Sel(
    items = [
        'yes',
        'no',
    ],
    text = 'please select yes or no'
)

rich styles support^

linux only

yes_or_no = Sel(
    items = [
        'yes',
        'no',
    ],
    styles = [
        'green',
        'red'
    ]
)

rich styles documentation

very long items list support^

nums = Sel(
    items = list(range(50))
)

page size^

page_size arg allows to specify how much lines will be rendered on screen

default value is 15

nums = Sel(
    items = list(range(50)),
    page_size = 3
)

supported buttons^

user will able to use these buttons

  • up, down, left, right
  • w, a, s, d, j, k
  • home, end
  • page up, page down

changelog^

you can read changelog here

license^

gnu gpl 3

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

easyselect-23.0.0.tar.gz (201.8 kB view hashes)

Uploaded Source

Built Distribution

easyselect-23.0.0-py3-none-any.whl (3.5 kB view hashes)

Uploaded Python 3

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