chore: add ruff and mypy linting with GitHub Actions

- Add ruff and mypy as dev dependencies
- Configure ruff for linting and formatting (E, W, F, I, B, UP rules)
- Configure mypy for type checking with strict settings
- Add GitHub Actions workflow for automated linting on push/PR
- Fix all lint issues in src/ and tests/
- Apply ruff formatting to codebase

Author: xz-dev

.github/workflows/lint.yml

@@ -0,0 +1,25 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/ruff-action@v3
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: format --check
+
+  mypy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --dev
+      - run: uv run mypy src/

pyproject.toml

@@ -66,4 +66,25 @@ addopts = "-m 'not slow'"
 [dependency-groups]
 dev = [
     "pytest>=9.0.2",
+    "ruff>=0.8.0",
+    "mypy>=1.13.0",
 ]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "UP",     # pyupgrade
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_ignores = true
+disallow_untyped_defs = true

src/distrobox_plus/__init__.py

@@ -14,17 +14,19 @@ def _get_command_name() -> str:
     """Get command name from package metadata (pyproject.toml)."""
     try:
         from importlib.metadata import metadata
+
         return metadata(__package__)["Name"]
     except Exception:
         # Development mode: read from pyproject.toml directly
-        import tomllib
         from pathlib import Path
 
+        import tomllib  # type: ignore[import-not-found]
+
         pyproject = Path(__file__).parent.parent.parent / "pyproject.toml"
         if pyproject.exists():
             with open(pyproject, "rb") as f:
                 data = tomllib.load(f)
-            return data.get("project", {}).get("name", "distrobox-plus")
+            return str(data.get("project", {}).get("name", "distrobox-plus"))
         raise
 
 

src/distrobox_plus/cli.py

@@ -9,7 +9,7 @@
 import sys
 
 from .config import VERSION
-from .utils.console import print_msg, print_error, red
+from .utils.console import print_error, print_msg, red
 from .utils.exceptions import DistroboxError
 
 
@@ -38,7 +38,8 @@ def _main(argv: list[str] | None = None) -> int:
         description="Create and manage containerized environments",
     )
     parser.add_argument(
-        "-V", "--version",
+        "-V",
+        "--version",
         action="version",
         version=f"distrobox: {VERSION}",
     )
@@ -82,42 +83,52 @@ def _main(argv: list[str] | None = None) -> int:
     match command:
         case "assemble":
             from .commands.assemble import run
+
             return run(args)
 
         case "create":
             from .commands.create import run
+
             return run(args)
 
         case "enter":
             from .commands.enter import run
+
             return run(args)
 
         case "ephemeral":
             from .commands.ephemeral import run
+
             return run(args)
 
         case "export":
             from .commands.export import run
+
             return run(args)
 
         case "generate-entry":
             from .commands.generate_entry import run
+
             return run(args)
 
         case "list" | "ls":
             from .commands.list import run
+
             return run(args)
 
         case "stop":
             from .commands.stop import run
+
             return run(args)
 
         case "rm":
             from .commands.rm import run
+
             return run(args)
 
         case "upgrade":
             from .commands.upgrade import run
+
             return run(args)
 
         case _: