Skip to content

Commit 4205b04

Browse files
authored
feat: Update documentation (#18)
1 parent 6483521 commit 4205b04

4 files changed

Lines changed: 20 additions & 20 deletions

File tree

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -11,43 +11,43 @@
1111

1212
This provides a generic plugin for Poetry that runs during the build process.
1313

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

1616

1717

1818
## Installation
1919

2020
### Plugin
2121

22-
The package name is `reqstool-poetry-plugin`.
22+
The package name is `reqstool-python-poetry-plugin`.
2323

2424
* Using poetry:
2525

2626
```
27-
$poetry add reqstool-poetry-plugin
27+
$poetry add reqstool-python-poetry-plugin
2828
```
2929

3030
* pip install (unsure if working as intended):
3131

3232
```
33-
$pip install reqstool-poetry-plugin
33+
$pip install reqstool-python-poetry-plugin
3434
```
3535

3636
### Dependencies
3737

3838
#### reqstool-decorators
3939

40-
The plugin reads decorators available in the `reqstool-decorators` package.
40+
The plugin reads decorators available in the `reqstool-python-decorators` package.
4141

4242
```
43-
$pip install reqstool-decorators
43+
$pip install reqstool-python-decorators
4444
```
4545

4646
pyproject.toml
4747

4848
```
4949
[tool.poetry.dependencies]
50-
reqstool-decorators = "^0.1.5"
50+
reqstool-python-decorators = "<version>"
5151
```
5252

5353
## Usage
@@ -62,15 +62,15 @@ The plugin gets the paths where it will look for decorated code from ("." is fil
6262
pythonpath = [".", "src", "tests"]
6363
```
6464

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

6767
#### Poetry
6868

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

7171
```
7272
[tool.poetry.dependencies]
73-
reqstool-poetry-plugin = "<version>"
73+
reqstool-python-poetry-plugin = "<version>"
7474
```
7575

7676
### Decorators
@@ -80,24 +80,24 @@ Used to decorate your code as seen in the examples below, the decorator processi
8080
Import decorators:
8181

8282
```
83-
from reqstool-decorators.decorators.decorators import Requirements, SVCs
83+
from reqstool-python-decorators.decorators.decorators import Requirements, SVCs
8484
```
8585

8686
Example usage of the decorators:
8787

8888
```
89-
@Requirements(REQ_111, REQ_222)
89+
@Requirements("REQ_111", "REQ_222")
9090
def somefunction():
9191
```
9292

9393
```
94-
@SVCs(SVC_111, SVC_222)
94+
@SVCs("SVC_111", "SVC_222")
9595
def test_somefunction():
9696
```
9797

9898
### Poetry build
9999

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

102102

103103

docs/modules/ROOT/pages/description.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22

33
This provides a generic plugin for Poetry that runs during the build process.
44

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.

docs/modules/ROOT/pages/installation.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,5 +30,5 @@ pyproject.toml
3030

3131
```
3232
[tool.poetry.dependencies]
33-
reqstool-python-decorators = "<installed version>"
33+
reqstool-python-decorators = "<version>"
3434
```

docs/modules/ROOT/pages/usage.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ The plugin gets the paths where it will look for decorated code from ("." is fil
1111
pythonpath = [".", "src", "tests"]
1212
```
1313

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

1616
==== Poetry
1717

@@ -35,15 +35,15 @@ from reqstool_python_decorators.decorators.decorators import Requirements, SVCs
3535
Example usage of the decorators:
3636

3737
```
38-
@Requirements(REQ_111, REQ_222)
38+
@Requirements("REQ_111", "REQ_222")
3939
def somefunction():
4040
```
4141

4242
```
43-
@SVCs(SVC_111, SVC_222)
43+
@SVCs("SVC_111", "SVC_222")
4444
def test_somefunction():
4545
```
4646

4747
=== Poetry build
4848

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

Comments
 (0)