@code-pushup/cli 0.12.2 → 0.12.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -4
- package/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -23,6 +23,8 @@ _If you're looking for programmatic usage, then refer to the underlying [@code-p
|
|
|
23
23
|
## Getting started
|
|
24
24
|
|
|
25
25
|
1. Install as a dev dependency with your package manager:
|
|
26
|
+
<details>
|
|
27
|
+
<summary>Installation command for <code>npm</code>, <code>yarn</code> and <code>pnpm</code></summary>
|
|
26
28
|
|
|
27
29
|
```sh
|
|
28
30
|
npm install --save-dev @code-pushup/cli
|
|
@@ -36,6 +38,8 @@ _If you're looking for programmatic usage, then refer to the underlying [@code-p
|
|
|
36
38
|
pnpm add --save-dev @code-pushup/cli
|
|
37
39
|
```
|
|
38
40
|
|
|
41
|
+
</details>
|
|
42
|
+
|
|
39
43
|
2. Create a `code-pushup.config.js` configuration file (`.ts` or `.mjs` extensions are also supported).
|
|
40
44
|
|
|
41
45
|
```js
|
|
@@ -64,7 +68,13 @@ _If you're looking for programmatic usage, then refer to the underlying [@code-p
|
|
|
64
68
|
};
|
|
65
69
|
```
|
|
66
70
|
|
|
67
|
-
4.
|
|
71
|
+
4. Run the CLI with `npx code-pushup` (see `--help` for list of commands and arguments).
|
|
72
|
+
|
|
73
|
+
5. View report file(s) in output directory (specified by `persist.outputDir` configuration).
|
|
74
|
+
|
|
75
|
+
### Set up categories (optional)
|
|
76
|
+
|
|
77
|
+
1. Define your custom categories.
|
|
68
78
|
|
|
69
79
|
```js
|
|
70
80
|
export default {
|
|
@@ -89,9 +99,9 @@ _If you're looking for programmatic usage, then refer to the underlying [@code-p
|
|
|
89
99
|
};
|
|
90
100
|
```
|
|
91
101
|
|
|
92
|
-
|
|
102
|
+
2. Run the CLI with `npx code-pushup`.
|
|
93
103
|
|
|
94
|
-
|
|
104
|
+
3. View report file(s) including category section in output directory.
|
|
95
105
|
|
|
96
106
|
## Portal integration
|
|
97
107
|
|
|
@@ -170,13 +180,15 @@ Each example is fully tested to demonstrate best practices for plugin testing as
|
|
|
170
180
|
> All common options, except `--onlyPlugins`, can be specified in the configuration file as well.
|
|
171
181
|
> CLI arguments take precedence over configuration file options.
|
|
172
182
|
|
|
173
|
-
> [!NOTE]
|
|
183
|
+
> [!NOTE]
|
|
174
184
|
> The `--upload.*` group of options is applicable to all commands except `collect`.
|
|
175
185
|
|
|
176
186
|
### Commands
|
|
177
187
|
|
|
178
188
|
#### `collect` command
|
|
179
189
|
|
|
190
|
+
<img src="./docs/images/cli-run-stdout-example.png" width="400" alt="example of code-pushup terminal output">
|
|
191
|
+
|
|
180
192
|
Usage:
|
|
181
193
|
`code-pushup collect [options]`
|
|
182
194
|
|
package/index.js
CHANGED
|
@@ -1533,7 +1533,7 @@ var verboseUtils = (verbose) => ({
|
|
|
1533
1533
|
|
|
1534
1534
|
// packages/core/package.json
|
|
1535
1535
|
var name = "@code-pushup/core";
|
|
1536
|
-
var version = "0.12.
|
|
1536
|
+
var version = "0.12.3";
|
|
1537
1537
|
|
|
1538
1538
|
// packages/core/src/lib/implementation/execute-plugin.ts
|
|
1539
1539
|
import chalk4 from "chalk";
|