Skip to main content

A simple console menu

Project description

Simple Consol Menu

this module allows you to create simple console menu.

links

Source
Documentation
Bug Report
PyPi

Installation

pip install simple-console-menu

Usage

from simple_console_menu import Menu

Example

SimpleConsoleMenu


The first menu is the SimpleConsoleMenu.
You can use it by first importing the right file:

from simple_console_menu import Menu

And if you want to use it you can do this:

menu = Menu.simple_console_menu(menu_name: str, menu_items: list[str], input_question: str, menu_size: int = 76, auto_add_quit: bool = False, only_return_number: bool = True, allowed_characters: list[str] | str | None = None, accepted_quit_characters: str = '', return_menu_item: bool = False)

With these parameters : menu_name - Required : name of the menu (Str) menu_items - Required : menu items ["item 1","item 2"] (List) input_question - Optional : Question input (Str) menu_size - Optional : Size of the menu (Int) auto_add_quit - Optional : automatically add a quit option (Bool) only_return_number - Optional : only numbers are allowed to return (Bool) allowed_characters - Optional : specifier which character(s) are allowed if only_return_number is False, separated with ';' (str) accepted_quit_characters - Optional : specifier which character is allowed if only_return_number is False for quit (str) return_menu_item - Optional : return the menu item instead of the number (Bool)

full example:

from simple_console_menu import Menu

menuNumber = Menu.SimpleConsoleMenu('menu', ["item1","item2","item3","item4","item5"], "Number:", 76, True)

if menuNumber == 1:
    print('item1')
elif menuNumber == 2:
    print('item2')
elif menuNumber == 3:
    print('item3')
elif menuNumber == 4:
    print('item4')
elif menuNumber == 5:
    print('item5')

And this wil display

----------------------------------- menu -----------------------------------
1. item1
2. item2
3. item3
4. item4
5. item5
6. Quit
----------------------------------------------------------------------------
Number:1
item1

There is also SimpleConsoleMenuBlock which works the same as SimpleConsoleMenu but looks like this:

╭────────────────────────────────── menu ──────────────────────────────────╮
│1. item1                                                                  │
│2. item2                                                                  │
│3. item3                                                                  │
│4. item4                                                                  │
│5. item5                                                                  │
│6. Quit                                                                   │
╰──────────────────────────────────────────────────────────────────────────╯
Number:

it looks correct in the python console

You can also use the menu class like this:

from simple_console_menu import Menu

example_menu = Menu.menu("Menu", ["item 1", "item 2", "item 3"])
example_menu.display()
user_input = example_menu.get_user_input()
print(user_input)

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

simple_console_menu-1.0.1.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simple_console_menu-1.0.1-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file simple_console_menu-1.0.1.tar.gz.

File metadata

  • Download URL: simple_console_menu-1.0.1.tar.gz
  • Upload date:
  • Size: 11.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.4

File hashes

Hashes for simple_console_menu-1.0.1.tar.gz
Algorithm Hash digest
SHA256 310dc50088bf652fc2b9d86adf7c9d50ec49202b33a8f4b85d6f6c705e9ecd08
MD5 a243b04e0d89964ba44b5bb6e68c1659
BLAKE2b-256 7dc3181f4a87e5ec86b9d9aa24026e194ae906f328201e06f126e619323df41c

See more details on using hashes here.

File details

Details for the file simple_console_menu-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_console_menu-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3dba583e8869e32e5881e015c53c5bc4401ee54e816bebaa870cc4b4a88bab05
MD5 7cc3e17ff94f3cd29c909372a93dc972
BLAKE2b-256 dc245fc1edea78b8859af348d0bd003ab26be99314e4844b4324f591fe5e7c74

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page