Package: cursesplus
Curses PlusExtension library to cursesHow To InstallUsepip3 install cursespluson Linux orpy -m pip install cursespluson WindowsSPECIAL INSTRUCTIONS FOR WINDOWSFor Windows you need to also installwindows-cursesor related program
to provide the basic curses functionalityWhat's New?3.16.1Remove the last bit ofamericanspelling.Add fix to an uncontrollable crash on WindowsAdd home and end to coloured option menuNOTICE! 3.x - Incompatible API changesAs you may have noticed, the major version number has now jumped to 3. You may be wondering why it is 3.15 instead of 3.0. Well, an alpha I was working on got to 3.14, so I bumped it to 3.15 to prevent versioning issues.The following changes likely require changes in your codeMove colours to a new module called constants. Because this is auto-imported, this should not pose an issueMove filline, showcursor, and hidecursor to a new module called utils.Fix spelling issue, utils.filline is now utils.fill_lineChange displayops to optionmenu. Please refactor all calls from displayops() to optionmenu(): No other changes are requiredRemove legacy functionshowerror. Use messagebox.showerror as a replacementRemove legacy functionaskyesno_old. Use messagebox.askyesno as a replacementCombinedisplaymsganddisplaymsgnodelayinto one functionExistingdisplaymsgnodelaycalls can be changed todisplaymsg(stdscr,[messages],False), so change the flag wait_for_keypress to falseRemove redundant american functionset_color. You can either use the (correct) spellingset_colouror you can not use this library.Documentationtransitions.pytransitions contains many transitions to add animations to your program__exec(func,args)NOTE: THIS IS AN INTERNAL FUNCTION, IT IS NOT MEANT TO BE USED BY THE COMMON USERThis executesfunc(args)horizontal_bars(stdscr,func_to_call=None,args=(),speed=1)This is a replacement function to old's type zero. It fills the screen from the top down with horizontal white bars. It then replaces them with black bars in the same configuration.stdscris a curses window objectfunc_to_callis a function. If it is set to none, no function is calledargsis a tuple. The tuple will be passed to the function as argumentsspeedis an int. A higher value increases the animation speed. A lower value (0 - 1) makes it slower. If you set speed to 0, the program will crash.random_blocks(stdscr,func_to_call=None,args=(),speed=1)This is a replacement for old's type one transition. It fills random characters of the screen with blocks until the whole screen is covered, then it removes it in the same fashion.stdscris a curses window objectfunc_to_callis a function. If it is set to none, no function is calledargsis a tuple. The tuple will be passed to the function as argumentsspeedis an int. A higher value increases the animation speed. A lower value (0 - 1) makes it slower. If you set speed to 0, the program will crash.vertical_bars(stdscr,func_to_call=None,args=(),speed=1)This is an all new transition. It functions like horizontal bars except they are vertical and go left to right.stdscris a curses window objectfunc_to_callis a function. If it is set to none, no function is calledargsis a tuple. The tuple will be passed to the function as argumentsspeedis an int. A higher value increases the animation speed. A lower value (0 - 1) makes it slower. If you set speed to 0, the program will crash.utils.pyUtils.py Contain a series of non-ui utility functions. By non-ui I mean that it does not show a screen and it is non-interactive. It is meant to enhance the creation of custom menus.fill_line(stdscr,line,colour)This function fills rowlinewith the colourcolour.stdscris a curses window objectlineis an int. It is the row number you wish to fill incolouris a curses colour. Usecursesplus.set_colour()for thishidecursor()This function hides the console cursorshowcursor()This function shows the console cursorconstants.pyconstants.py contains a series of constants such as colours and special lines.