Add tilde modifier support for :py:deco: role

Author: SilverRainZ

CHANGES.rst

@@ -20,6 +20,8 @@ Features added
   ``linkcheck_allowed_redirects = {}``.
   Patch by Adam Turner.
 * #13497: Support C domain objects in the table of contents.
+* #13528: Add tilde modifier support for :rst:role:`:py:deco:`
+  Patch by Shengyu Zhang.
 
 Bugs fixed
 ----------

sphinx/domains/python/__init__.py

@@ -603,14 +603,24 @@ def __init__(
         warn_dangling: bool = False,
     ) -> None:
         super().__init__(
-            fix_parens=True,
+            fix_parens=fix_parens,
             lowercase=lowercase,
             nodeclass=nodeclass,
             innernodeclass=innernodeclass,
             warn_dangling=warn_dangling,
         )
 
-    def update_title_and_target(self, title: str, target: str) -> tuple[str, str]:
+    def process_link(
+        self,
+        env: BuildEnvironment,
+        refnode: Element,
+        has_explicit_title: bool,
+        title: str,
+        target: str,
+    ) -> tuple[str, str]:
+        title, target = super().process_link(
+            env, refnode, has_explicit_title, title, target
+        )
         return f'@{title}', target
 
 

tests/test_domains/test_domain_py.py

@@ -1791,3 +1791,21 @@ def test_pep_695_and_pep_696_whitespaces_in_default(app, tp_list, tptext):
     text = f'.. py:function:: f{tp_list}() -> Annotated[T, Qux[int]()]'
     doctree = restructuredtext.parse(app, text)
     assert doctree.astext() == f'\n\nf{tptext}() -> Annotated[T, Qux[int]()]\n\n'
+
+
+def test_deco_role(app):
+    text = """:py:deco:`foo.bar`
+    .. py:decorator:: foo.bar
+       :no-contents-entry:
+       :no-index-entry:
+       :no-typesetting:"""
+    doctree = restructuredtext.parse(app, text)
+    assert doctree.astext() == f'@bar\n\n\n\n'
+
+    text = """:py:deco:`~foo.bar`
+    .. py:decorator:: foo.bar
+       :no-contents-entry:
+       :no-index-entry:
+       :no-typesetting:"""
+    doctree = restructuredtext.parse(app, text)
+    assert doctree.astext() == f'@bar\n\n\n\n'