robotframework-testdoc 0.5.0__tar.gz → 0.6.0__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.
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/PKG-INFO +2 -104
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/README.md +1 -103
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/pyproject.toml +60 -4
- robotframework_testdoc-0.5.0/src/testdoc/html/templates/v3/jinja_template_04.html → robotframework_testdoc-0.6.0/src/testdoc/html/templates/jinja_html_default/jinja_template.html +126 -68
- robotframework_testdoc-0.5.0/src/testdoc/html/templates/v1/jinja_template_01.html +0 -336
- robotframework_testdoc-0.5.0/src/testdoc/html/templates/v1/jinja_template_02.html +0 -116
- robotframework_testdoc-0.5.0/src/testdoc/html/templates/v2/jinja_template_03.html +0 -358
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/.gitignore +0 -0
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/LICENSE +0 -0
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/src/testdoc/default.toml +0 -0
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/src/testdoc/html/images/robotframework.svg +0 -0
- {robotframework_testdoc-0.5.0 → robotframework_testdoc-0.6.0}/src/testdoc/html/templates/mkdocs_default/overrides/partials/footer.html +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: robotframework-testdoc
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.6.0
|
|
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
|

|
|
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
|
-

|
|
236
|
-
|
|
237
|
-
#### Blue
|
|
238
|
-
|
|
239
|
-

|
|
240
|
-
|
|
241
|
-
#### Robot / Default
|
|
242
|
-
|
|
243
|
-

|
|
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
|

|
|
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
|
-

|
|
200
|
-
|
|
201
|
-
#### Blue
|
|
202
|
-
|
|
203
|
-

|
|
204
|
-
|
|
205
|
-
#### Robot / Default
|
|
206
|
-
|
|
207
|
-

|
|
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
|
|
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
|
-
|
|
106
|
-
|
|
107
|
-
|
|
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"]
|