fix(ci): green main for lint, tests, and MegaLinter (#158)

* fix(ci): make main lint, tests, and MegaLinter green

Wrap long lines for Ruff, harden --help flag test under narrow CI
terminals, fix markdownlint templates/links, tune MegaLinter to the
Ruff/Pyright stack, and fix editorconfig/yamllint noise.

* fix(ci): disable MegaLinter Python tools covered by Ruff/Pyright jobs

MegaLinter's pyright/ruff run without the uv workspace venv and produce
false positives; dedicated Lint and Typecheck workflows remain the gate.

---------

Co-authored-by: ulises-jeremias <ulises.jeremias@users.noreply.github.com>

Author: ulises-jeremias

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,7 +1,9 @@
 ## Summary
+
 -
 
 ## Test plan
+
 - [ ] `make test`
 - [ ] `make lint`
 - [ ] `make typecheck`

.github/workflows/smoke-distribution.yml

@@ -121,20 +121,30 @@ jobs:
         run: |
           set -euo pipefail
 
-          PYPI=$(curl -sfL https://pypi.org/pypi/create-awesome-python-app/json | \
-                 python3 -c "import json,sys; print(json.load(sys.stdin)['info']['version'])")
-
-          DOCKER=$(docker run --rm ulisesjeremias/create-awesome-python-app:latest --version 2>&1 \
-                   || echo "unavailable")
-
-          HOMEBREW=$(curl -sfL \
-                    https://raw.githubusercontent.com/Create-Python-App/homebrew-tap/main/Formula/create-awesome-python-app.rb | \
-                    grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unavailable")
-
-          AUR=$(curl -sfL \
-                "https://aur.archlinux.org/rpc/v5/info?arg=create-awesome-python-app" | \
-                python3 -c "import json,sys; d=json.load(sys.stdin); r=d.get('results') or []; print(r[0]['Version'].split('-')[0] if r else 'unavailable')" \
-                || echo "unavailable")
+          PYPI=$(
+            curl -sfL https://pypi.org/pypi/create-awesome-python-app/json \
+              | python3 -c "import json,sys; print(json.load(sys.stdin)['info']['version'])"
+          )
+
+          DOCKER=$(
+            docker run --rm ulisesjeremias/create-awesome-python-app:latest --version 2>&1 \
+              || echo "unavailable"
+          )
+
+          FORMULA_URL="https://raw.githubusercontent.com/Create-Python-App/homebrew-tap/main/Formula/create-awesome-python-app.rb"
+          HOMEBREW=$(
+            curl -sfL "$FORMULA_URL" \
+              | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' \
+              | head -1 \
+              || echo "unavailable"
+          )
+
+          AUR_RPC="https://aur.archlinux.org/rpc/v5/info?arg=create-awesome-python-app"
+          AUR=$(
+            curl -sfL "$AUR_RPC" \
+              | python3 -c "import json,sys; d=json.load(sys.stdin); r=d.get('results') or []; print(r[0]['Version'].split('-')[0] if r else 'unavailable')" \
+              || echo "unavailable"
+          )
 
           echo "Channel versions:"
           echo "  pypi:     $PYPI"

.markdownlint.json

@@ -2,5 +2,6 @@
   "default": true,
   "MD013": false,
   "MD033": false,
-  "MD041": false
+  "MD041": false,
+  "MD060": false
 }

.mega-linter.yml

@@ -1,5 +1,9 @@
 # MegaLinter — Python-first config for create-python-app
 # Adapted from Create-Node-App/create-node-app .mega-linter.yml
+#
+# Project standards (AGENTS.md): Ruff + Pyright. Disable overlapping
+# MegaLinter Python tools that duplicate those checks or fail without
+# the workspace venv (pylint import-error, etc.).
 
 APPLY_FIXES: all
 
@@ -12,11 +16,22 @@ DISABLE_LINTERS:
   - JSON_V8R
   - REPOSITORY_CHECKOV
   - REPOSITORY_GRYPE
-  - REPOSITORY_OSV_SCANNER # Handled later by dedicated workflow (#51)
+  - REPOSITORY_OSV_SCANNER # Handled by dedicated workflow
   - REPOSITORY_TRIVY
   - SPELL_CSPELL
   - SPELL_LYCHEE
   - YAML_V8R
+  # Overlap with Ruff / Pyright (project tooling + dedicated type-check.yml)
+  - PYTHON_PYLINT
+  - PYTHON_FLAKE8
+  - PYTHON_BLACK
+  - PYTHON_ISORT
+  - PYTHON_MYPY
+  - PYTHON_PYRIGHT
+  - PYTHON_BANDIT
+  - PYTHON_RUFF
+  # Badge / package pages can 404 briefly after first publish
+  - MARKDOWN_MARKDOWN_LINK_CHECK
 
 SHOW_ELAPSED_TIME: true
-FILTER_REGEX_EXCLUDE: (uv\.lock)
+FILTER_REGEX_EXCLUDE: (uv\.lock|megalinter-reports/)

.yamllint.yml

@@ -1,6 +1,9 @@
 extends: default
 rules:
   line-length:
-    max: 120
+    max: 180
     allow-non-breakable-inline-mappings: true
   document-start: disable
+  truthy:
+    allowed-values: ["true", "false", "on", "off"]
+    check-keys: false

Dockerfile

@@ -8,11 +8,11 @@ ARG VERSION=latest
 
 # hadolint ignore=DL3013
 RUN useradd --create-home --uid 1000 --shell /bin/bash app \
-  && if [ "$VERSION" = "latest" ]; then \
-       pip install --no-cache-dir create-awesome-python-app; \
-     else \
-       pip install --no-cache-dir "create-awesome-python-app==${VERSION}"; \
-     fi
+    && if [ "$VERSION" = "latest" ]; then \
+        pip install --no-cache-dir create-awesome-python-app; \
+    else \
+        pip install --no-cache-dir "create-awesome-python-app==${VERSION}"; \
+    fi
 
 USER app
 WORKDIR /home/app

docs/CPA_TEMPLATES_TRACKING.md

@@ -1,6 +1,8 @@
 # Tracking: `cpa-templates` + website
 
-Previously tracked by https://github.com/Create-Python-App/create-python-app/issues/44 (closed).
+Previously tracked by
+[issue #44](https://github.com/Create-Python-App/create-python-app/issues/44)
+(closed).
 
 ## Status
 
@@ -15,8 +17,8 @@ Previously tracked by https://github.com/Create-Python-App/create-python-app/iss
 
 | Repo | URL |
 |------|-----|
-| CLI monorepo | https://github.com/Create-Python-App/create-python-app |
-| Template bank | https://github.com/Create-Python-App/cpa-templates |
+| CLI monorepo | [create-python-app](https://github.com/Create-Python-App/create-python-app) |
+| Template bank | [cpa-templates](https://github.com/Create-Python-App/cpa-templates) |
 
 ## CNA parity reference
 

packages/create-awesome-python-app/src/create_awesome_python_app/catalog.py

@@ -18,9 +18,7 @@
 
 console = Console(stderr=True)
 
-DEFAULT_CATALOG_URL = (
-    "https://raw.githubusercontent.com/Create-Python-App/cpa-templates/main/templates.json"
-)
+DEFAULT_CATALOG_URL = "https://raw.githubusercontent.com/Create-Python-App/cpa-templates/main/templates.json"
 CACHE_TTL_SECONDS = 3600
 FETCH_TIMEOUT_SECONDS = 10
 USER_AGENT = f"create-awesome-python-app/{__version__} (https://github.com/Create-Python-App/create-python-app)"
@@ -111,22 +109,31 @@ def get_catalog_data(*, force_refresh: bool = False) -> dict[str, Any]:
         try:
             data = _fetch_remote(url)
             _write_disk_cache(data)
-        except (urllib.error.URLError, TimeoutError, OSError, json.JSONDecodeError) as err:
+        except (
+            urllib.error.URLError,
+            TimeoutError,
+            OSError,
+            json.JSONDecodeError,
+        ) as err:
             disk = _read_disk_cache()
             if disk is not None:
                 console.print(
-                    f"[yellow][cpa] Could not refresh catalog ({err}); using disk cache.[/yellow]"
+                    "[yellow][cpa] Could not refresh catalog "
+                    f"({err}); using disk cache.[/yellow]"
                 )
                 data = disk
             else:
                 fixture = _read_fixture()
                 if fixture.get("templates"):
                     console.print(
-                        f"[yellow][cpa] Could not refresh catalog ({err}); using fixture.[/yellow]"
+                        "[yellow][cpa] Could not refresh catalog "
+                        f"({err}); using fixture.[/yellow]"
                     )
                     data = fixture
                 else:
-                    raise RuntimeError(f"Failed to load template catalog: {err}") from err
+                    raise RuntimeError(
+                        f"Failed to load template catalog: {err}"
+                    ) from err
 
     _memory_cache = data
     _memory_ts = time.time()
@@ -173,7 +180,9 @@ def list_addons(template_slug: str | None = None) -> None:
             ext_types = [ext_types]
         if template_type and template_type not in ext_types:
             continue
-        type_label = ", ".join(ext_types) if isinstance(ext_types, list) else str(ext_types)
+        type_label = (
+            ", ".join(ext_types) if isinstance(ext_types, list) else str(ext_types)
+        )
         table.add_row(
             str(ext.get("slug", "")),
             str(ext.get("category", "")),

packages/create-awesome-python-app/src/create_awesome_python_app/cli.py

@@ -103,9 +103,7 @@ def scaffold(
     if offline:
         pass  # passed to core
 
-    want_interactive = (
-        interactive if interactive is not None else (not _in_ci())
-    )
+    want_interactive = interactive if interactive is not None else (not _in_ci())
     if want_interactive and not template:
         try:
             import questionary

packages/create-awesome-python-app/tests/test_cache_cmds.py

@@ -1,6 +1,5 @@
-from typer.testing import CliRunner
-
 from create_awesome_python_app.cli import cache_app
+from typer.testing import CliRunner
 
 runner = CliRunner()