Metadata-Version: 2.1
Name: clitui
Version: 0.2.2
Summary: A tool to help make command line drawing easier.
Home-page: https://github.com/cowboy8625/CLITUI
Author: Cowboy8625
Author-email: cowboy8625@protonmail.com
License: Apache License
Description: # CLITUI
        
        
        ## Installing
        ```
        pip install clitui
        ```
        
        module v 0.1.0
        
        keyboard support only on:
        Mac
        Linux
        
        TUI is a module for making custom CLI/Console App's with python
        
        
        ## Terminal suport
        - [x] Mac
        - [X] Linux
        - [ ] Windows CMD
        
        Hope to add more cool things to package like window manager but
        I'm not sure what I'll need yet do to this projects is only made
        to help another project I am working on.
        https://github.com/cowboy8625/WordRPG
        
        here is a example on how to use clitui
        code found in projects examples folder.
        
        
        ![menu](https://user-images.githubusercontent.com/43012445/75123819-7e173f00-5670-11ea-9504-b2a0b7539a98.gif)
        
        ```py
        #  First off we import all the things needed for this
        #  example
        from clitui import Menu, getchar, fg_by, bg_by, safe_run, is_pressed
        
        #  There many ways of setting colors in clitui but here is one where
        #  We made a global variable to use throughout code
        FG_CYAN = fg_by(0, 160, 160)
        
        # We first create instances of any kind of menu or submenui
        # with Menu class.  Menu takes a x and y and an option argument
        # if no x, y is given submenu's default to parant menu's x, y.
        main_menu = Menu("Main Menu", x=10, y=10)
        options_menu = Menu("Options Menu")
        key_controls = Menu("Key Controler")
        
        # to set color for any menu or submenu just call background_color method.
        # it takes a wide array of valid options.
        # string of "black" or "cycan"
        # a tuple (0, 160, 160) or just put bg_by function directly in there
        main_menu.background_color((50, 0, 0))
        
        # here we add items to are menu
        # you can stack method calls on here as well
        # you need a Name and a id for all menu items.
        main_menu.add("New Game", 0).font_color_for(0, (0, 255, 0))
        main_menu.add("Load", 1).font_color_for(1, FG_CYAN)
        main_menu.add("Save", 2).font_color_for(2, "Cyan")
        
        # if the menu item has a submenu then give it a Menu instances
        # in submenu method
        main_menu.add("Options", 3).submenu(3, options_menu)
        main_menu.add("Exit", 4).add_action(4, exit)
        
        # here we are adding submenu items
        options_menu.add("Sound", 0)
        options_menu.add("Controls", 1).submenu(1, key_controls)
        
        key_controls.add("Key0", 0)
        key_controls.add("Key1", 1)
        key_controls.add("Key2", 2)
        key_controls.add("Key3", 3)
        
        # finally we call the create method to genorate all the need
        # items for drawing.
        main_menu.create()
        
        
        def main():
            while True:
                # to get key presses call getchar
                key = getchar()
        
                # finally to get the fun part and draw the menu just call the draw
                # method
                main_menu.draw()
        
                # to get the curser to move pass in key to method
                # move_curser and use up and down
                main_menu.move_curser(key)
        
                if is_pressed("ESC", key):
                    exit()
        
        
        #  if you want to hide the curser you can call them directly from the curser_controller
        #  module in clitui but it is advised to use the safe_run function so you dont get
        #  your terminal out of sync
        safe_run(main)
        ```
        
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
