robotframework-testdoc 0.5.0__tar.gz → 0.6.0a1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: robotframework-testdoc
3
- Version: 0.5.0
3
+ Version: 0.6.0a1
4
4
  Summary: A CLI Tool to generate a Test Documentation for your RobotFramework Test Scripts.
5
5
  Project-URL: Repository, https://github.com/MarvKler/robotframework-testdoc
6
6
  Project-URL: Issues, https://github.com/MarvKler/robotframework-testdoc/issues
@@ -89,7 +89,7 @@ You have two option to use it this way:
89
89
 
90
90
  For further details about the usage, please read the [official documentation](https://marvkler.github.io/robotframework-testdoc/usage).
91
91
 
92
- #### Use customized Jinja2 Template
92
+ #### Use customized Jinja2 HTML Template
93
93
 
94
94
  ![Custom Jinja Template](./docs/gifs/customjinja.gif)
95
95
 
@@ -132,116 +132,14 @@ doc = "New doc text of root suite element"
132
132
  sourceprefix = "gitlab::https://gitlab.com/myrepo/repo_path"
133
133
  include = ["TagA", "TagB"]
134
134
  exclude = ["TagC"]
135
- hide_tags = true
136
- hide_test_doc = true
137
- hide_suite_doc = true
138
- hide_source = true
139
- hide_keywords = true
140
- style = "blue"
141
135
  verbose_mode = false
142
136
 
143
137
  [tool.testdoc.metadata]
144
138
  Author = "Your-Name"
145
139
  Version = "1.0.0"
146
140
  Source = "AnySourceAsMetaData"
147
-
148
- [tool.testdoc.colors]
149
- # Use predefined theme:
150
- default = "blue"
151
- # OR
152
- # Use custom colors:
153
- background = "#000028"
154
- inner_color = "#000028"
155
- button_active_color = "#193966"
156
- button_hover_color = "#193966"
157
- border_color = "#CCCCCC"
158
- text_color = "#CCCCCC"
159
- title_color = "#00ffb9"
160
- robot_icon = "#00ffb9"
161
- code_area_background = "#303030"
162
- code_area_foreground = "#f1f1f1"
163
- ```
164
-
165
- ## Theme Selection / Color Configuration
166
-
167
- You can select between several themes (color configurations) for your HTML document to create!
168
-
169
- > [!CAUTION]
170
- > This is only possible via toml-configuration file, but not via cmd args directly!
171
-
172
- ### Default Themes
173
-
174
- There are a few predefined default themes available that you can choose via the toml-configuration file OR cli.
175
- Therefore, please use the following syntax: for the toml file
176
- ```toml
177
- [colors]
178
- # Use the default theme
179
- default = "default"
180
- default = 0
181
- # Use the dark theme
182
- default = "dark"
183
- default = 1
184
- # Use the blue theme
185
- default = "blue"
186
- default = 2
187
- # Use the robot theme
188
- default = "robot"
189
- default = 3
190
- # Use the dark robot theme
191
- default = "robot_dark"
192
- default = 4
193
- # Use the green theme
194
- default = "green"
195
- default = 5
196
141
  ```
197
142
 
198
- For setting it via CLI, please use the following:
199
- ```shell
200
- # Applying dark theme
201
- testdoc ... -S dark PATH OUTPUT_FILE
202
-
203
- # Applying blue theme
204
- testdoc ... --style blue PATH OUTPUT_FILE
205
- ```
206
-
207
- > [!TIP]
208
- > You can select the default theme using either a string value or an integer value.
209
-
210
- ### Custom Themes
211
-
212
- You can apply your own custom theme to modify the colors of the created HTML document.
213
- Use the following syntax & parameters in your toml-configuration file, to overwrite the predefined themes:
214
- ```toml
215
- [colors]
216
- background = "#000028"
217
- inner_color = "#000028"
218
- button_active_color = "#193966"
219
- button_hover_color = "#193966"
220
- border_color = "#CCCCCC"
221
- text_color = "#CCCCCC"
222
- title_color = "#00ffb9"
223
- robot_icon = "#00ffb9"
224
- code_area_background = "#303030"
225
- code_area_foreground = "#f1f1f1"
226
- ```
227
-
228
- > [!TIP]
229
- > 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!
230
-
231
- ### Default Themes - Screenshot
232
-
233
- #### Dark
234
-
235
- ![alt text](docs/style_dark.png)
236
-
237
- #### Blue
238
-
239
- ![alt text](docs/style_blue.png)
240
-
241
- #### Robot / Default
242
-
243
- ![alt text](docs/style_robot.png)
244
-
245
143
  ## Contribution & Development
246
144
 
247
145
  See [Development.md](./DEVELOPMENT.md) for more information about contributing & developing this library.
@@ -53,7 +53,7 @@ You have two option to use it this way:
53
53
 
54
54
  For further details about the usage, please read the [official documentation](https://marvkler.github.io/robotframework-testdoc/usage).
55
55
 
56
- #### Use customized Jinja2 Template
56
+ #### Use customized Jinja2 HTML Template
57
57
 
58
58
  ![Custom Jinja Template](./docs/gifs/customjinja.gif)
59
59
 
@@ -96,116 +96,14 @@ doc = "New doc text of root suite element"
96
96
  sourceprefix = "gitlab::https://gitlab.com/myrepo/repo_path"
97
97
  include = ["TagA", "TagB"]
98
98
  exclude = ["TagC"]
99
- hide_tags = true
100
- hide_test_doc = true
101
- hide_suite_doc = true
102
- hide_source = true
103
- hide_keywords = true
104
- style = "blue"
105
99
  verbose_mode = false
106
100
 
107
101
  [tool.testdoc.metadata]
108
102
  Author = "Your-Name"
109
103
  Version = "1.0.0"
110
104
  Source = "AnySourceAsMetaData"
111
-
112
- [tool.testdoc.colors]
113
- # Use predefined theme:
114
- default = "blue"
115
- # OR
116
- # Use custom colors:
117
- background = "#000028"
118
- inner_color = "#000028"
119
- button_active_color = "#193966"
120
- button_hover_color = "#193966"
121
- border_color = "#CCCCCC"
122
- text_color = "#CCCCCC"
123
- title_color = "#00ffb9"
124
- robot_icon = "#00ffb9"
125
- code_area_background = "#303030"
126
- code_area_foreground = "#f1f1f1"
127
- ```
128
-
129
- ## Theme Selection / Color Configuration
130
-
131
- You can select between several themes (color configurations) for your HTML document to create!
132
-
133
- > [!CAUTION]
134
- > This is only possible via toml-configuration file, but not via cmd args directly!
135
-
136
- ### Default Themes
137
-
138
- There are a few predefined default themes available that you can choose via the toml-configuration file OR cli.
139
- Therefore, please use the following syntax: for the toml file
140
- ```toml
141
- [colors]
142
- # Use the default theme
143
- default = "default"
144
- default = 0
145
- # Use the dark theme
146
- default = "dark"
147
- default = 1
148
- # Use the blue theme
149
- default = "blue"
150
- default = 2
151
- # Use the robot theme
152
- default = "robot"
153
- default = 3
154
- # Use the dark robot theme
155
- default = "robot_dark"
156
- default = 4
157
- # Use the green theme
158
- default = "green"
159
- default = 5
160
105
  ```
161
106
 
162
- For setting it via CLI, please use the following:
163
- ```shell
164
- # Applying dark theme
165
- testdoc ... -S dark PATH OUTPUT_FILE
166
-
167
- # Applying blue theme
168
- testdoc ... --style blue PATH OUTPUT_FILE
169
- ```
170
-
171
- > [!TIP]
172
- > You can select the default theme using either a string value or an integer value.
173
-
174
- ### Custom Themes
175
-
176
- You can apply your own custom theme to modify the colors of the created HTML document.
177
- Use the following syntax & parameters in your toml-configuration file, to overwrite the predefined themes:
178
- ```toml
179
- [colors]
180
- background = "#000028"
181
- inner_color = "#000028"
182
- button_active_color = "#193966"
183
- button_hover_color = "#193966"
184
- border_color = "#CCCCCC"
185
- text_color = "#CCCCCC"
186
- title_color = "#00ffb9"
187
- robot_icon = "#00ffb9"
188
- code_area_background = "#303030"
189
- code_area_foreground = "#f1f1f1"
190
- ```
191
-
192
- > [!TIP]
193
- > 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!
194
-
195
- ### Default Themes - Screenshot
196
-
197
- #### Dark
198
-
199
- ![alt text](docs/style_dark.png)
200
-
201
- #### Blue
202
-
203
- ![alt text](docs/style_blue.png)
204
-
205
- #### Robot / Default
206
-
207
- ![alt text](docs/style_robot.png)
208
-
209
107
  ## Contribution & Development
210
108
 
211
109
  See [Development.md](./DEVELOPMENT.md) for more information about contributing & developing this library.
@@ -95,13 +95,69 @@ dependencies = [
95
95
  "pytest"
96
96
  ]
97
97
  [tool.hatch.envs.dev.scripts]
98
- lint = "ruff check src/"
98
+ lint = "ruff check --force-exclude"
99
+ format = "ruff format --force-exclude"
99
100
  atest = "pytest atest/acceptance"
100
101
  perftest = "pytest atest/performance"
101
102
  alltest = "pytest atest"
102
103
 
104
+
103
105
  [tool.ruff]
104
106
  line-length = 150
105
- lint.select = ["E", "F"] # Pyflakes & pycodestyle
106
- lint.ignore = ["E722"]
107
- exclude = ["build", "dist"]
107
+ src = ["src"]
108
+ exclude = [
109
+ ".venv",
110
+ ".git",
111
+ "__pycache__",
112
+ "build",
113
+ "dist",
114
+ "bootstrap.py",
115
+ "atest/",
116
+ ]
117
+
118
+ [tool.ruff.lint]
119
+ select = [
120
+ "E",
121
+ "F",
122
+ "W",
123
+ "C90",
124
+ "I",
125
+ "N",
126
+ "B",
127
+ "PYI",
128
+ "PL",
129
+ "PTH",
130
+ "UP",
131
+ "A",
132
+ "C4",
133
+ "DTZ",
134
+ "ISC",
135
+ "ICN",
136
+ "INP",
137
+ "PIE",
138
+ "T20",
139
+ "PYI",
140
+ "PT",
141
+ "RSE",
142
+ "RET",
143
+ "SIM",
144
+ "RUF"
145
+ ]
146
+ ignore = [
147
+ "N999", # Robot library names stay CamelCase
148
+ ]
149
+ unfixable = []
150
+
151
+ [tool.ruff.format]
152
+ quote-style = "double"
153
+ indent-style = "space"
154
+
155
+ [tool.mypy]
156
+ strict = true
157
+ show_error_codes = true
158
+ warn_return_any = true
159
+ warn_unused_configs = true
160
+ warn_unreachable = true
161
+ files = ["src"]
162
+ exclude = "/(\\.venv|\\.git|__pycache__|build|dist|atest)/"
163
+ disable_error_code = ["import-untyped"]