Fix release date & restructure CLI commands

Author: xulbux

CHANGELOG.md

@@ -17,9 +17,11 @@
 
 <span id="v1-9-7" />
 
-## ... `v1.9.7`
+## 26.04.2026 `v1.9.7`
 
-* Created a new CLI command `xulbux-fc`, which allows you to parse and render a given string's format codes as ANSI console output.
+* Restructured CLI commands under a single `xulbux-lib` entry point:
+  - `xulbux-lib` shows library info.
+  - `xulbux-lib fc` (*new*) parses and renders a string's format codes as ANSI console output.
 * Added `.get()` method to `ParsedArgData` for safe index access on parsed argument values.
 * Added missing `__init__.py` files to the `base` and `cli` subpackages.
 * Fixed `ModuleNotFoundError` caused by `mypyc` compiling `__init__.py` files, which broke subpackage imports.

README.md

@@ -35,10 +35,10 @@ pip install --upgrade xulbux
 
 When the library is installed, the following commands are available in the console:
 
-| Command       | Description                                                      |
-| :------------ | :--------------------------------------------------------------- |
-| `xulbux-help` | Show some information about the library.                         |
-| `xulbux-fc`   | Parse and render a string's format codes as ANSI console output. |
+| Command           | Description                                                      |
+| :---------------- | :--------------------------------------------------------------- |
+| `xulbux-lib`      | Show some information about the library.                         |
+| `xulbux-lib fc`   | Parse and render a string's format codes as ANSI console output. |
 
 <br>
 

pyproject.toml

@@ -110,8 +110,7 @@ keywords = [
 "License" = "https://github.com/xulbux/python-lib-xulbux/blob/main/LICENSE"
 
 [project.scripts]
-xulbux-help = "xulbux.cli.help:show_help"
-xulbux-fc = "xulbux.cli.tools:render_format_codes"
+xulbux-lib = "xulbux.cli:main"
 
 [tool.flake8]
 max-complexity = 12

src/xulbux/cli/__init__.py

@@ -0,0 +1,12 @@
+import sys
+
+
+def main() -> None:
+    """Main entry point for the `xulbux-lib` CLI command."""
+    match sys.argv[1] if len(sys.argv) > 1 else "":
+        case "fc":
+            from .tools import render_format_codes
+            render_format_codes()
+        case _:
+            from .help import show_help
+            show_help()

src/xulbux/cli/help.py

@@ -9,6 +9,7 @@
 
 
 def get_latest_version() -> Optional[str]:
+    """Fetches the latest version of the library from PyPI."""
     with _request.urlopen(URL) as response:
         if response.status == 200:
             data = _json.load(response)
@@ -18,6 +19,8 @@ def get_latest_version() -> Optional[str]:
 
 
 def is_latest_version() -> Optional[bool]:
+    """Checks if the currently installed version of the
+    library is the latest one available on PyPI."""
     try:
         if (latest := get_latest_version()) in {"", None}:
             return None
@@ -34,44 +37,52 @@ def is_latest_version() -> Optional[bool]:
 CLI_COLORS = {
     "border": "dim|br:black",
     "class": "br:cyan",
+    "cmd": "green",
     "const": "br:blue",
-    "func": "br:green",
+    "fn": "br:green",
     "heading": "br:white",
     "import": "magenta",
     "lib": "br:magenta",
-    "link": "u|br:blue",
+    "link": "br:blue",
     "notice": "br:yellow",
     "punctuator": "br:black",
     "text": "white",
 }
 CLI_HELP = FormatCodes.to_ansi(
-    rf"""  [_|b|#7075FF]               __  __
+    rf"""[_]
+  [b|#7075FF]               __  __
   [b|#7075FF]  _  __ __  __/ / / /_  __  ___  __
   [b|#7075FF] | |/ // / / / / / __ \/ / / | |/ /
   [b|#7075FF] > , </ /_/ / /_/ /_/ / /_/ /> , <
   [b|#7075FF]/_/|_|\____/\__/\____/\____//_/|_|  [*|#000|BG:#8085FF] v[b]{__version__} [*|dim|{CLI_COLORS["notice"]}]({"" if IS_LATEST_VERSION else " (newer available)"})[*]
 
-  [i|#9095FF]A TON OF COOL FUNCTIONS, YOU NEED![*]
+  [i|#9095FF]Simplify common programming tasks![*]
 
+  [b|{CLI_COLORS["heading"]}](Commands:)[*]
+  [{CLI_COLORS["border"]}](╭───────────────────────────────────────────────────╮)[*]
+  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["cmd"]}]xulbux-lib[*]       [{CLI_COLORS["text"]}]Show library info and usage[*]      [{CLI_COLORS["border"]}](│)[*]
+  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["cmd"]}]xulbux-lib [b|{CLI_COLORS["fn"]}](fc)    [{CLI_COLORS["text"]}]Render a string's format codes[*]   [{CLI_COLORS["border"]}](│)[*]
+  [{CLI_COLORS["border"]}](╰───────────────────────────────────────────────────╯)[*]
   [b|{CLI_COLORS["heading"]}](Usage:)[*]
   [{CLI_COLORS["border"]}](╭───────────────────────────────────────────────────╮)[*]
   [{CLI_COLORS["border"]}](│) [i|{CLI_COLORS["punctuator"]}](# LIBRARY CONSTANTS)[*]                               [{CLI_COLORS["border"]}](│)[*]
   [{CLI_COLORS["border"]}](│) [{CLI_COLORS["import"]}]from [{CLI_COLORS["lib"]}]xulbux[{CLI_COLORS["punctuator"]}].[{CLI_COLORS["lib"]}]base[{CLI_COLORS["punctuator"]}].[{CLI_COLORS["lib"]}]consts [{CLI_COLORS["import"]}]import [{CLI_COLORS["const"]}]COLOR[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["const"]}]CHARS[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["const"]}]ANSI[*] [{CLI_COLORS["border"]}](│)[*]
   [{CLI_COLORS["border"]}](│) [i|{CLI_COLORS["punctuator"]}](# Main Classes)[*]                                    [{CLI_COLORS["border"]}](│)[*]
   [{CLI_COLORS["border"]}](│) [{CLI_COLORS["import"]}]from [{CLI_COLORS["lib"]}]xulbux [{CLI_COLORS["import"]}]import [{CLI_COLORS["class"]}]Code[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["class"]}]Color[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["class"]}]Console[{CLI_COLORS["punctuator"]}], ...[*]      [{CLI_COLORS["border"]}](│)[*]
   [{CLI_COLORS["border"]}](│) [i|{CLI_COLORS["punctuator"]}](# module specific imports)[*]                         [{CLI_COLORS["border"]}](│)[*]
-  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["import"]}]from [{CLI_COLORS["lib"]}]xulbux[{CLI_COLORS["punctuator"]}].[{CLI_COLORS["lib"]}]color [{CLI_COLORS["import"]}]import [{CLI_COLORS["func"]}]rgba[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["func"]}]hsla[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["func"]}]hexa[*]         [{CLI_COLORS["border"]}](│)
+  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["import"]}]from [{CLI_COLORS["lib"]}]xulbux[{CLI_COLORS["punctuator"]}].[{CLI_COLORS["lib"]}]color [{CLI_COLORS["import"]}]import [{CLI_COLORS["fn"]}]rgba[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["fn"]}]hsla[{CLI_COLORS["punctuator"]}], [{CLI_COLORS["fn"]}]hexa[*]         [{CLI_COLORS["border"]}](│)
   [{CLI_COLORS["border"]}](╰───────────────────────────────────────────────────╯)[*]
   [b|{CLI_COLORS["heading"]}](Documentation:)[*]
   [{CLI_COLORS["border"]}](╭───────────────────────────────────────────────────╮)[*]
