DOCSP-4705: emit <reference> uriref and uriname attributes

Author: i80and

snooty/gizaparser/test_steps.py

@@ -44,9 +44,12 @@ def create_page() -> Tuple[Page, EmbeddedRstParser]:
     assert ast_to_testing_string(pages[0].ast) == ''.join((
         '<directive name="steps"><directive name="step"><section><heading><text>Import the public ',
         'key used by the package management system.</text></heading><paragraph><text>Issue the ',
-        'following command to import the\n</text><reference><text>MongoDB public GPG Key</text>',
-        '</reference><target ids="[\'mongodb-public-gpg-key\']"></target></paragraph></section>',
-        '</directive>',
+        'following command to import the\n</text><reference ',
+        'refuri="https://www.mongodb.org/static/pgp/server-3.4.asc">',
+        '<text>MongoDB public GPG Key</text>',
+        '</reference><target ids="[\'mongodb-public-gpg-key\']" ',
+        'refuri="https://www.mongodb.org/static/pgp/server-3.4.asc">',
+        '</target></paragraph></section></directive>',
 
         '<directive name="step"><section><heading><text>Create a </text><literal><text>',
         '/etc/apt/sources.list.d/mongodb-org-3.4.list</text></literal><text> file for MongoDB.',

snooty/parser.py

@@ -94,6 +94,8 @@ def dispatch_visit(self, node: docutils.nodes.Node) -> None:
         elif node_name == 'target':
             doc['type'] = 'target'
             doc['ids'] = node['ids']
+            if 'refuri' in node:
+                doc['refuri'] = node['refuri']
         elif node_name == 'definition_list':
             doc['type'] = 'definitionList'
         elif node_name == 'definition_list_item':
@@ -109,6 +111,10 @@ def dispatch_visit(self, node: docutils.nodes.Node) -> None:
             doc['type'] = 'listItem'
         elif node_name == 'title':
             doc['type'] = 'heading'
+        elif node_name == 'reference':
+            for attr_name in ('refuri', 'refname'):
+                if attr_name in node:
+                    doc[attr_name] = node[attr_name]
 
         doc['children'] = []
 

stubs/docutils/nodes.pyi

@@ -21,6 +21,7 @@ class Node:
 
     def __getitem__(self, key: Union[int, str]) -> Any: ...
     def __setitem__(self, key: str, value: Any) -> None: ...
+    def __contains__(self, key: str) -> bool: ...
 
 
 class Root: ...