hgoblet 0.2.1__py3-none-any.whl

hgoblet/__init__.py

@@ -0,0 +1,10 @@
+"""hgoblet // a switchboard for MProcs-family terminal suites.
+
+hgoblet discovers installed copies of MProcs, Fumuda-XY and Nanuska-GP,
+remembers which one is active, and launches either a suite's basic terminal
+(``mp`` / ``fxy`` / ``ngp``) or one of its launcher functions.
+"""
+
+__version__ = "0.2.1"
+
+__all__ = ["__version__"]

hgoblet/__main__.py

@@ -0,0 +1,6 @@
+"""Allow ``python -m hgoblet``."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

hgoblet/catalog.py

@@ -0,0 +1,133 @@
+"""The three terminal suites hgoblet knows how to switch between.
+
+Each suite is the same MProcs terminal family in a different language skin.
+The short command is the canonical "basic MProcs terminal" for that suite:
+
+    fumuda  -> fxy   (default)
+    mprocs  -> mp
+    nanuska -> ngp
+"""
+
+from __future__ import annotations
+
+import unicodedata
+from dataclasses import dataclass
+from typing import Dict, Optional, Tuple
+
+
+@dataclass(frozen=True)
+class Suite:
+    """One installable MProcs-family terminal suite."""
+
+    key: str
+    name: str
+    package: str
+    distributions: Tuple[str, ...]
+    commands: Tuple[str, ...]
+    tagline: str
+    accent: str = "cyan"
+    default: bool = False
+
+    @property
+    def command(self) -> str:
+        """Canonical short command (fxy / mp / ngp)."""
+        return self.commands[0]
+
+    @property
+    def install_hint(self) -> str:
+        return "python3 -m pip install %s" % self.distributions[0]
+
+
+SUITES: Tuple[Suite, ...] = (
+    Suite(
+        key="fumuda",
+        name="Fumuda-XY",
+        package="Fumuda_XY",
+        distributions=("Fumuda-XY", "Fumuda_XY"),
+        commands=(
+            "fxy",
+            "FXY",
+            "fumuda-xy",
+            "Fumuda-XY",
+            "ふむだXY",
+            "フムダXY",
+        ),
+        tagline="Japanese terminal suite",
+        accent="magenta",
+        default=True,
+    ),
+    Suite(
+        key="mprocs",
+        name="MProcs",
+        package="MProcs",
+        distributions=("MProcs", "mprocs"),
+        commands=("mp", "mprocs", "MProcs"),
+        tagline="original terminal suite",
+        accent="cyan",
+    ),
+    Suite(
+        key="nanuska",
+        name="Nanuska-GP",
+        package="Nanuska_GP",
+        distributions=("Nanuska-GP", "Nanuska_GP"),
+        commands=(
+            "ngp",
+            "NGP",
+            "nanuska-gp",
+            "nanuska",
+            "Nanuska-GP",
+            "нгп",
+            "НГП",
+            "нануска",
+            "Нануска-ГП",
+        ),
+        tagline="Russian terminal suite",
+        accent="green",
+    ),
+)
+
+SUITES_BY_KEY: Dict[str, Suite] = {suite.key: suite for suite in SUITES}
+
+SUITE_ORDER: Tuple[str, ...] = tuple(suite.key for suite in SUITES)
+
+DEFAULT_SUITE: str = next(suite.key for suite in SUITES if suite.default)
+
+
+def _fold(value: object) -> str:
+    text = unicodedata.normalize("NFKC", str(value)).strip().casefold()
+    return text.replace("_", "-")
+
+
+_ALIASES: Dict[str, str] = {}
+for _suite in SUITES:
+    for _token in (_suite.key, _suite.name, _suite.package) + _suite.commands:
+        _ALIASES[_fold(_token)] = _suite.key
+
+# Human-friendly spellings and the two names people actually type.
+_ALIASES.update(
+    {
+        "fumuda": "fumuda",
+        "fumuda-xy": "fumuda",
+        "fumudaxy": "fumuda",
+        "fxy": "fumuda",
+        "mprocs": "mprocs",
+        "m-procs": "mprocs",
+        "mp": "mprocs",
+        "nanuska": "nanuska",
+        "nanuska-gp": "nanuska",
+        "nanuskagp": "nanuska",
+        "ngp": "nanuska",
+    }
+)
+
+
+def normalize_suite(value: object) -> Optional[str]:
+    """Return a canonical suite key for a user-supplied name/alias."""
+    if value is None:
+        return None
+    return _ALIASES.get(_fold(value))
+
+
+def suite_for(value: object) -> Optional[Suite]:
+    key = normalize_suite(value)
+    return SUITES_BY_KEY.get(key) if key else None