fix(rst): Escape asterisks in glob patterns to prevent emphasis warnings

Glob patterns like "django-*" in argparse help text trigger RST
"Inline emphasis start-string without end-string" warnings. Add
escape_rst_emphasis() utility that escapes problematic asterisks
(e.g., "django-*" → "django-\*") and apply it in the renderer's
_parse_text() method.

Author: tony

docs/_ext/sphinx_argparse_neo/renderer.py

@@ -26,6 +26,7 @@
     ParserInfo,
     SubcommandInfo,
 )
+from sphinx_argparse_neo.utils import escape_rst_emphasis
 
 if t.TYPE_CHECKING:
     from docutils.parsers.rst.states import RSTState
@@ -481,6 +482,9 @@ def _parse_text(self, text: str) -> list[nodes.Node]:
         if not text:
             return []
 
+        # Escape RST emphasis patterns before parsing (e.g., "django-*" -> "django-\*")
+        text = escape_rst_emphasis(text)
+
         if self.state is None:
             # No state machine available, return as paragraph
             para = nodes.paragraph(text=text)

docs/_ext/sphinx_argparse_neo/utils.py

@@ -39,3 +39,40 @@ def strip_ansi(text: str) -> str:
     'bold blue'
     """
     return _ANSI_RE.sub("", text)
+
+
+# RST emphasis pattern: matches -* that would trigger inline emphasis errors.
+# Pattern matches: non-whitespace/non-backslash char, followed by -*, NOT followed by
+# another * (which would be strong emphasis **).
+_RST_EMPHASIS_RE = re.compile(r"(?<=[^\s\\])-\*(?!\*)")
+
+
+def escape_rst_emphasis(text: str) -> str:
+    r"""Escape asterisks that would trigger RST inline emphasis.
+
+    RST interprets ``*text*`` as emphasis. When argparse help text contains
+    glob patterns like ``django-*``, the ``-*`` sequence triggers RST
+    "Inline emphasis start-string without end-string" warnings.
+
+    This function escapes such asterisks to prevent RST parsing errors.
+
+    Parameters
+    ----------
+    text : str
+        Text potentially containing problematic asterisks.
+
+    Returns
+    -------
+    str
+        Text with asterisks escaped where needed.
+
+    Examples
+    --------
+    >>> escape_rst_emphasis('tmuxp load "my-*"')
+    'tmuxp load "my-\\*"'
+    >>> escape_rst_emphasis("plain text")
+    'plain text'
+    >>> escape_rst_emphasis("*emphasis* is ok")
+    '*emphasis* is ok'
+    """
+    return _RST_EMPHASIS_RE.sub(r"-\*", text)

tests/docs/_ext/sphinx_argparse_neo/test_utils.py

@@ -5,7 +5,7 @@
 import typing as t
 
 import pytest
-from sphinx_argparse_neo.utils import strip_ansi
+from sphinx_argparse_neo.utils import escape_rst_emphasis, strip_ansi
 
 # --- strip_ansi tests ---
 
@@ -70,3 +70,93 @@ class StripAnsiFixture(t.NamedTuple):
 def test_strip_ansi(test_id: str, input_text: str, expected: str) -> None:
     """Test ANSI escape code stripping."""
     assert strip_ansi(input_text) == expected
+
+
+# --- escape_rst_emphasis tests ---
+
+
+class EscapeRstEmphasisFixture(t.NamedTuple):
+    """Test fixture for escape_rst_emphasis function."""
+
+    test_id: str
+    input_text: str
+    expected: str
+
+
+ESCAPE_RST_EMPHASIS_FIXTURES: list[EscapeRstEmphasisFixture] = [
+    EscapeRstEmphasisFixture(
+        test_id="glob_pattern_quoted",
+        input_text='tmuxp load "my-*"',
+        expected='tmuxp load "my-\\*"',
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="glob_pattern_django",
+        input_text="django-*",
+        expected="django-\\*",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="glob_pattern_flask",
+        input_text="flask-*",
+        expected="flask-\\*",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="multiple_patterns",
+        input_text="match django-* or flask-* packages",
+        expected="match django-\\* or flask-\\* packages",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="plain_text",
+        input_text="plain text without patterns",
+        expected="plain text without patterns",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="rst_emphasis_unchanged",
+        input_text="*emphasis* is ok",
+        expected="*emphasis* is ok",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="already_escaped",
+        input_text="django-\\*",
+        expected="django-\\*",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="empty_string",
+        input_text="",
+        expected="",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="pattern_at_end",
+        input_text="ending with pattern-*",
+        expected="ending with pattern-\\*",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="hyphen_without_asterisk",
+        input_text="word-with-hyphens",
+        expected="word-with-hyphens",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="asterisk_without_hyphen",
+        input_text="asterisk * alone",
+        expected="asterisk * alone",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="double_asterisk",
+        input_text="glob-** pattern",
+        expected="glob-** pattern",
+    ),
+    EscapeRstEmphasisFixture(
+        test_id="space_after_asterisk",
+        input_text="word-* followed by space",
+        expected="word-\\* followed by space",
+    ),
+]
+
+
+@pytest.mark.parametrize(
+    EscapeRstEmphasisFixture._fields,
+    ESCAPE_RST_EMPHASIS_FIXTURES,
+    ids=[f.test_id for f in ESCAPE_RST_EMPHASIS_FIXTURES],
+)
+def test_escape_rst_emphasis(test_id: str, input_text: str, expected: str) -> None:
+    """Test RST emphasis escaping for glob patterns."""
+    assert escape_rst_emphasis(input_text) == expected