Package: uiblack
uiblackStreamlined cross-platform Textual UI.Attractive console output should not be walled behind libCurses! It should not take dozens of lines just to describe ordinary things like menus or basic prompts. Lastly, attractive console applications should not be limited to only Linux & OSX.Those are the guiding thoughts behind uiblack. A truly cross-platform, dead simple, concise library that handles several mundane development tasks all at once.InstallationOS X, Linux & Windows:pipinstalluiblackLoggingTo keep things simple and cross-platform, logs are generated in the execution directory. (This particular behavior may be subject to change in future builds.)By default, [INFO] level messages are logged.To update the logging level, please use the syslog values specified here:https://en.wikipedia.org/wiki/Syslog#Severity_levelfromuiblack.terminalimportUIBlackTerminal# If you want to specify logging parameters:# Name of log file to be written in local directory (Only Alphanumeric chars permitted)log_name="yourprogram"# Whether the log should be started anew upon each executionrestart_log=False# 0 - 7 Conforms to https://en.wikipedia.org/wiki/Syslog#Severity_levellog_level=4ui=UIBlackTerminal(log_name,restart_log=restart_log,log_level=log_level)Error handlingIf you want to wrap a troublesome function or your entire program in a exception handler that correctly prints to the screen and logs, just add some "pie"!This process:Catches all exceptionsFormats them into a single lineKeeps only the last segment of the traceback (the part we actually care about)Prints correctly to the virtual UIBlack consoleLogs the event WITH traceback in the log file under a single human-readable linefromuiblack.terminalimportUIBlackTerminalui=UIBlackTerminal("yourprogram")@ui.wrapper# Notice the function is wrapped using "pie" syntax before each functiondeftroublesome_func():raiseKeyError@ui.wrapperdefsome_other_func(param):raiseImportErrorConsole outputSyslog outputDual ConsolesStarting in version 1.1.4 the terminal supports dual console output similar to GNU Screen or tmux.The upper console is "a" the lower is "b". Address them with keywords appended to the end of the syslog display functions.fromuiblack.terminalimportUIBlackTerminalui=UIBlackTerminal("yourprogram")ui.debug("Debug text")ui.notice("Info text console a",console="a")ui.notice("Info text console b",console="b")ui.error("error text")ui.console("regular text console b",console="b")ui.warn("This is a warning on console b",console="b")Usage examplesKeep it simple. Just import, instance the library, and use it!fromuiblack.terminalimportUIBlackTerminal# Run with defaults works just fine if logging parameters do not need to be alteredui=UIBlackTerminal("yourprogram")ui.clear()result=ui.input("This is the input question")ui.print_center(result)result=ui.ask_yn("This is the question")ui.print_center(result)foritemsinrange(0,5000,2):ui.load_bar("This is the title of a bar",items,5000)ui.set_main_title("this is a test title")result=ui.ask_list("Question text goes here",["first item here","this is the second item","and this is the third"],)ui.warn("warning here")ui.error("error here")ui.notice("Just a notice")ui.console("this simulates regular print() command")ui.console("And you can see, it scrolls output like the console.")PerformantOne major goal has remained from the start, remain performant. To that end, support for thread-safe operation is baked in. Additionally, various functions support "low_latency" mode. This mode causes the screen to be updated every N-number of iterations to prevent wasting cycles to display content.MetaBrandon Blackburn –PGP Encrypted Chat @ KeybaseDistributed under the Apache 2.0 license. SeeLICENSEfor more information.TL;DR:For a human-readable & fast explanation of the Apache 2.0 license visit:http://www.tldrlegal.com/l/apache2https://github.com/BlackburnHax/uiblack