From ce0cd8a7e6c3780b3ec96433d197f12ecb74112f Mon Sep 17 00:00:00 2001
From: Robert Kaussow <mail@thegeeklab.de>
Date: Fri, 29 Apr 2022 13:19:35 +0200
Subject: [PATCH] feat: add option exclude_tags to disable auto-discovery
 (#289)

---
 ansibledoctor/config.py             |  6 ++++++
 ansibledoctor/doc_parser.py         |  4 +++-
 docs/content/usage/configuration.md | 24 +++++++++++++-----------
 example/README.md                   |  2 --
 4 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/ansibledoctor/config.py b/ansibledoctor/config.py
index 248d408..c7bbe49 100644
--- a/ansibledoctor/config.py
+++ b/ansibledoctor/config.py
@@ -97,6 +97,12 @@ class Config():
             "file": True,
             "type": environs.Env().list
         },
+        "exclude_tags": {
+            "default": [],
+            "env": "EXCLUDE_TAGS",
+            "file": True,
+            "type": environs.Env().list
+        },
         "role_detection": {
             "default": True,
             "env": "ROLE_DETECTION",
diff --git a/ansibledoctor/doc_parser.py b/ansibledoctor/doc_parser.py
index 6e7d9d8..34c09b8 100644
--- a/ansibledoctor/doc_parser.py
+++ b/ansibledoctor/doc_parser.py
@@ -112,7 +112,9 @@ class Parser:
                         self._yaml_remove_comments(raw)
 
                         tags = list(set(flatten(nested_lookup("tags", raw))))
-                        for tag in tags:
+                        for tag in [
+                            x for x in tags if x not in self.config.config["exclude_tags"]
+                        ]:
                             self._data["tag"][tag] = {"value": tag}
                     except (
                         ruamel.yaml.composer.ComposerError, ruamel.yaml.scanner.ScannerError
diff --git a/docs/content/usage/configuration.md b/docs/content/usage/configuration.md
index 2c3f275..9f74536 100644
--- a/docs/content/usage/configuration.md
+++ b/docs/content/usage/configuration.md
@@ -18,33 +18,31 @@ Configuration options can be set in different places, which are processed in the
 
 ```YAML
 ---
-# default is the current working directory
+# Default is the current working directory.
 role_dir:
-# default is the basename of 'role_name'
+# Default is the basename of 'role_name'.
 role_name:
 # Auto-detect if the given directory is a role, can be disabled
 # to parse loose files instead.
 role_detection: True
-# don't write anything to file system
+# Don't write anything to file system
 dry_run: False
 
 logging:
-    # possible options debug | info | warning | error | critical
+    # Possible options debug | info | warning | error | critical
     level: "warning"
-    # json logging can be enabled if a parsable output is required
+    # Json logging can be enabled if a parsable output is required
     json: False
 
-# path to write rendered template file
-# default is the current working directory
+# Path to write rendered template file. Default is the current working directory.
 output_dir:
-# default is in-build templates directory
+# Default is built-in templates directory.
 template_dir:
 template: readme
 
-# don't ask to overwrite if output file exists
+# Don't ask to overwrite if output file exists.
 force_overwrite: False
-# load custom header from given file and append template output
-# to it before write.
+# Load custom header from given file and append template output to it before write.
 custom_header: ""
 
 exclude_files: []
@@ -52,6 +50,10 @@ exclude_files: []
 # exclude_files:
 #   - molecule/
 #   - files/**/*.py
+
+# Exclude tags from automatic detection. Configured tags are only skipped
+# if the tag is not used in an annotation.
+exclude_tags: []
 ```
 
 ## CLI
diff --git a/example/README.md b/example/README.md
index 0340624..5e281af 100644
--- a/example/README.md
+++ b/example/README.md
@@ -153,8 +153,6 @@ demo_role_unset: some_value
 
 ## Discovered Tags
 
-**_role-tag1_**
-
 **_role-tag2_**
 
 **_single-tag_**\