Added sphinx sphinx-autodoc-typehints

doc/developer_guide/conf.py

@@ -43,6 +43,7 @@
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest',
               'sphinx.ext.intersphinx', 'sphinx.ext.coverage',
               'sphinx.ext.imgmath', 'sphinx.ext.viewcode',
+              'sphinx_autodoc_typehints',
               'sphinxcontrib.bibtex', 'apilinks']
 bibtex_bibfiles = ['../bibliography/references.bib']
 

doc/psyad/user_guide/conf.py

@@ -36,6 +36,7 @@
 # ones. The definition of 'apilinks' is in PSyclone/doc/_ext/apilinks.py.
 extensions = [
     'sphinx.ext.imgmath', 'sphinx.ext.autodoc', 'sphinx.ext.intersphinx',
+    'sphinx_autodoc_typehints',
     'apilinks']
 
 

doc/reference_guide/source/conf.py

@@ -62,6 +62,7 @@
     'sphinx.ext.githubpages',
     'sphinx.ext.autodoc',
     'sphinx.ext.inheritance_diagram',
+    'sphinx_autodoc_typehints',
     'autoapi.sphinx'
 ]
 

doc/user_guide/conf.py

@@ -40,6 +40,7 @@
               'sphinx.ext.intersphinx', 'sphinx.ext.coverage',
               'sphinx.ext.imgmath', 'sphinx.ext.viewcode',
               'sphinxcontrib.bibtex', 'sphinx_tabs.tabs',
+              'sphinx_autodoc_typehints',
               'apilinks',
               ]
 bibtex_bibfiles = ['../bibliography/references.bib']

setup.py

@@ -166,7 +166,7 @@ def get_files(directory, install_path, valid_suffixes):
                           'graphviz'],
         extras_require={
             'doc': ["sphinx", "sphinxcontrib.bibtex", "sphinx-tabs",
-                    "sphinx_rtd_theme", "autoapi"],
+                    "sphinx_rtd_theme", "sphinx-autodoc-typehints", "autoapi"],
             'test': ["flake8", "pylint", "pytest-cov", "pytest-xdist"],
         },
         include_package_data=True,

src/psyclone/psyir/nodes/call.py

@@ -245,18 +245,16 @@ def insert_named_arg(self, name, arg, index):
         # because the 1st child is the routine reference
         self.children.insert(index + 1, arg)
 
-    def replace_named_arg(self, existing_name, arg):
+    def replace_named_arg(self, existing_name: str, arg: DataNode):
         '''Replace one named argument node with another node keeping the
         same name.
 
-           :param str existing_name: the argument name.
-           :param arg: the argument expression.
-           :type arg: :py:class:`psyclone.psyir.nodes.DataNode`
+        :param existing_name: the argument name.
+        :param arg: the argument expression.
 
-           :raises TypeError: if the name argument is the wrong type.
-           :raises ValueError: if the name argument is already used \
-               for an existing argument.
-           :raises TypeError: if the index argument is the wrong type.
+        :raises TypeError: if the name argument is the wrong type.
+        :raises ValueError: if the name argument is already used
+            for an existing argument.
 
         '''
         if not isinstance(existing_name, str):