You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14-14Lines changed: 14 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,43 +11,43 @@
11
11
12
12
This provides a generic plugin for Poetry that runs during the build process.
13
13
14
-
What the plugin does is collect decorated code, formatting it and writing it to a yaml file saved to the `dist` folder, utilizing the `reqstool-decorators` package for the processing.
14
+
The plugin collects decorated code, formatting it and writing it to a annotations.yml file saved to the `build/reqstool/` folder, utilizing the `reqstool-python-decorators` package for the processing.
15
15
16
16
17
17
18
18
## Installation
19
19
20
20
### Plugin
21
21
22
-
The package name is `reqstool-poetry-plugin`.
22
+
The package name is `reqstool-python-poetry-plugin`.
23
23
24
24
* Using poetry:
25
25
26
26
```
27
-
$poetry add reqstool-poetry-plugin
27
+
$poetry add reqstool-python-poetry-plugin
28
28
```
29
29
30
30
* pip install (unsure if working as intended):
31
31
32
32
```
33
-
$pip install reqstool-poetry-plugin
33
+
$pip install reqstool-python-poetry-plugin
34
34
```
35
35
36
36
### Dependencies
37
37
38
38
#### reqstool-decorators
39
39
40
-
The plugin reads decorators available in the `reqstool-decorators` package.
40
+
The plugin reads decorators available in the `reqstool-python-decorators` package.
41
41
42
42
```
43
-
$pip install reqstool-decorators
43
+
$pip install reqstool-python-decorators
44
44
```
45
45
46
46
pyproject.toml
47
47
48
48
```
49
49
[tool.poetry.dependencies]
50
-
reqstool-decorators = "^0.1.5"
50
+
reqstool-python-decorators = "<version>"
51
51
```
52
52
53
53
## Usage
@@ -62,15 +62,15 @@ The plugin gets the paths where it will look for decorated code from ("." is fil
62
62
pythonpath = [".", "src", "tests"]
63
63
```
64
64
65
-
So in this example all files in "src" and "tests", including subfolders, will be processed.
65
+
In this example all files in "src" and "tests", including subfolders, will be processed.
66
66
67
67
#### Poetry
68
68
69
-
This will be added when running `poetry add reqstool-poetry-plugin`
69
+
This will be added when running `poetry add reqstool-python-poetry-plugin`
70
70
71
71
```
72
72
[tool.poetry.dependencies]
73
-
reqstool-poetry-plugin = "<version>"
73
+
reqstool-python-poetry-plugin = "<version>"
74
74
```
75
75
76
76
### Decorators
@@ -80,24 +80,24 @@ Used to decorate your code as seen in the examples below, the decorator processi
80
80
Import decorators:
81
81
82
82
```
83
-
from reqstool-decorators.decorators.decorators import Requirements, SVCs
83
+
from reqstool-python-decorators.decorators.decorators import Requirements, SVCs
84
84
```
85
85
86
86
Example usage of the decorators:
87
87
88
88
```
89
-
@Requirements(REQ_111, REQ_222)
89
+
@Requirements("REQ_111", "REQ_222")
90
90
def somefunction():
91
91
```
92
92
93
93
```
94
-
@SVCs(SVC_111, SVC_222)
94
+
@SVCs("SVC_111", "SVC_222")
95
95
def test_somefunction():
96
96
```
97
97
98
98
### Poetry build
99
99
100
-
When running `$poetry build` or `$poetry install` the plugin will run the `activate` function located inside `DecoratorsPlugin`, calling functions from the `reqstool-decorators` package and generate a yaml file in the `dist` folder containing formatted data on all decorated code found.
100
+
When running `$poetry build` or `$poetry install` the plugin will run the `activate` function located inside `DecoratorsPlugin` class, calling functions from the `reqstool-python-decorators` package and generate a annotations.yml file in the `build/reqstool/` folder containing formatted data on all decorated code found.
Copy file name to clipboardExpand all lines: docs/modules/ROOT/pages/description.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,4 +2,4 @@
2
2
3
3
This provides a generic plugin for Poetry that runs during the build process.
4
4
5
-
What the plugin does is collect decorated code, formatting it and writing it to a yaml file saved to the `build` folder, utilizing the `reqstool-python-decorators` package for the processing.
5
+
The plugin collects decorated code, formatting it and writing it to a annotations.yml file saved to the `build/reqstool/` folder, utilizing the `reqstool-python-decorators` package for the processing.
Copy file name to clipboardExpand all lines: docs/modules/ROOT/pages/usage.adoc
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ The plugin gets the paths where it will look for decorated code from ("." is fil
11
11
pythonpath = [".", "src", "tests"]
12
12
```
13
13
14
-
So in this example all files in "src" and "tests", including subfolders, will be processed.
14
+
In this example all files in "src" and "tests", including subfolders, will be processed.
15
15
16
16
==== Poetry
17
17
@@ -35,15 +35,15 @@ from reqstool_python_decorators.decorators.decorators import Requirements, SVCs
35
35
Example usage of the decorators:
36
36
37
37
```
38
-
@Requirements(REQ_111, REQ_222)
38
+
@Requirements("REQ_111", "REQ_222")
39
39
def somefunction():
40
40
```
41
41
42
42
```
43
-
@SVCs(SVC_111, SVC_222)
43
+
@SVCs("SVC_111", "SVC_222")
44
44
def test_somefunction():
45
45
```
46
46
47
47
=== Poetry build
48
48
49
-
When running `$poetry build` or `$poetry install` the plugin will run the `activate` function located inside `DecoratorsPlugin`, calling functions from the `reqstool-python-decorators` package and generate a yaml file in the `build` folder containing formatted data on all decorated code found.
49
+
When running `$poetry build` or `$poetry install` the plugin will run the `activate` function located inside `DecoratorsPlugin` class, calling functions from the `reqstool-python-decorators` package and generate a annotations.yml file in the `build/reqstool/` folder containing formatted data on all decorated code found.
0 commit comments