Markdown-Checker 1.2.1__tar.gz → 1.3.0__tar.gz

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: markdown-checker
-Version: 1.2.1
+Version: 1.3.0
 Summary: A markdown link validation reporting tool.
 Author-email: John Aziz <johnaziz269@gmail.com>
 Maintainer-email: John Aziz <johnaziz269@gmail.com>
@@ -26,6 +26,7 @@ Project-URL: Documentation, https://markdown-checker.readthedocs.io/en/latest/
 Project-URL: Homepage, https://github.com/john0isaac/markdown-checker
 Project-URL: Issues, https://github.com/john0isaac/markdown-checker/issues
 Project-URL: Releases, https://github.com/john0isaac/markdown-checker/releases
+Import-Name: markdown_checker
 
 [![PyPi](https://img.shields.io/pypi/v/markdown-checker)](https://pypi.org/project/markdown-checker/)
 [![Documentation Status](https://readthedocs.org/projects/markdown-checker/badge/?version=latest)](https://markdown-checker.readthedocs.io/en/latest/?badge=latest)
@@ -77,7 +78,7 @@ exits with a non-zero status:
 🔍 Checked 42 links in 10 files.
 😭 Found 1 issues in the following files:
     File 'docs/index.md', line 5
-./missing.md is broken.
+./missing.md could not be found at /docs/missing.md.
 ```
 
 ## Using `markdown-checker` in GitHub Actions
@@ -87,7 +88,7 @@ Run this tool within a GitHub workflow using the
 GitHub Action, which posts the report as a pull request comment:
 
 ```yaml
-- uses: john0isaac/action-check-markdown@v1.2.0
+- uses: john0isaac/action-check-markdown@v1.3.0
   with:
     github-token: ${{ secrets.GITHUB_TOKEN }}
     command: check_broken_paths
@@ -96,8 +97,7 @@ GitHub Action, which posts the report as a pull request comment:
 ```
 
 See the [GitHub Actions how-to](https://markdown-checker.readthedocs.io/en/latest/howto/github-actions/)
-for the full workflow, including running `check_broken_urls` (not yet
-supported by the wrapper action) directly as a step.
+for the full workflow.
 
 ## Documentation
 

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/README.md

@@ -48,7 +48,7 @@ exits with a non-zero status:
 🔍 Checked 42 links in 10 files.
 😭 Found 1 issues in the following files:
     File 'docs/index.md', line 5
-./missing.md is broken.
+./missing.md could not be found at /docs/missing.md.
 ```
 
 ## Using `markdown-checker` in GitHub Actions
@@ -58,7 +58,7 @@ Run this tool within a GitHub workflow using the
 GitHub Action, which posts the report as a pull request comment:
 
 ```yaml
-- uses: john0isaac/action-check-markdown@v1.2.0
+- uses: john0isaac/action-check-markdown@v1.3.0
   with:
     github-token: ${{ secrets.GITHUB_TOKEN }}
     command: check_broken_paths
@@ -67,8 +67,7 @@ GitHub Action, which posts the report as a pull request comment:
 ```
 
 See the [GitHub Actions how-to](https://markdown-checker.readthedocs.io/en/latest/howto/github-actions/)
-for the full workflow, including running `check_broken_urls` (not yet
-supported by the wrapper action) directly as a step.
+for the full workflow.
 
 ## Documentation
 

markdown_checker-1.3.0/docs/api/index.rst

@@ -0,0 +1,20 @@
+API Reference
+=============
+
+If you are looking for information on a specific function, class or
+method, this part of the documentation is for you. These pages are
+generated from the docstrings in ``markdown_checker`` and are meant for
+programmatic/library use. For the command-line interface, see
+:doc:`../reference/cli` instead.
+
+.. toctree::
+   :maxdepth: 1
+
+   main
+   checker
+   cli
+   models
+   checks
+   patterns
+   reports
+   utils

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/explanation/link-detection.rst

@@ -38,16 +38,19 @@ Fragments on paths
 ----------------------
 
 A path may carry a trailing ``?query`` and/or ``#anchor`` - for example
-``docs/usage.md#configuration``. Both checks that operate on paths strip
-this fragment before resolving the file, so only the ``docs/usage.md``
-part needs to exist on disk; the anchor itself is never validated against
-the target file's headings.
+``docs/usage.md#configuration``. As in any URL, everything from the first
+``?`` or ``#`` onward is stripped before resolving the file, so only the
+``docs/usage.md`` part needs to exist on disk; the anchor itself is never
+validated against the target file's headings. The remaining path is then
+percent-decoded, so ``my%20file.md`` refers to ``my file.md``. A file name
+that really contains ``#`` or ``?`` must be written as ``%23``/``%3F``.
 
 Resolving a path to a file
 --------------------------------
 
 ``check_broken_paths`` tries to resolve a path relative to the markdown
 file it was found in first (e.g. ``../img.png`` in ``docs/usage.md``
-resolves against ``docs/``), then falls back to resolving it as an
-absolute or current-working-directory-relative path. A path is reported as
-broken only if neither resolution finds an existing file.
+resolves against ``docs/``), then relative to the current working
+directory. Root-relative paths (``/docs/usage.md``) are tried the same way
+with the leading ``/`` dropped. A path is reported as broken only if
+neither resolution finds an existing file.

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/howto/github-actions.rst

@@ -35,48 +35,19 @@ replacing ``guide-url`` with the URL of your own contribution guide:
           contents: read
         steps:
           - uses: actions/checkout@v7
-          - uses: john0isaac/action-check-markdown@v1.2.0
+          - uses: john0isaac/action-check-markdown@v1.3.0
             with:
               github-token: ${{ secrets.GITHUB_TOKEN }}
               command: check_broken_paths
               directory: ./
               guide-url: "https://github.com/<owner>/<repo>/blob/main/CONTRIBUTING.md"
 
-The ``command`` input selects which check to run. As of v1.2.0 the action
+The ``command`` input selects which check to run it
 supports ``check_broken_paths``, ``check_paths_tracking``,
-``check_urls_tracking``, and ``check_urls_locale`` - **not**
+``check_urls_tracking``, and ``check_urls_locale``
 ``check_broken_urls``. Add a separate job (or step) per command if you want
 to run more than one check in the same workflow.
 
-Run ``check_broken_urls`` directly (no wrapper action)
-------------------------------------------------------------
-
-Since the wrapper action doesn't support URL checking yet, install and
-invoke markdown-checker directly as a workflow step instead. Use
-``--report-format github-annotations`` so failures show up as inline
-annotations on the PR diff, the same way the action's output does:
-
-.. code-block:: yaml
-
-    jobs:
-      check-broken-urls:
-        runs-on: ubuntu-latest
-        permissions:
-          contents: read
-        steps:
-          - uses: actions/checkout@v7
-          - uses: actions/setup-python@v6
-            with:
-              python-version: "3.11"
-          - run: pip install markdown-checker
-          - run: >
-              markdown-checker . -f check_broken_urls
-              -rf github-annotations -o -
-
-Because ``$CI=true`` is set automatically in GitHub Actions, warnings
-(rate-limited/unverifiable links) are emitted as ``::warning`` annotations
-rather than failing the job; only broken links (an error-level issue) fail it.
-
 Verify it worked
 ------------------
 

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/howto/pyproject-config.rst

@@ -18,6 +18,7 @@ Add a ``[tool.markdown-checker]`` table to your project's
     extensions = [".md", ".ipynb"]
     skip-files = ["CODE_OF_CONDUCT.md", "SECURITY.md"]
     tracking-domains = ["github.com", "microsoft.com", "visualstudio.com", "aka.ms", "azure.com"]
+    tracking-param = ["wt.mc_id"]
     guide-url = "https://github.com/john0isaac/markdown-checker/blob/main/CONTRIBUTING.md"
     max-workers = 10
     report-format = "markdown"

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/howto/skip-links.rst

@@ -17,8 +17,9 @@ check automatically (e.g. it blocks bots) but you still want to keep the link:
 
     markdown-checker . -f check_broken_urls --skip-domains=example.com,test.com
 
-Matching is a substring match against the URL's hostname, so
-``--skip-domains=example.com`` also matches ``www.example.com``.
+A domain matches the URL's hostname exactly or as a parent domain, so
+``--skip-domains=example.com`` also matches ``www.example.com`` (but not
+``notexample.com``).
 
 Skip URLs containing a substring
 ------------------------------------
@@ -35,7 +36,7 @@ List syntax
 -----------
 
 Every list option (``--skip-domains``, ``--skip-urls-containing``,
-``--extensions``, ``--skip-files``, ``--tracking-domains``) takes a single
+``--extensions``, ``--skip-files``, ``--tracking-domains``, ``--tracking-param``) takes a single
 comma-separated value:
 
 - Correct: ``--skip-domains=example.com,test.com``

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/index.rst

@@ -71,9 +71,8 @@ method, this part of the documentation is for you.
 .. toctree::
    :maxdepth: 2
    :caption: API Reference
-   :glob:
 
-   api/*
+   api/index
 
 Additional Notes
 ----------------

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/reference/checks.rst

@@ -26,7 +26,7 @@ Sample finding
     .. code-block:: text
 
         File 'docs/index.md', line 5
-        ./missing.md is broken.
+        ./missing.md could not be found at /docs/missing.md.
 
 ``check_broken_urls``
 ------------------------
@@ -55,8 +55,10 @@ Sample finding
 
 Flags
     URLs whose path contains a locale segment, e.g. ``/en-us/`` in
-    ``https://example.com/en-us/docs``. A "locale segment" is a
-    language-country pair matching ``xx-xx`` (case-insensitive).
+    ``https://example.com/en-us/docs`` or a trailing ``/en-us``. A "locale
+    segment" is a known language-country pair of the form ``xx-xx``
+    (case-insensitive), so look-alikes such as ``/ci-cd/`` aren't flagged.
+    The host, query string and anchor are not searched.
 Ignores
     ``www.nvidia.com`` (built in - its docs always include a locale
     segment), plus any host in ``--skip-domains`` or URL in
@@ -73,8 +75,8 @@ Sample finding
 --------------------------
 
 Flags
-    URLs on a configured tracking domain that are missing a ``wt.mc_id``
-    query parameter.
+    URLs on a configured tracking domain that are missing every
+    ``--tracking-param`` query parameter (``wt.mc_id`` by default).
 Ignores
     URLs on hosts *not* listed in ``--tracking-domains`` (the check does
     nothing for them), plus any host in ``--skip-domains`` or URL in
@@ -83,7 +85,8 @@ Default tracking domains
     ``github.com``, ``microsoft.com``, ``visualstudio.com``, ``aka.ms``,
     ``azure.com``.
 Options that affect it
-    ``--tracking-domains``, ``--skip-domains``, ``--skip-urls-containing``.
+    ``--tracking-domains``, ``--tracking-param``, ``--skip-domains``,
+    ``--skip-urls-containing``.
 Sample finding
     .. code-block:: text
 
@@ -94,10 +97,12 @@ Sample finding
 ---------------------------
 
 Flags
-    Every relative path link missing a ``wt.mc_id`` query parameter. Unlike
-    ``check_urls_tracking``, there is no domain filter - all paths are checked.
+    Every relative path link missing every ``--tracking-param`` query
+    parameter (``wt.mc_id`` by default). Unlike ``check_urls_tracking``,
+    there is no domain filter - all paths are checked.
 Options that affect it
-    ``SRC``/``--dir``, ``--extensions``, ``--skip-files`` only.
+    ``SRC``/``--dir``, ``--extensions``, ``--skip-files``,
+    ``--tracking-param``.
 Sample finding
     .. code-block:: text
 

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/reference/cli.rst

@@ -78,14 +78,33 @@ Type
 Default
   ``github.com,microsoft.com,visualstudio.com,aka.ms,azure.com``.
 Constraints
-  Only affects ``check_urls_tracking``.
+  Only affects ``check_urls_tracking``. Subdomains are included, e.g.
+  ``microsoft.com`` also matches ``learn.microsoft.com``.
 Description
-  Hostnames that must carry a ``wt.mc_id`` tracking parameter.
+  Hostnames that must carry a tracking parameter (see ``--tracking-param``).
 
 .. code-block:: bash
 
     markdown-checker . -f check_urls_tracking --tracking-domains=github.com,microsoft.com
 
+``-tp``, ``--tracking-param``
+---------------------------------
+
+Type
+  ``list[str]``, comma-separated.
+Default
+  ``wt.mc_id``.
+Constraints
+  Only affects ``check_urls_tracking`` and ``check_paths_tracking``.
+  Matched case-insensitively as a query parameter (after ``?`` or ``&``).
+Description
+  Tracking query parameters a link must carry. A link passes if it has any
+  one of them.
+
+.. code-block:: bash
+
+    markdown-checker . -f check_urls_tracking --tracking-param=wt.mc_id,utm_source
+
 ``-sf``, ``--skip-files``
 -----------------------------
 
@@ -110,8 +129,9 @@ Type
 Default
   ``[]`` (none).
 Constraints
-  Only affects ``check_broken_urls`` and ``check_urls_locale``. Substring
-  match against the URL's hostname.
+  Only affects ``check_broken_urls`` and ``check_urls_locale``. Matches the
+  URL's hostname exactly or as a parent domain (``example.com`` matches
+  ``www.example.com`` but not ``notexample.com``).
 Description
   Domains to exclude from URL checks.
 

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/reference/configuration.rst

@@ -47,6 +47,9 @@ Keys
    * - ``tracking-domains``
      - ``--tracking-domains``
      - array of strings
+   * - ``tracking-param``
+     - ``--tracking-param``
+     - array of strings
    * - ``skip-files``
      - ``--skip-files``
      - array of strings
@@ -96,6 +99,7 @@ Example
     skip-files = ["CODE_OF_CONDUCT.md", "SECURITY.md"]
     skip-domains = []
     tracking-domains = ["github.com", "microsoft.com", "visualstudio.com", "aka.ms", "azure.com"]
+    tracking-param = ["wt.mc_id"]
     guide-url = "https://github.com/john0isaac/markdown-checker/blob/main/CONTRIBUTING.md"
     timeout = 20
     retries = 3

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/reference/report-formats.rst

@@ -46,7 +46,7 @@ A structured document including both errors and warnings:
 .. code-block:: json
 
     {
-      "tool": {"name": "markdown-checker", "version": "1.2.1"},
+      "tool": {"name": "markdown-checker", "version": "1.3.0"},
       "check": "check_broken_urls",
       "summary": {
         "files_checked": 10,

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/docs/tutorial.rst

@@ -63,7 +63,7 @@ You'll see output similar to:
     🔍 Checked 2 links in 2 files.
     😭 Found 1 issues in the following files:
         File 'docs-sample/index.md', line 5
-    ./missing.md is broken.
+    ./missing.md could not be found at /docs/missing.md.
 
 Because an error-level issue was found, markdown-checker also writes a
 ``comment.md`` file in the current directory with the same information as a

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/pyproject.toml

@@ -67,7 +67,7 @@ typing = [
 ]
 
 [build-system]
-requires = ["flit_core<4"]
+requires = ["flit_core<5"]
 build-backend = "flit_core.buildapi"
 
 [project.scripts]

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/src/markdown_checker/__init__.py

@@ -2,7 +2,7 @@
 markdown-checker - a markdown link validation reporting tool.
 """
 
-__version__ = "1.2.1"
+__version__ = "1.3.0"
 
 from markdown_checker.cli import main
 from markdown_checker.models import Config

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/src/markdown_checker/checks/broken_paths.py

@@ -28,6 +28,7 @@ class BrokenPathsCheck(BaseCheck[MarkdownPath]):
         detected_issues: list[MarkdownPath] = []
         for path in links.paths:
             if not path.exists():
-                path.issue = "is broken"
+                path.resolved_path = path.get_full_path()
+                path.issue = f"could not be found at {path.resolved_path.as_posix()}"
                 detected_issues.append(path)
         return detected_issues

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/src/markdown_checker/checks/broken_urls.py

@@ -58,7 +58,7 @@ class BrokenURLsCheck(BaseCheck[MarkdownURL]):
         :meth:`collect` to resolve later.
         """
         config = config or Config()
-        effective_skip = [domain.lower() for domain in [*config.skip_domains, *_BUILTIN_SKIP_DOMAINS]]
+        effective_skip = [*config.skip_domains, *_BUILTIN_SKIP_DOMAINS]
         skip_urls_containing = config.skip_urls_containing
 
         # Standalone fallback (direct calls, tests): own a private service for this run only.
@@ -67,10 +67,7 @@ class BrokenURLsCheck(BaseCheck[MarkdownURL]):
 
         pending: list[tuple[MarkdownURL, Future[URLCheckResult]]] = []
         for url in links.urls:
-            hostname = url.host_name().lower()
-            if any(domain in hostname for domain in effective_skip) or any(
-                substring in url.link for substring in skip_urls_containing
-            ):
+            if url.matches_domain(effective_skip) or any(substring in url.link for substring in skip_urls_containing):
                 continue
             pending.append((url, _service.submit(url)))
         return (pending, _service if owns_service else None)

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/src/markdown_checker/checks/locale.py

@@ -40,10 +40,7 @@ class URLsLocaleCheck(BaseCheck[MarkdownURL]):
 
         detected_issues: list[MarkdownURL] = []
         for url in links.urls:
-            hostname = url.host_name().lower()
-            if any(domain.lower() in hostname for domain in effective_skip) or any(
-                substring in url.link for substring in skip_urls_containing
-            ):
+            if url.matches_domain(effective_skip) or any(substring in url.link for substring in skip_urls_containing):
                 continue
             if url.has_locale():
                 url.issue = "has locale"

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/src/markdown_checker/checks/tracking.py

@@ -1,4 +1,4 @@
-"""The ``check_urls_tracking``/``check_paths_tracking`` checks: flag links missing a ``wt.mc_id`` tracking ID."""
+"""The ``check_urls_tracking``/``check_paths_tracking`` checks: flag links missing a tracking ID."""
 
 from markdown_checker.checks.base import BaseCheck
 from markdown_checker.models import Config
@@ -21,8 +21,9 @@ class URLsTrackingCheck(BaseCheck[MarkdownURL]):
         service: URLCheckService | None = None,
     ) -> list[MarkdownURL]:
         """Flag every URL in ``links.urls`` whose host matches
-        ``config.tracking_domains`` but is missing a ``wt.mc_id`` query
-        parameter (see :meth:`MarkdownLinkBase.has_tracking
+        ``config.tracking_domains`` but is missing all of the
+        ``config.tracking_param`` query parameters (see
+        :meth:`MarkdownLinkBase.has_tracking
         <markdown_checker.models.base.MarkdownLinkBase.has_tracking>`). URLs
         on other hosts, or matching ``config.skip_domains``/
         ``skip_urls_containing``, are ignored. Sets
@@ -36,12 +37,9 @@ class URLsTrackingCheck(BaseCheck[MarkdownURL]):
 
         detected_issues: list[MarkdownURL] = []
         for url in links.urls:
-            hostname = url.host_name().lower()
-            if any(domain.lower() in hostname for domain in skip_domains) or any(
-                substring in url.link for substring in skip_urls_containing
-            ):
+            if url.matches_domain(skip_domains) or any(substring in url.link for substring in skip_urls_containing):
                 continue
-            if any(domain.lower() in hostname for domain in tracking_domains) and not url.has_tracking():
+            if url.matches_domain(tracking_domains) and not url.has_tracking(config.tracking_param):
                 url.issue = "is missing tracking id"
                 detected_issues.append(url)
         return detected_issues
@@ -59,16 +57,18 @@ class PathsTrackingCheck(BaseCheck[MarkdownPath]):
         config: Config | None = None,
         service: URLCheckService | None = None,
     ) -> list[MarkdownPath]:
-        """Flag every path in ``links.paths`` missing a ``wt.mc_id`` query
-        parameter (see :meth:`MarkdownLinkBase.has_tracking
+        """Flag every path in ``links.paths`` missing all of the
+        ``config.tracking_param`` query parameters (see
+        :meth:`MarkdownLinkBase.has_tracking
         <markdown_checker.models.base.MarkdownLinkBase.has_tracking>`),
         setting ``issue="is missing tracking id"`` (error-level) on each.
         Unlike ``check_urls_tracking``, there is no domain filter: every
-        path is checked. ``config`` and ``service`` are unused.
+        path is checked. ``service`` is unused.
         """
+        config = config or Config()
         detected_issues: list[MarkdownPath] = []
         for path in links.paths:
-            if not path.has_tracking():
+            if not path.has_tracking(config.tracking_param):
                 path.issue = "is missing tracking id"
                 detected_issues.append(path)
         return detected_issues

{markdown_checker-1.2.1 → markdown_checker-1.3.0}/src/markdown_checker/cli.py

@@ -2,6 +2,7 @@
 
 import os
 import platform
+import sys
 from pathlib import Path
 from typing import Any
 
@@ -10,6 +11,7 @@ import click
 from markdown_checker import __version__
 from markdown_checker.checker import run_check_on_files
 from markdown_checker.models.config import Config
+from markdown_checker.patterns import DEFAULT_TRACKING_PARAMS
 from markdown_checker.reports import build_report
 from markdown_checker.reports import get_renderer
 from markdown_checker.reports import RENDERERS
@@ -38,6 +40,23 @@ class PyprojectCommand(click.Command):
         return super().make_context(info_name, args, parent, **extra)
 
 
+def _echo_safe(message: str, *, fg: str | None = None, err: bool = False) -> None:
+    """Echo a (optionally styled) message, dropping characters the output stream can't encode.
+
+    On Windows, piping stdout/stderr to another process (e.g. ``| grep``) can make Python
+    fall back to a legacy code page (e.g. cp1252) that can't represent emoji. Retry without
+    those characters instead of crashing the whole command.
+    """
+    styled = click.style(message, fg=fg) if fg else message
+    try:
+        click.echo(styled, err=err)
+    except UnicodeEncodeError:
+        stream = sys.stderr if err else sys.stdout
+        encoding = getattr(stream, "encoding", None) or "ascii"
+        safe_message = styled.encode(encoding, errors="ignore").decode(encoding)
+        click.echo(safe_message, err=err)
+
+
 class ListOfStrings(click.Option):
     """
     Helper class to parse a comma-separated list of strings from the command line.
@@ -105,6 +124,15 @@ class ListOfStrings(click.Option):
     help="List of tracking domains to check.",
     required=False,
 )
+@click.option(
+    "-tp",
+    "--tracking-param",
+    cls=ListOfStrings,
+    type=list[str],
+    default=list(DEFAULT_TRACKING_PARAMS),
+    help="List of tracking query parameters; a link passes if it has any of them.",
+    required=False,
+)
 @click.option(
     "-sf",
     "--skip-files",
@@ -240,6 +268,7 @@ def main(
     skip_domains: list[str],
     skip_urls_containing: list[str],
     tracking_domains: list[str],
+    tracking_param: list[str],
     timeout: int,
     retries: int,
     retry_on_429: bool,
@@ -291,6 +320,7 @@ def main(
         skip_domains=skip_domains,
         skip_urls_containing=skip_urls_containing,
         tracking_domains=tracking_domains,
+        tracking_param=tracking_param,
         timeout=timeout,
         retries=retries,
         retry_on_429=retry_on_429,
@@ -309,9 +339,9 @@ def main(
             progress_callback=lambda: bar.update(1),
         )
 
-    click.echo(
-        click.style(f"\n🔍 Checked {check_result.links_checked} links in {len(files_paths)} files.", fg="blue"),
-        err=False,
+    _echo_safe(
+        f"\n🔍 Checked {check_result.links_checked} links in {len(files_paths)} files.",
+        fg="blue",
     )
 
     if check_result.issues:
@@ -328,13 +358,10 @@ def main(
             renderer = get_renderer(report_format)
             out_path = None if output_file_name == "-" else Path(f"{output_file_name}{renderer.file_extension}")
             write_report(renderer.render(report), output_path=out_path)
-            click.echo(click.style(f"😭 Found {report.error_count} issues in the following files:", fg="red"), err=True)
+            _echo_safe(f"😭 Found {report.error_count} issues in the following files:", fg="red", err=True)
 
         if report.has_warnings:
-            click.echo(
-                click.style(f"⚠ {report.warning_count} links had warnings:", fg="yellow"),
-                err=True,
-            )
+            _echo_safe(f"⚠ {report.warning_count} links had warnings:", fg="yellow", err=True)
 
         terminal_renderer = GitHubAnnotationsRenderer() if config.output_mode == "ci" else ConsoleRenderer()
         for message, level in terminal_renderer.render_lines(report):
@@ -342,5 +369,5 @@ def main(
 
         ctx.exit(1 if report.has_errors else 0)
 
-    click.echo(click.style("All files are compliant with the guidelines. 🎉", fg="green"), err=False)
+    _echo_safe("All files are compliant with the guidelines. 🎉", fg="green")
     ctx.exit(0)