RichConsole.py

~~wheel (GHA via nightly.link)~~

We have moved to https://codeberg.org/KOLANICH-libs/RichConsole.py, grab new versions there.

Under the disguise of "better security" Micro$oft-owned GitHub has discriminated users of 1FA passwords while having commercial interest in success and wide adoption of FIDO 1FA specifications and Windows Hello implementation which it promotes as a replacement for passwords. It will result in dire consequencies and is competely inacceptable, read why.

If you don't want to participate in harming yourself, it is recommended to follow the lead and migrate somewhere away of GitHub and Micro$oft. Here is the list of alternatives and rationales to do it. If they delete the discussion, there are certain well-known places where you can get a copy of it. Read why you should also leave GitHub.

Yo dawg so we heard you like text styles so we put styles in your styles so you can style while you styling.

This is a tool to output "poor" (because it is limited by standardized control codes, which are very limited) rich text into a console. When dealing with control codes there is a problem with nesting styles because you have to restore the state, and the state you have to restore depends on the style of the level much distant from the one you are in. This library solves this problem.

You create a directed acyclic graph structure RichStr where each piece of string has its own styleSheet. After you have finished forming the output message you convert it into a string. The library does the rest.

How does it work?

The algorithm is damn simple: it just traverses the directed acyclic graph in depth-first way, determines exact style of each string, computes differences between them and emits control codes to apply them.

Requirements

A terminal supporting color codes.
- Any Linux distro usually has one
- Windows:
  - Windows 10 has built-in support
  - ansicon or ConEmu or MinTTY for older Windows
  - you can call colorama.init() to enable filtering the output with python, but this is VERY glitchy. It raises exceptions even on simple strings. The good thing in it that it supports more codes than ansicon.