Setup test cases for RST213/args and RST219/kwargs

Author: peterjc

tests/run_tests.sh

@@ -29,14 +29,14 @@ echo "Good, no RST style violations reported, as expected."
 echo "================"
 echo "Extra directives"
 echo "================"
-# Checked this failed earlier in the RST303 tests
+# Checked this failed by default in the RST303 tests
 flake8 --select RST --rst-directives=req,spec,needfilter RST303/sphinx-directives.py
 echo "Good, no RST303 style violations reported, as expected."
 
 echo "==========="
 echo "Extra roles"
 echo "==========="
-# Checked this failed earlier in the RST304 tests
+# Checked this failed by default in the RST304 tests
 flake8 --select RST --rst-roles need,need_incoming RST304/sphinx-roles.py
 echo "Good, no RST304 style violations reported, as expected."
 

tests/test_cases/google_args_and_kwargs.py

@@ -0,0 +1,15 @@
+def module_level_function(param1, param2=None, *args, **kwargs):
+    """This is an example of a module level function.
+
+    Here using the Google docstring style, notice that we have *not* escaped
+    the asterisk in ``*args*`` or ``**kwargs`` in the argument list.
+
+    Args:
+        param1 (int): The first parameter.
+        param2 (str, optional): The second parameter. Defaults to None.
+        *args: Variable length argument list.
+        **kwargs: Arbitrary keyword arguments.
+
+    ...
+    """
+    pass

tests/test_cases/numpy_args_and_kwargs.py

@@ -0,0 +1,20 @@
+def module_level_function(param1, param2=None, *args, **kwargs):
+    """This is an example of a module level function.
+
+    Here using the Numpy docstring style, notice that we have *not* escaped
+    the asterisk in ``*args*`` or ``**kwargs`` in the parameter list.
+
+    Parameters
+    ----------
+    param1 : int
+        The first parameter.
+    param2 : str optional
+        The second parameter.
+    *args
+        Variable length argument list.
+    **kwargs
+        Arbitrary keyword arguments.
+
+    ...
+    """
+    pass