Skip to content

Commit

Permalink
docs: suite folded
Browse files Browse the repository at this point in the history
  • Loading branch information
Ma11hewThomas committed Oct 31, 2024
1 parent 0f52419 commit 908d7ef
Show file tree
Hide file tree
Showing 4 changed files with 14 additions and 60 deletions.
68 changes: 11 additions & 57 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,16 +123,6 @@ For a failed test details table, add the `failed` command to your workflow yaml:
if: always()
```

### Generating Failed Folded Test Details Table

For a failed test table with details folded, add the `failed-folded` command to your workflow yaml:

```yaml
- name: Publish CTRF Failed Test Summary Results
run: npx github-actions-ctrf failed-folded path-to-your-ctrf-report.json
if: always()
```

### Generating Failed Rate Test Details Table

To see the failed test rate over time, add the `failed-rate` command to your workflow yaml:
Expand Down Expand Up @@ -181,6 +171,16 @@ To see which tests were skipped or pending, add the `skipped` command to your wo
if: always()
```

### Generating Suite Folded Table

To see which tests grouped by suite with tests folkded, add the `suite-folded` command to your workflow yaml:

```yaml
- name: Publish CTRF Suite Folded Summary
run: npx github-actions-ctrf suite-folded path-to-your-ctrf-report.json
if: always()
```

### Generating Previous Tests Table

To see results from previous tests, add the `historical` command to your workflow yaml:
Expand Down Expand Up @@ -442,48 +442,6 @@ Overall Fail Rate across all tests is calculated by summing the fail counts and

Overall Fail Rate (%) = (Total Fail Counts of All Tests ÷ Total Runs of All Tests) × 100

## Alternative Installation Options

### Locking to a Specific Version with `npx`

The easiest way to run `github-actions-ctrf` is by using `npx`, which doesn't require installation. By default, it runs the latest version. However, if you'd like to lock to a specific version, you can do so by specifying the version:

```bash
npx github-actions-ctrf@1.2.3 path-to-your-ctrf-report.json
```

This command will download and run the specified version of `github-actions-ctrf`.

### Local Installation in Your Node.js Project

For users who prefer installing the package locally to their project, you can install `github-actions-ctrf` as a project dependency:

```bash
npm install github-actions-ctrf
```

This will install `github-actions-ctrf` into your `node_modules` folder, and you can run it with the following command:

```bash
./node_modules/.bin/github-actions-ctrf path-to-your-ctrf-report.json
```

Alternatively, you can add a script to your `package.json` to simplify the command:

```json
{
"scripts": {
"report": "github-actions-ctrf path-to-your-ctrf-report.json"
}
}
```

Now, you can run:

```bash
npm run report
```

## Components

[Click here](https://github.com/ctrf-io/github-actions-ctrf/actions) to see the Actions of this repository for a full example
Expand All @@ -500,13 +458,9 @@ npm run report

![Failed](images/failed.png)

### Failed Folded details

![Failed Folded](images/failed-folded.png)

### Failed rate

![Failed Rate](images/failed-rate.png)
![Failed](images/failed-rate.png)

### AI summary

Expand Down
Binary file added images/suite-folded.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "github-actions-ctrf",
"version": "0.0.46",
"version": "0.0.47",
"description": "View test results directly within your GitHub workflow summary and Pull Requests",
"main": "index.js",
"scripts": {
Expand Down

0 comments on commit 908d7ef

Please sign in to comment.