extract-static option

#feat

Author: alandefreitas

docs/mrdocs.schema.json

@@ -131,6 +131,16 @@
       "title": "Extraction policy for private virtual methods of a class",
       "type": "boolean"
     },
+    "extract-static": {
+      "default": false,
+      "description": "Determine whether static members of a file should be extracted. This option does not refer to static members of a class.",
+      "enum": [
+        true,
+        false
+      ],
+      "title": "Extraction policy for static members of a file",
+      "type": "boolean"
+    },
     "file-patterns": {
       "default": [
         "*.hpp",

src/lib/AST/ASTVisitor.cpp

@@ -2706,8 +2706,7 @@ checkTypeFilters(Decl const* D, AccessSpecifier const access)
     if (access == AS_private)
     {
         // Don't extract private members
-        if (isa<CXXMethodDecl>(D) &&
-            dyn_cast<CXXMethodDecl>(D)->isVirtual())
+        if (isVirtualMember(D))
         {
             // Don't extract private virtual members
             return config_->extractPrivateVirtual || config_->extractPrivate;
@@ -2717,10 +2716,11 @@ checkTypeFilters(Decl const* D, AccessSpecifier const access)
     if (!config_->extractAnonymousNamespaces)
     {
         // Don't extract anonymous namespaces
-        MRDOCS_CHECK_OR(
-            !isa<NamespaceDecl>(D) ||
-            !dyn_cast<NamespaceDecl>(D)->isAnonymousNamespace(),
-            false);
+        MRDOCS_CHECK_OR(!isAnonymousNamespace(D), false);
+    }
+    if (!config_->extractStatic)
+    {
+        MRDOCS_CHECK_OR(!isStaticFileLevelMember(D), false);
     }
 
     // Don't extract anonymous unions

src/lib/AST/ClangHelpers.cpp

@@ -344,4 +344,37 @@ isAllImplicit(Decl const* D)
     return isAllImplicit(P);
 }
 
+bool
+isVirtualMember(Decl const* D)
+{
+    if (auto const* MD = dyn_cast<CXXMethodDecl>(D))
+    {
+        return MD->isVirtual();
+    }
+    return false;
+}
+
+bool
+isAnonymousNamespace(const Decl *D)
+{
+    if (auto const* ND = dyn_cast<NamespaceDecl>(D))
+    {
+        return ND->isAnonymousNamespace();
+    }
+    return false;
+}
+
+bool
+isStaticFileLevelMember(const Decl *D)
+{
+    if (const auto *VD = dyn_cast<VarDecl>(D)) {
+        return VD->getStorageClass() == SC_Static && VD->getDeclContext()->isFileContext();
+    }
+    if (const auto *FD = dyn_cast<FunctionDecl>(D)) {
+        return FD->getStorageClass() == SC_Static && FD->getDeclContext()->isFileContext();
+    }
+    return false;
+}
+
+
 } // clang::mrdocs

src/lib/AST/ClangHelpers.hpp

@@ -832,6 +832,18 @@ MRDOCS_DECL
 bool
 isAllImplicit(Decl const* D);
 
+MRDOCS_DECL
+bool
+isVirtualMember(Decl const* D);
+
+MRDOCS_DECL
+bool
+isAnonymousNamespace(Decl const* D);
+
+MRDOCS_DECL
+bool
+isStaticFileLevelMember(Decl const *D);
+
 #ifdef NDEBUG
 #define MRDOCS_SYMBOL_TRACE(D, C)
 #else

src/lib/Lib/ConfigOptions.json

@@ -206,6 +206,13 @@
         "type": "bool",
         "default": false
       },
+      {
+        "name": "extract-static",
+        "brief": "Extraction policy for static members of a file",
+        "details": "Determine whether static members of a file should be extracted. This option does not refer to static members of a class.",
+        "type": "bool",
+        "default": false
+      },
       {
         "name": "extract-anonymous-namespaces",
         "brief": "Extraction policy for anonymous namespaces",

test-files/golden-tests/metadata/ns-variables.yml

@@ -0,0 +1 @@
+extract-static: true