DOP-1806: Abbreviate labels

Author: i80and

snooty/postprocess.py

@@ -681,6 +681,17 @@ def handle_refs(self, fileid_stack: FileIdStack, node: n.Node) -> None:
             )
             for title_node in cloned_title_nodes:
                 deep_copy_position(node, title_node)
+
+            # Label abbreviation is underspecified. Good luck!
+            if "~" in node.flag and cloned_title_nodes:
+                node_to_abbreviate = cloned_title_nodes[0]
+                if isinstance(node_to_abbreviate, n.Text):
+                    index = node_to_abbreviate.value.rfind(".")
+                    new_value = node_to_abbreviate.value[index + 1 :].strip()
+
+                    if new_value:
+                        node_to_abbreviate.value = new_value
+
             injection_candidate.children = cloned_title_nodes
 
     def attempt_disambugation(

snooty/test_postprocess.py

@@ -253,6 +253,43 @@ def test_same_page_target_resolution() -> None:
         )
 
 
+def test_abbreviated_link() -> None:
+    with make_test(
+        {
+            Path(
+                "source/index.txt"
+            ): """
+.. method:: db.collection.watch()
+
+:method:`~db.collection.watch`
+""",
+        }
+    ) as result:
+        assert not [
+            diagnostics for diagnostics in result.diagnostics.values() if diagnostics
+        ], "Should not raise any diagnostics"
+
+        page = result.pages[FileId("index.txt")]
+        print(ast_to_testing_string(page.ast))
+        check_ast_testing_string(
+            page.ast,
+            """
+<root fileid="index.txt">
+    <target domain="mongodb" name="method" html_id="mongodb-method-db.collection.watch">
+        <directive_argument><literal><text>db.collection.watch()</text></literal></directive_argument>
+        <target_identifier ids="['db.collection.watch']"><text>db.collection.watch()</text></target_identifier>
+    </target>
+
+    <paragraph>
+        <ref_role domain="mongodb" name="method" target="db.collection.watch" flag="~" fileid="['index', 'mongodb-method-db.collection.watch']">
+            <literal><text>watch()</text></literal>
+        </ref_role>
+    </paragraph>
+</root>
+        """,
+        )
+
+
 def test_language_selector() -> None:
     with make_test(
         {