{"id":13592711,"url":"https://github.com/aegirhall/console-menu","last_synced_at":"2025-04-08T23:34:06.552Z","repository":{"id":29935649,"uuid":"123246929","full_name":"aegirhall/console-menu","owner":"aegirhall","description":"A simple Python menu system for building terminal user interfaces.","archived":false,"fork":false,"pushed_at":"2024-05-02T16:05:16.000Z","size":460,"stargazers_count":371,"open_issues_count":48,"forks_count":59,"subscribers_count":11,"default_branch":"develop","last_synced_at":"2025-03-10T13:16:15.876Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aegirhall.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-28T07:31:58.000Z","updated_at":"2025-02-27T10:28:54.000Z","dependencies_parsed_at":"2024-01-16T22:17:45.272Z","dependency_job_id":"20089e90-8bc1-43f9-bba4-5dfe4f45c56f","html_url":"https://github.com/aegirhall/console-menu","commit_stats":{"total_commits":164,"total_committers":10,"mean_commits":16.4,"dds":0.25,"last_synced_commit":"b9b2b88c5413eaee51570242ea3329b9f23f94e7"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegirhall%2Fconsole-menu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegirhall%2Fconsole-menu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegirhall%2Fconsole-menu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aegirhall%2Fconsole-menu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aegirhall","download_url":"https://codeload.github.com/aegirhall/console-menu/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247947820,"owners_count":21023058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T16:01:12.311Z","updated_at":"2025-04-08T23:34:06.195Z","avatar_url":"https://github.com/aegirhall.png","language":"Python","readme":"|Build Status|\\ |Documentation Status|\n\nconsole-menu\n============\n\nA simple Python menu-based UI system for terminal applications.\nPerfect for those times when you need a menu-driven program, but don’t want the\noverhead or learning curve of a full-fledged GUI framework.\n\nDerived from the curses-menu project, but with curses dependency removed.\n\nhttp://console-menu.readthedocs.org/en/latest/\n\n.. image:: https://raw.githubusercontent.com/aegirhall/console-menu/develop/images/console-menu_screenshot1.png\n\n.. image:: https://raw.githubusercontent.com/aegirhall/console-menu/develop/images/console-menu_screenshot2.png\n\n.. image:: https://raw.githubusercontent.com/aegirhall/console-menu/develop/images/console-menu_screenshot3.png\n\n.. image:: https://raw.githubusercontent.com/aegirhall/console-menu/develop/images/console-menu_screenshot4.png\n\nInstallation\n~~~~~~~~~~~~\n\nTested on Python 3.7 - 3.11, as well as pypy and pypy 3.\n\nInstallation can be performed by running pip\n\n.. code:: shell\n\n   pip install console-menu\n\nUsage\n-----\n\nIt's designed to be pretty simple to use. Here's an example\n\n.. code:: python\n\n    # Import the necessary packages\n    from consolemenu import *\n    from consolemenu.items import *\n\n    # Create the menu\n    menu = ConsoleMenu(\"Title\", \"Subtitle\")\n\n    # Create some items\n\n    # MenuItem is the base class for all items, it doesn't do anything when selected\n    menu_item = MenuItem(\"Menu Item\")\n\n    # A FunctionItem runs a Python function when selected\n    function_item = FunctionItem(\"Call a Python function\", input, [\"Enter an input\"])\n\n    # A CommandItem runs a console command\n    command_item = CommandItem(\"Run a console command\",  \"touch hello.txt\")\n\n    # A SelectionMenu constructs a menu from a list of strings\n    selection_menu = SelectionMenu([\"item1\", \"item2\", \"item3\"])\n\n    # A SubmenuItem lets you add a menu (the selection_menu above, for example)\n    # as a submenu of another menu\n    submenu_item = SubmenuItem(\"Submenu item\", selection_menu, menu)\n\n    # Once we're done creating them, we just add the items to the menu\n    menu.append_item(menu_item)\n    menu.append_item(function_item)\n    menu.append_item(command_item)\n    menu.append_item(submenu_item)\n\n    # Finally, we call show to show the menu and allow the user to interact\n    menu.show()\n\n.. |Build Status| image:: https://github.com/aegirhall/console-menu/actions/workflows/ci.yml/badge.svg\n   :target: https://github.com/aegirhall/console-menu/actions/workflows/ci.yml\n.. |Documentation Status| image:: https://readthedocs.org/projects/console-menu/badge/?version=latest\n   :target: http://console-menu.readthedocs.org/en/latest/?badge=latest\n\nDevelopment\n-----------\n\n.. code:: shell\n\n   pip install -r requirements-docs.txt\n   pip install -v -e .\n   pytest\n","funding_links":[],"categories":["Python","📚 فهرست"],"sub_categories":["کتابخانه هاي TUI"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faegirhall%2Fconsole-menu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faegirhall%2Fconsole-menu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faegirhall%2Fconsole-menu/lists"}