provide a "official" standalone function for removing any rich markup from a string

[calestyo]

Hey.

I'd like allow for making optional use of rich or things like e.g. rich_argparse.
Problem is now, that if rich isn’t available (or explicitly disabled, e.g. via some option), then I need a way to get rid of any rich markup that I’ve included in my strings for the case that rich is not available/used.

While I can do this of course with rich itself (like via rich.text.Text.from_markup(markup).plain), I need it for the case that rich isn’t available.

Could you perhaps ship an “official” example function that covers all possible markup formats and removes them from a given string (and also undoes any escaping via e.g. rich.markup.escape())? Ideally under some permissive licence (well for me GPL would be okay, but others might find this useful, too).

People could then copy and paste that in their code and use it in case rich isn’t available.

Thanks :-)

[calestyo]

I think I’ve implemented the functions, since PRs are disabled o.O ... here’s a branch where you could pick it from:
https://github.com/calestyo/rich/tree/fix-escaping

That originally included a fix for the currently broken escape()-function (see #2993), because they also depend on that fix (well at least unescape():

The branch also adds unescape()- and strip()-functions.

I think they should work, but perhaps better double check 😇. Also I’m open if you would like to rename variables or so. Similarly, if you’d want to use MarkupError rather than ValueError, though I think the latter would be better (and also make these functions easier to copy&past to other projects, if they want to use it in the rich-is-an-optional-dependency case).

As for the licence:
AFAICS, rich is MIT licence?! ... So I guess that anyway means that anyone could literally copy&paste these two functions in their code (regardless of its licence), right?
Or should we rather explicitly do something even more permissive for these two functions only?

[calestyo]

@willmcgugan please have a look :-)