summaryrefslogtreecommitdiff
path: root/tests/functional/ext/docparams/raise/missing_raises_doc_required_exc_inheritance.py
diff options
context:
space:
mode:
Diffstat (limited to 'tests/functional/ext/docparams/raise/missing_raises_doc_required_exc_inheritance.py')
-rw-r--r--tests/functional/ext/docparams/raise/missing_raises_doc_required_exc_inheritance.py45
1 files changed, 45 insertions, 0 deletions
diff --git a/tests/functional/ext/docparams/raise/missing_raises_doc_required_exc_inheritance.py b/tests/functional/ext/docparams/raise/missing_raises_doc_required_exc_inheritance.py
new file mode 100644
index 000000000..16334818d
--- /dev/null
+++ b/tests/functional/ext/docparams/raise/missing_raises_doc_required_exc_inheritance.py
@@ -0,0 +1,45 @@
+"""Tests for missing-raises-doc for exception class inheritance."""
+# pylint: disable=missing-class-docstring
+
+class CustomError(NameError):
+ pass
+
+
+class CustomChildError(CustomError):
+ pass
+
+
+def test_find_missing_raise_for_parent(): # [missing-raises-doc]
+ """This is a docstring.
+
+ Raises:
+ CustomError: Never
+ """
+ raise NameError("hi")
+
+
+def test_no_missing_raise_for_child_builtin():
+ """This is a docstring.
+
+ Raises:
+ Exception: Never
+ """
+ raise ValueError("hi")
+
+
+def test_no_missing_raise_for_child_custom():
+ """This is a docstring.
+
+ Raises:
+ NameError: Never
+ """
+ raise CustomError("hi")
+
+
+def test_no_missing_raise_for_child_custom_nested():
+ """This is a docstring.
+
+ Raises:
+ NameError: Never
+ """
+ raise CustomChildError("hi")