Skip to content

Commit 0c5abfd

Browse files
authored
docs: update readme and change-notes. (#202)
* docs: update readme and change-notes. Signed-off-by: Chao Wang <[email protected]> * docs: update. Signed-off-by: Chao Wang <[email protected]> * docs: static proxy configration clarification Signed-off-by: Chao Wang <[email protected]> --------- Signed-off-by: Chao Wang <[email protected]>
1 parent b26b080 commit 0c5abfd

File tree

2 files changed

+39
-13
lines changed

2 files changed

+39
-13
lines changed

README.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,16 @@
1313
Red Hat Dependency Analytics (RHDA) plugin gives you awareness to security concerns within your software supply chain
1414
while you build your application.
1515

16-
<br >Dependency Analytics only supports the following project ecosystems:
17-
- Maven
18-
- Node
19-
- Golang
20-
- Python
21-
- Gradle
16+
<br>Dependency Analytics supports multiple package managers:
17+
- Maven (mvn)
18+
- NPM (npm)
19+
- PNPM (pnpm)
20+
- Yarn Berry and Classic (yarn)
21+
- Gradle Kotlin and Groovy (gradle)
22+
- Golang (go mod)
23+
- Python (pip) ecosystems, and base images in Dockerfile.
24+
25+
In future releases, Red Hat plans to support other package managers.
2226

2327
<br >**NOTE:**
2428
The Red Hat Dependency Analytics plugin is an online service hosted and maintained by Red Hat.
@@ -47,7 +51,7 @@ vulnerability report.
4751
- For Golang projects, analyzing a `go.mod` file, you must have the `go` binary in your IDE's `PATH` environment. Furthermore, Golang projects can only be analyzed with IntelliJ Ultimate Edition.
4852
- For Python projects, analyzing a `requirements.txt` file, you must have the `python3` and `pip3` binaries in your
4953
IDE's `PATH` environment.
50-
- For Gradle projects, analyzing a `build.gradle` file, you must have the `gradle` binary in your system's `PATH` environment.
54+
- For Gradle projects, analyzing a `build.gradle` file or `build.gradle.kts` file, you must have the `gradle` binary in your system's `PATH` environment.
5155
- For base images, analyzing a `Dockerfile`, you must have the [`syft`](https://github.com/anchore/syft?tab=readme-ov-file#installation) and [`skopeo`](https://github.com/containers/skopeo/blob/main/install.md) binaries in your IDE's `PATH` environment.
5256

5357
**Procedure**
@@ -144,7 +148,7 @@ according to your preferences.
144148
vulnerabilities.
145149

146150
- **Proxy Configuration** :
147-
<br >From IntelliJ IDEA Appearance & Behavior > System Settings > HTTP Proxy, you can configure a proxy for all HTTP requests made by the plugin. This is useful when your environment requires going through a proxy to access external services. For example:`http://proxy.example.com:8080`
151+
<br >From IntelliJ IDEA Appearance & Behavior > System Settings > HTTP Proxy, you can configure a static proxy for all HTTP requests made by the plugin. This is useful when your environment requires going through a proxy to access external services. For example:`http://proxy.example.com:8080`
148152

149153
## Features
150154

src/main/resources/META-INF/plugin.xml

Lines changed: 27 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,15 @@
2020
displaying the vulnerability report.
2121
<p>
2222
<b>IMPORTANT:</b>
23-
<br>Currently, Dependency Analytics only supports projects that use Maven (<code>mvn</code>), and Node
24-
(<code>npm</code>, <code>pnpm</code> or <code>yarn</code>), Golang (<code>go mod</code>) and Python (<code>pip</code>) ecosystems, and base images in
25-
<code>Dockerfile</code>.
26-
<br>In future releases, Red Hat plans to support other programming languages.
23+
<br>Dependency Analytics supports multiple package managers:
24+
<li>Maven (mvn)</li>
25+
<li>NPM (npm)</li>
26+
<li>PNPM (pnpm)</li>
27+
<li>Yarn Berry and Classic (yarn)</li>
28+
<li>Gradle Kotlin and Groovy (gradle)</li>
29+
<li>Golang (go mod)</li>
30+
<li>Python (pip) ecosystems, and base images in Dockerfile.</li>
31+
<br>In future releases, Red Hat plans to support other package managers.</br>
2732
<p>
2833
2934
<h2>Quick Start</h2>
@@ -34,14 +39,17 @@
3439
IDE's <code>PATH</code> environment.
3540
</li>
3641
<li>For Node projects, analyzing a <code>package.json</code> file, you must have one of the corresponding package manager <code>npm</code>, <code>pnpm</code> or <code>yarn</code> and
37-
<code>node</code> binaries in your IDE's <code>PATH</code> environment.
42+
<code>node</code> binaries in your IDE's <code>PATH</code> environment. It also requires a corresponding lock file to be present in order to analyze package.json files.
3843
</li>
3944
<li>For Golang projects, analyzing a <code>go.mod</code> file, you must have the <code>go</code> binary in your
4045
IDE's <code>PATH</code> environment. Furthermore, Golang projects can only be analyzed with IntelliJ Ultimate Edition.
4146
</li>
4247
<li>For Python projects, analyzing a <code>requirements.txt</code> file, you must have the <code>python3</code> and
4348
<code>pip3</code> binaries in your IDE's <code>PATH</code> environment.
4449
</li>
50+
<li>
51+
For Gradle projects, analyzing a <code>build.gradle</code> file or <code>build.gradle.kts</code> file, you must have the <code>gradle</code> binary in your system's <code>PATH</code> environment.
52+
</li>
4553
<li>For base images, analyzing a <code>Dockerfile</code>, you must have the <code><a
4654
href="https://github.com/anchore/syft?tab=readme-ov-file#installation" rel="noopener noreferrer"
4755
target="_blank">syft</a></code> and
@@ -114,6 +122,7 @@
114122
executable.
115123
<br>If the paths are not provided, your IDE's <code>PATH</code> environment will be used to locate the
116124
executables.
125+
<br>It also requires a corresponding lock file to be present in order to analyze package.json files.
117126
</li>
118127
<li>
119128
<b>Golang</b>:
@@ -142,6 +151,13 @@
142151
dynamically instead. This feature cannot be enabled when <code>Strictly match package version</code> is
143152
selected.
144153
</li>
154+
<li>
155+
<b>Gradle</b>:
156+
<br>Set the full path of the Gradle executable, which allows Exhort to locate and run the <code>gradle</code>
157+
command to resolve dependencies for Gradle projects.
158+
<br>By not setting a path to the gradle binary, IntelliJ IDEA uses its default path environment to locate
159+
the file.
160+
</li>
145161
<li>
146162
<b>Image</b>:
147163
<br>Set the full path of the Syft executable, which allows Exhort to locate and execute the <code>syft</code>
@@ -376,6 +392,12 @@
376392
<change-notes><![CDATA[
377393
<p><b>1.1.0</b></p>
378394
<p>Added support for Gradle manifest files.</p>
395+
<p>Added support for Yarn.</p>
396+
<p>Added support for PNPM.</p>
397+
<p>Added support for Proxy setting(Static Proxy Configuration).</p>
398+
<p>Enable using the Maven Wrapper.</p>
399+
<p>No restart needed after installation.</p>
400+
<p>Require a lock file to be present in order to analyze package.json files.</p>
379401
<p><b>1.0.0</b></p>
380402
<p>Added support for base image vulnerability scanning in Dockerfiles.</p>
381403
<p>Bumped Telemetry plugin to 1.1.0.</p>

0 commit comments

Comments
 (0)