-  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["text"]}]For more information see the GitHub page.         [{CLI_COLORS["border"]}](│)[*]
-  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["link"]}](https://github.com/xulbux/python-lib-xulbux/wiki)  [{CLI_COLORS["border"]}](│)[*]
+  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["text"]}]For more information see the GitHub wiki page:    [{CLI_COLORS["border"]}](│)[*]
+  [{CLI_COLORS["border"]}](│) [{CLI_COLORS["link"]}|link:https://github.com/xulbux/python-lib-xulbux/wiki](github.com/xulbux/python-lib-xulbux/wiki)          [{CLI_COLORS["border"]}](│)[*]
   [{CLI_COLORS["border"]}](╰───────────────────────────────────────────────────╯)[*]
   [_]"""
 )
 
 
 def show_help() -> None:
+    """CLI command function for `xulbux-lib` command, which shows some information about the library."""
     FormatCodes._config_console()
     print(CLI_HELP)
     Console.pause_exit("  [dim](Press any key to exit...)\n\n", pause=True)

src/xulbux/cli/tools.py

@@ -3,14 +3,17 @@
 
 
 def render_format_codes():
+    """CLI command function for `xulbux-lib fc` command, which allows you to parse
+    and render a given string's format codes as ANSI console output."""
     args = Console.get_args({"input": "before"})
+    vals = args.input.values[1:]  # EXCLUDE THE COMMAND ITSELF
 
-    if not args.input.values:
+    if not vals:
         FormatCodes.print("\n[_|i|dim]Provide a string to parse and render\n"
                           "its format codes as ANSI console output.[_]\n")
 
     else:
-        ansi = FormatCodes.to_ansi("".join(args.input.values))
+        ansi = FormatCodes.to_ansi("".join(vals))
         ansi_escaped = FormatCodes.escape_ansi(ansi)
         ansi_stripped = FormatCodes.remove_ansi(ansi)