Skip to content

Commit 2af8db6

Browse files
docs: update the README.md using action-docs
1 parent bb9fa7c commit 2af8db6

File tree

3 files changed

+112
-38
lines changed

3 files changed

+112
-38
lines changed

.github/CODEOWNERS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
* @CalebAbhulimhen

.github/workflows/generate-docs.yml

Lines changed: 0 additions & 38 deletions
This file was deleted.

README.md

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,112 @@
1+
<!-- action-docs-all source="action.yml" project="codescanai/codescanai-action" version="v1.0.0" -->
2+
## CodeScanAI Action
3+
4+
The action wraps the [codescan-ai](https://github.com/codescan-ai/codescan) project that helps scan your codebase for bad coding practices and potential security vulnerabilty.
5+
6+
## Inputs
7+
8+
| name | description | required | default |
9+
| --- | --- | --- | --- |
10+
| `version` | <p>Version of CodeScanAI to install</p> | `false` | `latest` |
11+
| `provider` | <p>AI provider to use</p> | `true` | `""` |
12+
| `model` | <p>AI model from the provider to use</p> | `false` | `""` |
13+
| `directory` | <p>Directory to scan</p> | `false` | `.` |
14+
| `changes_only` | <p>Scans only files with recent changes</p> | `false` | `false` |
15+
| `repo` | <p>GitHub repository</p> | `false` | `""` |
16+
| `pr_number` | <p>Pull request number</p> | `false` | `""` |
17+
| `github_token` | <p>GitHub API token</p> | `false` | `""` |
18+
| `host` | <p>Custom AI server host</p> | `false` | `""` |
19+
| `port` | <p>Custom AI server port</p> | `false` | `""` |
20+
| `token` | <p>Token for authenticating with the custom AI server</p> | `false` | `""` |
21+
| `endpoint` | <p>API endpoint for the custom server</p> | `false` | `/api/v1/scan` |
22+
| `output_file` | <p>Optional output file to store CodeScanAI results</p> | `false` | `""` |
23+
24+
25+
## Runs
26+
27+
This action is a `composite` action.
28+
29+
## Usage
30+
31+
```yaml
32+
- uses: codescanai/codescanai-action@v1.0.0
33+
with:
34+
version:
35+
# Version of CodeScanAI to install
36+
#
37+
# Required: false
38+
# Default: latest
39+
40+
provider:
41+
# AI provider to use
42+
#
43+
# Required: true
44+
# Default: ""
45+
46+
model:
47+
# AI model from the provider to use
48+
#
49+
# Required: false
50+
# Default: ""
51+
52+
directory:
53+
# Directory to scan
54+
#
55+
# Required: false
56+
# Default: .
57+
58+
changes_only:
59+
# Scans only files with recent changes
60+
#
61+
# Required: false
62+
# Default: false
63+
64+
repo:
65+
# GitHub repository
66+
#
67+
# Required: false
68+
# Default: ""
69+
70+
pr_number:
71+
# Pull request number
72+
#
73+
# Required: false
74+
# Default: ""
75+
76+
github_token:
77+
# GitHub API token
78+
#
79+
# Required: false
80+
# Default: ""
81+
82+
host:
83+
# Custom AI server host
84+
#
85+
# Required: false
86+
# Default: ""
87+
88+
port:
89+
# Custom AI server port
90+
#
91+
# Required: false
92+
# Default: ""
93+
94+
token:
95+
# Token for authenticating with the custom AI server
96+
#
97+
# Required: false
98+
# Default: ""
99+
100+
endpoint:
101+
# API endpoint for the custom server
102+
#
103+
# Required: false
104+
# Default: /api/v1/scan
105+
106+
output_file:
107+
# Optional output file to store CodeScanAI results
108+
#
109+
# Required: false
110+
# Default: ""
111+
```
1112
<!-- action-docs-all source="action.yml" project="codescanai/codescanai-action" version="v1.0.0" -->

0 commit comments

Comments
 (0)