fix: add documentation links to remote build and esm base errors

Signed-off-by: Callahan Kovacs <callahan.kovacs@canonical.com>

snapcraft/application.py

@@ -82,6 +82,7 @@ def _get_esm_error_for_base(base: str) -> None:
  f"Use Snapcraft {version} from the {channel!r} channel of snapcraft where "
  f"{base!r} was last supported."
  ),
+ doc_slug="/reference/bases",
  )
 
 
@@ -395,6 +396,7 @@ def _ensure_remote_build_supported(base: str) -> None:
  resolution=(
  "Valid values are 'disable-fallback' and 'force-fallback'."
  ),
+ doc_slug="/explanation/remote-build",
  )
 
  # 2. core20 projects must use the legacy remote builder (#4885)
@@ -407,6 +409,7 @@ def _ensure_remote_build_supported(base: str) -> None:
  resolution=(
  "Unset the environment variable or set it to 'force-fallback'."
  ),
+ doc_slug="/explanation/remote-build",
  )
 
  # 3. core24 and newer projects must use the craft-application remote builder
@@ -419,6 +422,7 @@ def _ensure_remote_build_supported(base: str) -> None:
  resolution=(
  "Unset the environment variable or set it to 'disable-fallback'."
  ),
+ doc_slug="/explanation/remote-build",
  )
 
  @override

tests/unit/test_application.py

@@ -400,7 +400,13 @@ def test_esm_error(snapcraft_yaml, base, monkeypatch, capsys):
  application.main()
 
  _, err = capsys.readouterr()
- assert f"Base {base!r} is not supported by this version of Snapcraft" in err
+
+ assert re.match(
+ rf"^Base {base!r} is not supported by this version of Snapcraft.\n"
+ rf"Recommended resolution: Use Snapcraft .* from the '.*' channel of snapcraft where {base!r} was last supported.\n"
+ r"For more information, check out: .*/reference/bases\n",
+ err,
+ )
 
 
 @pytest.mark.parametrize("base", const.CURRENT_BASES)
@@ -461,10 +467,12 @@ def test_run_remote_build_core24_error(monkeypatch, snapcraft_yaml, base, capsys
  application.main()
 
  _, err = capsys.readouterr()
- assert (
- "'SNAPCRAFT_REMOTE_BUILD_STRATEGY=force-fallback' cannot be used "
- "for core24 and newer snaps"
- ) in err
+ assert re.match(
+ r"^'SNAPCRAFT_REMOTE_BUILD_STRATEGY=force-fallback' cannot be used for core24 and newer snaps\.\n"
+ r"Recommended resolution: Unset the environment variable or set it to 'disable-fallback'\.\n"
+ r"For more information, check out: .*/explanation/remote-build",
+ err,
+ )
 
 
 @pytest.mark.parametrize("base", const.LEGACY_BASES)
@@ -479,9 +487,11 @@ def test_run_envvar_disable_fallback_core20(snapcraft_yaml, base, monkeypatch, c
  application.main()
 
  _, err = capsys.readouterr()
- assert (
- f"'SNAPCRAFT_REMOTE_BUILD_STRATEGY=disable-fallback' cannot be used for {base} snaps"
- in err
+ assert re.match(
+ r"'SNAPCRAFT_REMOTE_BUILD_STRATEGY=disable-fallback' cannot be used for core20 snaps\.\n"
+ r"Recommended resolution: Unset the environment variable or set it to 'force-fallback'\.\n"
+ r"For more information, check out: .*/explanation/remote-build",
+ err,
  )
 
 
@@ -546,9 +556,11 @@ def test_run_envvar_invalid(snapcraft_yaml, base, monkeypatch, capsys):
  application.main()
 
  _, err = capsys.readouterr()
- assert (
- "Unknown value 'badvalue' in environment variable 'SNAPCRAFT_REMOTE_BUILD_STRATEGY'"
- in err
+ assert re.match(
+ r"Unknown value 'badvalue' in environment variable 'SNAPCRAFT_REMOTE_BUILD_STRATEGY'\.\n"
+ r"Recommended resolution: Valid values are 'disable-fallback' and 'force-fallback'\.\n"
+ r"For more information, check out: .*/explanation/remote-build",
+ err,
  )