App, lib, cmds: Fix mypy.explicit-override fallout

This commit adds @override decorators to approximately 300 methods
across 76 files that inherit from base classes such as AbstractCmd,
FileContext, ExecContext, Distro, SSHClient, and others.

The decorator ensures the type checker can verify that overridden
methods have compatible signatures and prevents accidental shadowing
of inherited methods without intent.

Files modified include command classes, library modules, distro
implementations, and SSH client implementations.

Assisted-by: unsloth/Qwen3.6-35B-A3B-GGUF:IQ4_NL with pi.dev v
Signed-off-by: Jan Lindemann <jan@janware.com>

src/python/jw/pkg/cmds/projects/BaseCmdPkgRelations.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import re
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 from .Cmd import Cmd, Parent
 from .lib.pkg_relations import VersionSyntax
@@ -48,6 +48,7 @@ class BaseCmdPkgRelations(Cmd):
         super().__init__(parent, 'pkg-' + relation, help = help)
         self.relation = relation
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -141,6 +142,7 @@ class BaseCmdPkgRelations(Cmd):
             help = 'Put double quotes around each listed dependency',
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
         return self.print_pkg_relations(self.relation, args)
 

src/python/jw/pkg/cmds/projects/Cmd.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import override, TYPE_CHECKING
 
 from ...CmdBase import CmdBase as Base
 from ..CmdProjects import CmdProjects as Parent
@@ -13,6 +13,7 @@ class Cmd(Base):  # export
     def __init__(self, parent: Parent, name: str, help: str) -> None:
         super().__init__(parent, name, help)
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
 

src/python/jw/pkg/cmds/projects/CmdBuild.py

@@ -5,7 +5,7 @@ import os
 import re
 
 from functools import lru_cache
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 from ...App import Scope
 from ...lib.log import DEBUG, ERR, NOTICE, log
@@ -22,6 +22,7 @@ class CmdBuild(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'build', help = 'janware software project build tool')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -90,6 +91,7 @@ class CmdBuild(Cmd):  # export
             help = 'Modules to be built',
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
 
         @lru_cache(maxsize = None)

src/python/jw/pkg/cmds/projects/CmdCanonicalizeRemotes.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 from ...lib.base import InputMode
 from ...lib.log import NOTICE, log
@@ -20,6 +20,7 @@ class CmdCanonicalizeRemotes(Cmd):  # export
             parent, 'canonicalize-remotes', help = 'Streamline janware Git remotes'
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -30,6 +31,7 @@ class CmdCanonicalizeRemotes(Cmd):  # export
             help = 'Only log what would be done',
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
 
         async def git(cmd: list[str], ro = False, throw = True) -> Result:

src/python/jw/pkg/cmds/projects/CmdCflags.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from ...App import Scope
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -12,10 +12,12 @@ class CmdCflags(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'cflags', help = 'cflags')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         deps = self.app.get_project_refs(
             args.module,

src/python/jw/pkg/cmds/projects/CmdCheck.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser
@@ -16,6 +16,7 @@ class CmdCheck(Cmd):  # export
         )
         self.load_subcommands()
 
+    @override
     async def _run(self, args):
         import sys
 
@@ -23,5 +24,6 @@ class CmdCheck(Cmd):  # export
         self.parser.print_help()
         sys.exit(1)
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)

src/python/jw/pkg/cmds/projects/CmdCommands.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -11,9 +11,11 @@ class CmdCommands(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'commands', help = 'List available commands')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
 
+    @override
     async def _run(self, args: Namespace) -> None:
         import glob
         import os

src/python/jw/pkg/cmds/projects/CmdCreateFile.py

@@ -1,5 +1,6 @@
 from argparse import ArgumentParser, ArgumentTypeError, Namespace
 from enum import Enum, auto
+from typing import override
 
 from ...lib.log import WARNING, log
 from .Cmd import Cmd, Parent
