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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-checker
-Version: 1.2.1
+Version: 1.2.2
 Summary: A markdown link validation reporting tool.
 Author-email: John Aziz <johnaziz269@gmail.com>
 Maintainer-email: John Aziz <johnaziz269@gmail.com>
@@ -87,7 +87,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 +96,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.2.2}/README.md

@@ -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.2.2/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.2.2}/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.2.2}/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.2.2}/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.2.2"},
       "check": "check_broken_urls",
       "summary": {
         "files_checked": 10,

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

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

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

@@ -2,6 +2,7 @@
 
 import os
 import platform
+import sys
 from pathlib import Path
 from typing import Any
 
@@ -38,6 +39,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.
@@ -309,9 +327,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 +346,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 +357,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)

{markdown_checker-1.2.1 → markdown_checker-1.2.2}/tests/reports/conftest.py

@@ -32,5 +32,5 @@ def sample_report():
             ),
         ),
     )
-    context = ReportContext(check_name="check_broken_urls", tool_version="1.2.1")
+    context = ReportContext(check_name="check_broken_urls", tool_version="1.2.2")
     return Report(context=context, files=(file_report,), links_checked=2, files_checked=1)

{markdown_checker-1.2.1 → markdown_checker-1.2.2}/tests/reports/renderers/test_json.py

@@ -16,7 +16,7 @@ def test_json_renderer_produces_valid_json(sample_report):
 def test_json_renderer_includes_tool_version(sample_report):
     """JsonRenderer includes tool metadata from the report context."""
     data = json.loads(JsonRenderer().render(sample_report))
-    assert data["tool"]["version"] == "1.2.1"
+    assert data["tool"]["version"] == "1.2.2"
 
 
 def test_json_renderer_respects_custom_indent(sample_report):

{markdown_checker-1.2.1 → markdown_checker-1.2.2}/tests/test_cli.py

@@ -138,7 +138,7 @@ def test_cli_version(runner):
     """Displays version information."""
     result = runner.invoke(main, ["--version"])
     assert result.exit_code == 0
-    assert "1.2.1" in result.output
+    assert "1.2.2" in result.output
 
 
 def test_cli_ci_mode(runner, resources_dir, monkeypatch, tmp_path):