fix: exception templates and nested args

Author: jorgepiloto

autoapi/mappers/base.py

@@ -334,8 +334,12 @@ def output_child_rst(self, obj, obj_parent, detail_dir, source_suffix):
         if not obj.display:
             return
 
-        # Skip nested cases like functions in functions or clases in clases
-        if obj.type == obj_parent.type:
+        # HACK: skip nested cases like functions in functions or clases in clases
+        # Turns out that exceptions in Python have a property named "args" which
+        # is a "class" type of "BaseException"
+        is_same_type_as_parent = obj.type == obj_parent.type
+        is_class_and_exception = obj.type in ["class", "exception"] and obj_parent.type in ["class", "exception"]
+        if is_same_type_as_parent or is_class_and_exception:
             return
 
         obj_child_page_level = _OWN_PAGE_LEVELS.index(obj.type)

autoapi/templates/python/module.rst

@@ -104,7 +104,18 @@ Exceptions
    :hidden:
 
                      {% for exception in visible_exceptions %}
+   {# 
+       The set own_page_types sometimes is not ordered! This changes the value of
+       its last element. Thus, the best way to check is to verify if 'function'
+       lies within the list
+       Do -> if 'function' not in own_page_types
+       Instead of -> if "class" == (own_page_types | list | last)
+   #}
+   {% if "method" not in own_page_types %}
+   {{ exception.short_name }}.rst
+   {% else %}
    {{ exception.short_name }}/index.rst
+   {% endif %}
                      {% endfor %}
 
                   {% endif %}