@@ -93,6 +94,7 @@ class CmdCreateFile(Cmd):  # export
             parent, 'create-file', help = 'Generate a file from project metadata'
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -124,6 +126,7 @@ class CmdCreateFile(Cmd):  # export
         )
         parser.add_argument('module', help = 'The module to generate the file for')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         method = getattr(self, 'render_' + args.format, None)
         if method is None:  # Should be prevented by choices=[] but keeps linter happy

src/python/jw/pkg/cmds/projects/CmdCreatePkgConfig.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 from .Cmd import Cmd, Parent
 from .lib.templates import tmpl_render
@@ -32,6 +32,7 @@ class CmdCreatePkgConfig(Cmd):  # export
             string = re.sub(patt, replacement, string)
         return string
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('-F', '--project-descr-file', default = None)
@@ -46,6 +47,7 @@ class CmdCreatePkgConfig(Cmd):  # export
         parser.add_argument('-R', '--requires-build', default = None)
         parser.add_argument('-V', '--variables', nargs = '*')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         project_conf_var_keys = [
             'description',

src/python/jw/pkg/cmds/projects/CmdExepath.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from ...App import Scope
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -12,6 +12,7 @@ class CmdExepath(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'exepath', help = 'exepath')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -23,6 +24,7 @@ class CmdExepath(Cmd):  # export
         )
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         deps = self.app.get_project_refs(
             args.module,

src/python/jw/pkg/cmds/projects/CmdGetAuthInfo.py

@@ -5,7 +5,7 @@ import re
 from ...lib.log import DEBUG, log
 from ...lib.Uri import Uri
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -19,6 +19,7 @@ class CmdGetAuthInfo(Cmd):  # export
             help = 'Try to retrieve authentication information from the source tree',
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -52,6 +53,7 @@ class CmdGetAuthInfo(Cmd):  # export
             help = 'Show remote base URL',
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
         keys = ['username', 'password']
 

src/python/jw/pkg/cmds/projects/CmdGetval.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -11,6 +11,7 @@ class CmdGetval(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'getval', help = 'Get value from project config')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -21,6 +22,7 @@ class CmdGetval(Cmd):  # export
         parser.add_argument('section', default = '', help = 'Config section')
         parser.add_argument('key', default = '', help = 'Config key')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         project = args.project
         if project is None:

src/python/jw/pkg/cmds/projects/CmdHtdocsDir.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -15,10 +15,12 @@ class CmdHtdocsDir(Cmd):  # export
             help = 'Print source directory containing document root of a given module',
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         r = []
         for m in args.module:

src/python/jw/pkg/cmds/projects/CmdLdflags.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from ...App import Scope
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -12,6 +12,7 @@ class CmdLdflags(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'ldflags', help = 'ldflags')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
@@ -56,6 +57,7 @@ class CmdLdflags(Cmd):  # export
             return None
         return ' '.join(ret)
 
+    @override
     async def _run(self, args: Namespace) -> None:
         deps = self.app.get_project_refs(
             args.module,

src/python/jw/pkg/cmds/projects/CmdLdlibpath.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from ...App import Scope
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -12,6 +12,7 @@ class CmdLdlibpath(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'ldlibpath', help = 'ldlibpath')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -23,6 +24,7 @@ class CmdLdlibpath(Cmd):  # export
         )
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         deps = self.app.get_project_refs(
             args.module,

src/python/jw/pkg/cmds/projects/CmdLibname.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -11,9 +11,11 @@ class CmdLibname(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'libname', help = 'libname')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         print(self.app.get_libname(args.module))

src/python/jw/pkg/cmds/projects/CmdListRepos.py

@@ -6,7 +6,7 @@ from ...lib.log import DEBUG, log
 from ...lib.Uri import Uri
 from ...lib.util import get_password, get_username, run_curl_into
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -18,6 +18,7 @@ class CmdListRepos(Cmd):  # export
             parent, 'list-repos', help = 'Query a remote GIT server for repositories'
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -43,6 +44,7 @@ class CmdListRepos(Cmd):  # export
             '--from-owner', help = "List from-owner's projects", default = 'janware'
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
 
         base_url = Uri(args.base_url)

src/python/jw/pkg/cmds/projects/CmdModules.py

@@ -3,7 +3,7 @@ import re
 
 from ...lib.log import DEBUG, log
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -13,6 +13,7 @@ class CmdModules(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'modules', help = 'Query existing janware packages')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -24,6 +25,7 @@ class CmdModules(Cmd):  # export
             'Key-value pairs, seperated by commas, to be searched for in project.conf',
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
         import pathlib
 

src/python/jw/pkg/cmds/projects/CmdPath.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from ...App import Scope
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -12,10 +12,12 @@ class CmdPath(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'path', help = 'path')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         deps = self.app.get_project_refs(
             args.module,

src/python/jw/pkg/cmds/projects/CmdProjDir.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from ...lib.log import WARNING, log
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -14,10 +14,12 @@ class CmdProjDir(Cmd):  # export
             parent, 'proj-dir', help = 'Print directory of a given package'
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         out = []
         for m in args.module:

src/python/jw/pkg/cmds/projects/CmdPythonpath.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 from ...App import Scope
 from .Cmd import Cmd, Parent
@@ -15,6 +15,7 @@ class CmdPythonpath(Cmd):  # export
             parent, 'pythonpath', help = 'Generate PYTHONPATH for given modules'
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument(
@@ -38,6 +39,7 @@ class CmdPythonpath(Cmd):  # export
         )
         parser.add_argument('module', help = 'Modules', nargs = '*')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         deps = self.app.get_project_refs(
             args.module,

src/python/jw/pkg/cmds/projects/CmdRequiredOsPkg.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from ...App import Scope
 from ...lib.log import DEBUG, log
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -18,6 +18,7 @@ class CmdRequiredOsPkg(Cmd):  # export
             help = 'List distribution packages required for a package',
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('flavours', help = 'Dependency flavours', default = 'build')
@@ -35,6 +36,7 @@ class CmdRequiredOsPkg(Cmd):  # export
             help = 'Put double quotes around each listed dependency',
         )
 
+    @override
     async def _run(self, args: Namespace) -> None:
         modules = args.modules
         flavours = set(args.flavours.split(','))

src/python/jw/pkg/cmds/projects/CmdSummary.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -13,10 +13,12 @@ class CmdSummary(Cmd):  # export
             parent, 'summary', help = 'Print summary description of given modules'
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         r = []
         for m in args.module:

src/python/jw/pkg/cmds/projects/CmdTest.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -11,9 +11,11 @@ class CmdTest(Cmd):  # export
     def __init__(self, parent: Parent) -> None:
         super().__init__(parent, 'test', help = 'Test')
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('blah', default = '', help = 'The blah argument')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         print('blah = ' + args.blah)

src/python/jw/pkg/cmds/projects/CmdTmplDir.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from .Cmd import Cmd, Parent
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 if TYPE_CHECKING:
     from argparse import ArgumentParser, Namespace
@@ -15,10 +15,12 @@ class CmdTmplDir(Cmd):  # export
             help = 'Print directory containing templates of a given module',
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         r = []
         for m in args.module:

src/python/jw/pkg/cmds/projects/check/Cmd.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import override, TYPE_CHECKING
 
 from ....CmdBase import CmdBase as Base
 from ..CmdCheck import CmdCheck as Parent
@@ -13,6 +13,7 @@ class Cmd(Base):  # export
     def __init__(self, parent: Parent, name: str, help: str) -> None:
         super().__init__(parent, name, help)
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
 

src/python/jw/pkg/cmds/projects/check/CmdDep.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, override
 
 from ....lib.log import NOTICE, log
 from .Cmd import Cmd, Parent
@@ -17,11 +17,13 @@ class CmdDep(Cmd):  # export
             help = 'Check for circular dependencies between given modules',
         )
 
+    @override
     def add_arguments(self, parser: ArgumentParser) -> None:
         super().add_arguments(parser)
         parser.add_argument('module', nargs = '*', help = 'Modules')
         parser.add_argument('-f', '--flavour', nargs = '?', default = 'build')
 
+    @override
     async def _run(self, args: Namespace) -> None:
         cycle = self.app.find_circular_deps(args.module, args.flavour)
         if cycle: