robotframework-testdoc 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

{robotframework_testdoc-0.1.3.dist-info → robotframework_testdoc-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: robotframework-testdoc
-Version: 0.1.3
+Version: 0.1.5
 Summary: A CLI Tool to generate a Test Documentation for your RobotFramework Test Scripts.
 Author-email: Marvin Klerx <marvinklerx1@gmail.com>
 License: MIT
@@ -107,8 +107,8 @@ You can select between several themes (color configurations) for your HTML docum
 
 ### Default Themes
 
-There are a few predefined default themes available that you can choose via the toml-configuration file.   
-Therefore, please use the following syntax:
+There are a few predefined default themes available that you can choose via the toml-configuration file OR cli.   
+Therefore, please use the following syntax: for the toml file
 ```toml
 [colors]
 # Use the default theme
@@ -125,6 +125,15 @@ default = "robot"
 default = 3
 ```
 
+For setting it via CLI, please use the following:
+```shell
+# Applying dark theme
+testdoc ... -S dark PATH OUTPUT_FILE
+
+# Applying blue theme
+testdoc ... --style blue PATH OUTPUT_FILE
+```
+
 > [!TIP]
 > You can select the default theme using either a string value or an integer value.
 
@@ -146,3 +155,17 @@ robot_icon = "#00ffb9"
 
 > [!TIP]
 > Please make sure to configure all available color values from this example — missing values may cause layout or rendering issues in the generated HTML document!
+
+### Default Themes - Screenshot
+
+#### Dark
+
+![alt text](docs/style_dark.png)
+
+#### Blue
+
+![alt text](docs/style_blue.png)
+
+#### Robot / Default
+
+![alt text](docs/style_robot.png)

robotframework_testdoc-0.1.5.dist-info/RECORD

@@ -0,0 +1,25 @@
+robotframework_testdoc-0.1.5.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+testdoc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+testdoc/__main__.py,sha256=09c4nsw4Vnp1LaK0CnlofJQFbKmeFexOXyTBDY9NrFk,67
+testdoc/cli.py,sha256=WyiuX9ONHMeeXAxXrF3XjR8Pal_WFg04dGVON7msrLc,4623
+testdoc/default.toml,sha256=PK7O2gat8326ZYOXBC1mt6-5ceBhdbgs0BL1uo4XLjQ,87
+testdoc/testdoc.py,sha256=cVJguXoFhkCM2nkUlZGB8m-6rBhKwthFFtdtz0T2l4Q,772
+testdoc/helper/cliargs.py,sha256=eT7-1WGhHXbVSdC4LetkQQmhrhuISF35V3Aody-ymEk,1285
+testdoc/helper/datetimeconverter.py,sha256=1IuJ_rZlKKut3pallS9WSdlQ00YNQX2Nhf2oYWt7QDc,159
+testdoc/helper/logger.py,sha256=STPEEdMIGpK004xHDskj8zzW3knBWP05GllYajQMaSY,272
+testdoc/helper/pathconverter.py,sha256=Il4SX8EdpKPjOiZt97zC4TBLxp2tKUhfyyS2J1qWpyg,1656
+testdoc/html/images/robotframework.svg,sha256=w1yNL6XtuHOCCwzjGX3pZQG7ZcJghzllvc7cQ9MKKbQ,1426
+testdoc/html/templates/jinja_template_01.html,sha256=gw2hEx2P7zLsQP5-4fA2hErWJuhkUTZkEakXxRzWKtU,18213
+testdoc/html/themes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+testdoc/html/themes/theme_config.py,sha256=3AFUSoddhAZswcEsshbvqcnmbLOFaBYUFy-lrfNBV3Q,1495
+testdoc/html/themes/themes.py,sha256=6xlHW7O-XO9Z1B33_aRwzffkuWR65jM7CYXsZWUjdmY,1091
+testdoc/html_rendering/render.py,sha256=BzPGyePwjCFZAXRHDF-ccM2xRKY-6Cnym1-uDb9i1AQ,1083
+testdoc/parser/testcaseparser.py,sha256=69WGA2aM2NsC1mU8PVGXfW23TEoYhJDjEfsyNwW2AoM,1243
+testdoc/parser/testsuiteparser.py,sha256=eqFMaEa2aXYCkoAl8wLmA7NsPOx8oxY8KfTKVxyGIPU,2595
+testdoc/parser/modifier/sourceprefixmodifier.py,sha256=Vy_keEKztF7UrjtWjmkU7usGR7E-xLvxJOWocPRu6KI,3950
+testdoc/parser/modifier/suitefilemodifier.py,sha256=OuDuleQj4dRjUcu0AROEPZ-2vR3lWJfWmQVuoWLkXuY,4865
+robotframework_testdoc-0.1.5.dist-info/METADATA,sha256=xzo1mMtpPf_-pQ8nU4cZ5bB1vcBcwf8AStjqwN7ABpE,4970
+robotframework_testdoc-0.1.5.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+robotframework_testdoc-0.1.5.dist-info/entry_points.txt,sha256=BUHy23mdlGCqYOWpsvRhSb1c0tPMzIwyTwr-sHI6xUs,45
+robotframework_testdoc-0.1.5.dist-info/top_level.txt,sha256=p1axpYooAmdwwXQOzFsSXF3u_-88QFKCDxPf67siv3Y,8
+robotframework_testdoc-0.1.5.dist-info/RECORD,,

testdoc/__main__.py

@@ -1,3 +1,4 @@
 from testdoc.cli import main
+
 if __name__ == "__main__":
     main()

testdoc/cli.py

@@ -19,6 +19,7 @@ from .helper.cliargs import CommandLineArguments
 @click.option("--hide-suite-doc",   is_flag=True, required=False, help="If given, suite documentation is hidden")
 @click.option("--hide-source",      is_flag=True, required=False, help="If given, test suite/ test case source is hidden")
 @click.option("--hide-keywords",    is_flag=True, required=False, help="If given, keyword calls in test cases are hidden")
+@click.option("-S", "--style", required=False, help="Choose a predefined default style theme - 'default', 'robot', 'dark' or 'blue' ")
 @click.option("-c", "--configfile", required=False, help="Optional .toml configuration file (includes all cmd-args)")
 @click.option("-v", "--verbose",    is_flag=True, required=False, help="More precise debugging into shell")
 @click.argument("PATH")
@@ -36,6 +37,7 @@ def main(
         hide_suite_doc,
         hide_source,
         hide_keywords,
+        style,
         configfile,
         verbose,
         path,
@@ -77,6 +79,7 @@ def main(
         "hide_source": hide_source or None,
         "hide_keywords": hide_keywords or None,
         "verbose_mode": verbose or None,
+        "style": style or None,
         "config_file": configfile or None,
     }
     args.suite_file = path

testdoc/default.toml

@@ -0,0 +1,3 @@
+# Find here some default settings like the used default theme
+[default]
+theme = "dark"

testdoc/helper/cliargs.py

@@ -19,6 +19,7 @@ class CommandLineArgumentsData:
     config_file: str = None
     verbose_mode: bool = False
     suite_file: str = None
+    style: str = None
     output_file: str = None
     colors: dict = None
 

testdoc/html/themes/theme_config.py

@@ -1,18 +1,32 @@
 from ...helper.cliargs import CommandLineArguments
 from .themes import DEFAULT_THEME, ROBOT_THEME, DARK_THEME, BLUE_THEME
 
+import os
+import tomli
+
 class ThemeConfig():
     
+    default_config = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "default.toml")
+    
     def __init__(self):
         self.args = CommandLineArguments().data
+        with open(self.default_config, "rb") as file:
+            self.config = tomli.load(file)
+
+    #######################################################################################################
 
     def theme(self):
-        _theme = self.args.colors
-        if _theme:
-            if "default" in _theme:
-                return self._get_predefined_theme(_theme.get("default"))    
-            return _theme
-        return DARK_THEME
+        _cli_style = self.args.style
+        if _cli_style:
+            return self._get_predefined_theme(_cli_style)
+        _toml_theme = self.args.colors
+        if _toml_theme:
+            if "default" in _toml_theme:
+                return self._get_predefined_theme(_toml_theme.get("default"))    
+            return _toml_theme
+        return self._get_predefined_theme(self.config["default"]["theme"])
+    
+    #######################################################################################################
     
     def _get_predefined_theme(self, theme: str):
         theme = theme.strip()

testdoc/parser/modifier/sourceprefixmodifier.py

@@ -1,23 +1,45 @@
 import os
+from abc import ABC, abstractmethod
 
 from robot.api import  TestSuite
 
 from ...helper.cliargs import CommandLineArguments
 from ...helper.logger import Logger
 
+available_implementations = "gitlab"
+
+########################################
+# Interface
+########################################
+class SourceModifier(ABC):
+    @abstractmethod
+    def apply(self, suite_dict, prefix):
+        pass
+
+########################################
+# Factory
+########################################
+class SourceModifierFactory:
+    @staticmethod
+    def get_modifier(prefix_type: str) -> SourceModifier:
+        if prefix_type.lower() == "gitlab":
+            return GitLabModifier()
+        # EXAMPLE Extension:
+        # elif prefix_type.lower() == "github":
+        #     return GitHubModifier()
+        raise ValueError(
+            f"No source modifier found for type '{prefix_type}' - actually available implementation are:\n{available_implementations}"
+        )
+
+########################################
+# Prefix Modifier - Implementation
+########################################
 class SourcePrefixModifier():
     
     GITLAB_CONNECTOR = "-/blob/main/"
     
     def __init__(self):
         self.args = CommandLineArguments().data
-    
-    def _modify(self, suite: TestSuite, prefix: str):
-        prefix_type, prefix = self._prefix_validation(prefix)
-        if "gitlab" in prefix_type:
-            SourcePrefixGitLab()._apply_gitlab_source_to_suite(suite, prefix)
-        else:
-            raise ValueError(f"No matching source-prefix modifier found for: {prefix_type} with prefix: {prefix}")
 
     def _prefix_validation(self, prefix: str) -> list:
         if "::" not in prefix:
@@ -27,11 +49,16 @@ class SourcePrefixModifier():
     
     def modify_source_prefix(self, suite_object: TestSuite) -> TestSuite:
         Logger().LogKeyValue("Using Prefix for Source: ", self.args.sourceprefix, "yellow") if self.args.verbose_mode else None
+        prefix_type, prefix = self._prefix_validation(self.args.sourceprefix)
+        modifier = SourceModifierFactory.get_modifier(prefix_type)
         for suite in suite_object:
-            self._modify(suite, self.args.sourceprefix)
+            modifier.apply(suite, prefix)
         return suite_object
     
-class SourcePrefixGitLab():
+########################################
+# Low-Level Implementation for GitLab
+########################################
+class GitLabModifier():
     """
     Source Prefix Modifier for "GitLab" Projects.
     Expected CMD Line Arg: "gitlab::prefix"
@@ -62,7 +89,7 @@ class SourcePrefixGitLab():
         rel_path = os.path.relpath(file_path, git_root).replace(os.sep, "/")
         return prefix.rstrip("/") + "/-/blob/" + git_branch + "/" + rel_path
 
-    def _apply_gitlab_source_to_suite(self, suite_dict, prefix):
+    def apply(self, suite_dict, prefix):
         try:
             suite_dict["source"] = self._convert_to_gitlab_url(suite_dict["source"], prefix)
         except:
@@ -75,4 +102,9 @@ class SourcePrefixGitLab():
                 test["source"] = "GitLink error"
 
         for sub_suite in suite_dict.get("sub_suites", []):
-            self._apply_gitlab_source_to_suite(sub_suite, prefix)
+            self.apply(sub_suite, prefix)
+
+########################################
+# Low-Level Implementation for ...
+# [FUTURE EXTENSIONS LIKE GITHUB]
+########################################

testdoc/parser/modifier/suitefilemodifier.py

@@ -18,9 +18,6 @@ class SuiteFileModifier():
         self.suite = suite_object
         
         # Modify generic params / hide some params
-        self._modify_root_suite_name()
-        self._modify_root_suite_doc()
-        self._modify_root_suite_metadata()
         self._modify_tags()
         self._modify_test_doc()
         self._modify_suite_doc()
@@ -29,29 +26,16 @@ class SuiteFileModifier():
         return self.suite
     
     #############################################################################################################################
-    
-    def _modify_root_suite_name(self):
-        if not self.args.name:
-            return
-        Logger().LogKeyValue("Modified Name of Root Suite: ", self.args.name, "yellow") if self.args.verbose_mode else None
-        self.suite[0]["name"] = self.args.name
-    
-    #############################################################################################################################
-        
-    def _modify_root_suite_doc(self):
-        if not self.args.doc:
-            return
-        Logger().LogKeyValue("Modified Doc of Root Suite: ", self.args.name, "yellow") if self.args.verbose_mode else None
-        self.suite[0]["doc"] = self.args.doc
-    
-    #############################################################################################################################
-        
-    def _modify_root_suite_metadata(self):
-        if not self.args.metadata:
-            return
-        Logger().LogKeyValue("Modified Metadata of Root Suite: ", self.args.metadata, "yellow") if self.args.verbose_mode else None
-        formatted_metadata = "<br>".join([f"{k}: {v}" for k, v in self.args.metadata.items()])
-        self.suite[0]["metadata"] = formatted_metadata
+
+    # Modify name, doc & metadata via officially provided robot api
+    def _modify_root_suite_details(self, suite: TestSuite):
+        if self.args.name:
+            suite.configure(name=self.args.name)
+        if self.args.doc:
+            suite.configure(doc=self.args.doc)
+        if self.args.metadata:
+            suite.configure(metadata=self.args.metadata)
+        return suite
     
     #############################################################################################################################
     

testdoc/parser/testcaseparser.py

@@ -23,6 +23,7 @@ class TestCaseParser():
             suite_info["tests"].append(test_info)
         return suite_info
         
+    # Consider tags via officially provided robot api
     def consider_tags(self, suite: TestSuite) -> TestSuite:
         if len(self.args.include) > 0:
             suite.configure(include_tags=self.args.include) 

testdoc/parser/testsuiteparser.py

@@ -2,6 +2,7 @@ import os
 
 from robot.api import SuiteVisitor, TestSuite
 from .testcaseparser import TestCaseParser
+from .modifier.suitefilemodifier import SuiteFileModifier
 
 class RobotSuiteParser(SuiteVisitor):
     def __init__(self):
@@ -23,7 +24,7 @@ class RobotSuiteParser(SuiteVisitor):
             "total_tests": 0,
             "tests": [],
             "sub_suites": [],
-            "metadata": None
+            "metadata": "<br>".join([f"{k}: {v}" for k, v in suite.metadata.items()]) if suite.metadata else None
         }
 
         # Parse Test Cases
@@ -39,6 +40,7 @@ class RobotSuiteParser(SuiteVisitor):
     def parse_suite(self, suite_path):
         suite = TestSuite.from_file_system(suite_path)
         suite = TestCaseParser().consider_tags(suite)
+        suite = SuiteFileModifier()._modify_root_suite_details(suite)
         suite.visit(self)
         return self.suites
     
@@ -65,4 +67,4 @@ class RobotSuiteParser(SuiteVisitor):
     def _already_parsed(self, suite):
         existing_suite = next((s for s in self.suites if s["name"] == suite.name), None)
         if existing_suite:
-            return
+            return

robotframework_testdoc-0.1.3.dist-info/RECORD

@@ -1,24 +0,0 @@
-robotframework_testdoc-0.1.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-testdoc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-testdoc/__main__.py,sha256=FXuSYwSHojtkWAz8l6xeETxklc3cVdUBqo1GiBGt2Rg,66
-testdoc/cli.py,sha256=VOpy3jPHQVNgwGBQgQmXcgYAeQRsjhgrnzOsJKwSsyM,4441
-testdoc/testdoc.py,sha256=cVJguXoFhkCM2nkUlZGB8m-6rBhKwthFFtdtz0T2l4Q,772
-testdoc/helper/cliargs.py,sha256=PYz6hcKTo-MLzmXWum4foszuHhYrMubAG7nP9xKZ5b8,1263
-testdoc/helper/datetimeconverter.py,sha256=1IuJ_rZlKKut3pallS9WSdlQ00YNQX2Nhf2oYWt7QDc,159
-testdoc/helper/logger.py,sha256=STPEEdMIGpK004xHDskj8zzW3knBWP05GllYajQMaSY,272
-testdoc/helper/pathconverter.py,sha256=Il4SX8EdpKPjOiZt97zC4TBLxp2tKUhfyyS2J1qWpyg,1656
-testdoc/html/images/robotframework.svg,sha256=w1yNL6XtuHOCCwzjGX3pZQG7ZcJghzllvc7cQ9MKKbQ,1426
-testdoc/html/templates/jinja_template_01.html,sha256=gw2hEx2P7zLsQP5-4fA2hErWJuhkUTZkEakXxRzWKtU,18213
-testdoc/html/themes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-testdoc/html/themes/theme_config.py,sha256=UHqNlkff5Q_68uRAsCIODflxJxmLSyH8LMbdJXkHSdw,849
-testdoc/html/themes/themes.py,sha256=6xlHW7O-XO9Z1B33_aRwzffkuWR65jM7CYXsZWUjdmY,1091
-testdoc/html_rendering/render.py,sha256=BzPGyePwjCFZAXRHDF-ccM2xRKY-6Cnym1-uDb9i1AQ,1083
-testdoc/parser/testcaseparser.py,sha256=4EyUFOuo6AtobKN7jveWAXTTs-KlvhzqXQuXnseTGj0,1189
-testdoc/parser/testsuiteparser.py,sha256=F4zWTw4_ccipoOnRHl3LDLn6qPO-AhkSx7cZ7DLKC8U,2381
-testdoc/parser/modifier/sourceprefixmodifier.py,sha256=UUZ0Gp5hZIYv4dvZV6XUOE5UkIFONLFj_mZczC40mzI,3013
-testdoc/parser/modifier/suitefilemodifier.py,sha256=VA-4rAniQugXefWfXSaZoDzOafqXTqGDKLk2BZd6_hE,5785
-robotframework_testdoc-0.1.3.dist-info/METADATA,sha256=-8LIGOYwfbvgq1EWB1QdBTuJTsMzRhg5424LZrxrPlM,4577
-robotframework_testdoc-0.1.3.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-robotframework_testdoc-0.1.3.dist-info/entry_points.txt,sha256=BUHy23mdlGCqYOWpsvRhSb1c0tPMzIwyTwr-sHI6xUs,45
-robotframework_testdoc-0.1.3.dist-info/top_level.txt,sha256=p1axpYooAmdwwXQOzFsSXF3u_-88QFKCDxPf67siv3Y,8
-robotframework_testdoc-0.1.3.dist-info/RECORD,,