Skip to content

Commit b03e8e7

Browse files
committed
[README.md] initial draft of documentation
1 parent 8874e43 commit b03e8e7

File tree

1 file changed

+57
-1
lines changed

1 file changed

+57
-1
lines changed

README.md

Lines changed: 57 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,57 @@
1-
# py-dependency-install
1+
# py-actions/py-dependency-install GitHub Action
2+
3+
This GitHub Action installs Python package dependencies from a user-defined `requirements.txt` file path with optional `pip`, `setuptools`, and `wheel` installs/updates during execution.
4+
5+
## Inputs
6+
7+
### `path`
8+
9+
**Optional** The `requirements.txt` file path relative to the root of your source repository. Default = `"requirements.txt`.
10+
11+
### `update-pip`
12+
13+
**Optional** A boolean string indicating that a `pip` package update should occur before the dependency installation. Options: [`"true"`, `"false"`]. Default=`"true"`
14+
15+
### `update-setuptools`
16+
17+
**Optional** A boolean string indicating that a `setuptools` package update should occur before the dependency installation. Options: [`"true"`, `"false"`]. Default=`"false"`
18+
19+
### `update-wheel`
20+
21+
**Optional** A boolean string indicating that a `wheel` package update should occur before the dependency installation. Options: [`"true"`, `"false"`]. Default=`"false"`
22+
23+
## Outputs
24+
25+
None
26+
27+
## Example usage
28+
29+
### Default
30+
31+
Uses path `requirements.txt` and updates `pip` before the install.
32+
33+
```yaml
34+
uses: py-actions/py-dependency-install@v1
35+
```
36+
37+
### Disable `pip` update before install
38+
39+
```yaml
40+
uses: py-actions/py-dependency-install@v1
41+
with:
42+
update-pip: "false"
43+
```
44+
45+
### Configure `setuptools` and `wheel` installs/updates
46+
47+
```yaml
48+
uses: py-actions/py-dependency-install@v1
49+
with:
50+
update-pip: "true"
51+
update-setuptools: "true"
52+
update-wheel: "true"
53+
```
54+
55+
## License
56+
57+
[Apache License, v2.0](LICENSE)

0 commit comments

Comments
 (0)