Fix typedefed anonymous enumerations being documneted twice.

When an enumeration was contained in a typedef it was being documented
once as the type and once as anonymous.  this has been resolved to only
be documented as the typedef.

For example the following:

    typedef enum {
	SOME_ENUM_0,
	SOME_ENUM_1,
    } the_typedef_name;

Used to show up as:

    enum the_typedef_name

	SOME_ENUM_0

	SOME_ENUM_1

    enum anon_<file>_<######>

	SOME_ENUM_0

	SOME_ENUM_1

Author: speedyleion

CHANGELOG.rst

@@ -9,6 +9,13 @@ This project adheres to `Semantic Versioning <https://semver.org/>`_.
 `v0.2.0-dev`_ (unreleased)
 ==========================
 
+Fixes
+-----
+
+*  Anonymous enumerations which were contained in a typedef were being documented twice.
+   Once as the typedef and once as anonymous. Now they are only documnted as
+   part of the typedef.
+
 `v0.1.1`_ (2012-03-15)
 ======================
 

mypy.ini

@@ -8,7 +8,4 @@ ignore_missing_imports = True
 ignore_missing_imports = True
 
 [mypy-bs4.*]
-ignore_missing_imports = True
-
-[mypy-test*]
-ignore_errors = True
+ignore_missing_imports = True

src/sphinx_c_autodoc/loader.py

@@ -542,7 +542,11 @@ def object_from_cursor(cursor: Cursor) -> Optional[DocumentedObject]:
     name = cursor.spelling
 
     if not name:
-        if cursor.kind in ALLOWED_ANONYMOUS:
+        # An anonymous construct which isn't contained in a typedef will have a
+        # type spelling of:
+        # "<construct> (anonymous at # <path_to_c_file>:<lineno>)"
+        # Typedef's should be handled by the get_nested_node() function
+        if cursor.kind in ALLOWED_ANONYMOUS and "anonymous at" in cursor.type.spelling:
             filename = os.path.basename(cursor.location.file.name)
             # remove the extension from the filename since the '.' is not a
             # valid c identifier. splitext will remove the trailing most

tests/sphinx_project/test_sphinx_build.py

@@ -4,6 +4,7 @@
 For all of these tests warnigns are treated as errors so that any warnings
 from bad logic can more easily be seen in the test output
 """
+import re
 import os
 import shutil
 from sphinx.cmd.build import main
@@ -27,6 +28,12 @@ def test_autodoc_of_c_file(tmp_path):
     # Check for anonymouse enumerations
     assert 'anon_example_' in contents
 
+    # Check for a bug where typedefed enums showed up as anonymouse and the
+    # typedef.
+    occurences = len(re.findall("THE_LAST_ENUM", contents))
+    occurences //= 2  # The text and the anchor.
+    assert occurences == 1
+
     file_name = tmp_path / "sub_dir" / 'file_2.html'
     with file_name.open() as f:
         contents = f.read()