Skip to content

Commit d2c55e0

Browse files
Feat/file report (#175)
1 parent 2eb578a commit d2c55e0

File tree

2 files changed

+43
-58
lines changed

2 files changed

+43
-58
lines changed

README.md

Lines changed: 42 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,18 @@ analyses directly within your GitHub Actions CI/CD workflow and Pull Requests.
1010
Choose from a variety of pre-built reports or create custom reports tailored to
1111
your project's needs, ensuring that test results are always where you need them.
1212

13+
14+
<div align="center">
15+
<h2>⭐ Support Us ⭐</h2>
16+
<h3>If you like what you see, drop us a star ⭐</h3>
17+
<h3>It helps more teams find the project and motivates us to keep building! 💚</h3>
18+
</div>
19+
20+
1321
<div align="center">
1422
<div style="padding: 1.5rem; border-radius: 8px; margin: 1rem 0; border: 1px solid #30363d;">
1523
<span style="font-size: 23px;">💚</span>
1624
<h3 style="margin: 1rem 0;">CTRF tooling is open source and free to use</h3>
17-
<p style="font-size: 16px;">You can support the project with a follow and a star</p>
1825

1926
<div style="margin-top: 1.5rem;">
2027
<a href="https://github.com/ctrf-io/github-test-reporter">
@@ -27,63 +34,35 @@ your project's needs, ensuring that test results are always where you need them.
2734
</div>
2835

2936
<p style="font-size: 14px; margin: 1rem 0;">
30-
Maintained by <a href="https://github.com/ma11hewthomas">Matthew Thomas</a><br/>
3137
Contributions are very welcome! <br/>
3238
Explore more <a href="https://www.ctrf.io/integrations">integrations</a>
3339
</p>
3440
</div>
3541

3642
## Key Features
3743

38-
### 📊 Comprehensive Test Reports
39-
40-
Access powerful built-in reports including:
41-
42-
- 📈 Historical Test Trends
43-
- 📝 Detailed Test Results
44-
- ❌ Failed Tests Overview
45-
- 🔁 Flaky Tests Analysis
46-
47-
### 🎨 Custom Report Builder
48-
49-
Create and customize your own test reports with our flexible templating system.
50-
Perfect for teams with specific reporting needs or unique project requirements.
51-
52-
### 🤖 AI-Powered Test Analysis
53-
54-
Get intelligent insights on test failures with our AI-generated reports. Quickly
55-
understand why tests failed and how to fix them using leading AI models.
56-
57-
### 🔌 Universal Framework Support
58-
59-
Compatible with all major testing frameworks through standardized CTRF reports
60-
61-
## Report Showcase
62-
63-
Checkout all the built-in reports [here](docs/report-showcase.md)
64-
65-
## Visual Overview
66-
67-
| ![all](images/all.png) | ![ai](images/github-failed.png) | ![flaky-rate](images/insights.png) | ![historical](images/historical.png) | ![pr](images/pr.png) |
68-
| :--------------------------------------: | :----------------------------------------: | :----------------------------------: | :--------------------------: | :----------------------------------: |
69-
| ![suite-folded](images/suite-folded.png) | ![ai](images/ai.png) | ![custom](images/custom.png) | ![failed](images/failed.png) | ![suite-list](images/suite-list.png) |
44+
- 🧩 Post anywhere — job summaries, pull requests, checks, issues, inline annotations, and other developer tools
45+
- 📊 Built-in insights for failures, flaky tests, and trends across hundreds of runs
46+
- 🧘 Super flexible — start fast with powerful built-in reports or go fully custom with your own templates
47+
- 🤖 AI-powered analysis explains why tests failed — and how to fix them
48+
- 🔌 Framework-agnostic — works with any testing tool
7049

7150
## Table of Contents
7251

7352
1. [Usage](#usage)
74-
2. [Available Inputs](#available-inputs)
75-
3. [Pull Requests](#pull-requests)
76-
4. [Status Checks](#status-checks)
77-
5. [Build Your Own Report](#build-your-own-report)
78-
6. [Customizing Report Order](#customizing-report-order)
79-
7. [Community Reports](#community-reports)
80-
8. [GitHub Token](#github-token)
81-
9. [Storing Artifacts](#storing-artifacts)
82-
10. [Filtering](#filtering)
83-
11. [Integrations](#integrations)
84-
12. [Generating an AI Report](#generating-an-ai-report)
85-
13. [Run With NPX](#run-with-npx)
86-
14. [Report Showcase](#report-showcase)
53+
2. [Report Showcase](#report-showcase)
54+
3. [Visual Overview](#visual-overview)
55+
4. [Available Inputs](#available-inputs)
56+
5. [Pull Requests](#pull-requests)
57+
6. [Status Checks](#status-checks)
58+
7. [Build Your Own Report](#build-your-own-report)
59+
8. [Customizing Report Order](#customizing-report-order)
60+
9. [Community Reports](#community-reports)
61+
10. [GitHub Token](#github-token)
62+
11. [Storing Artifacts](#storing-artifacts)
63+
12. [Filtering](#filtering)
64+
13. [Integrations](#integrations)
65+
14. [Generating an AI Report](#generating-an-ai-report)
8766
15. [What is CTRF?](#what-is-ctrf)
8867

8968
## Usage
@@ -95,25 +74,31 @@ To get started add the following to your workflow file:
9574
uses: ctrf-io/github-test-reporter@v1
9675
with:
9776
report-path: './ctrf/*.json'
77+
github-report: true
9878
if: always()
9979
```
10080
101-
This will publish the default reports `summary-report`, `failed-report`,
102-
`flaky-report`, `skipped-report`, and `test-report` to the job summary.
81+
## Report Showcase
82+
83+
Checkout all the built-in reports [here](docs/report-showcase.md)
84+
85+
## Visual Overview
86+
87+
| ![all](images/all.png) | ![github](images/github-failed.png) | ![flaky-rate](images/insights.png) | ![historical](images/historical.png) | ![pr](images/pr.png) |
88+
| :--------------------------------------: | :----------------------------------------: | :----------------------------------: | :--------------------------: | :----------------------------------: |
89+
| ![suite-folded](images/suite-folded.png) | ![ai](images/ai.png) | ![custom](images/custom.png) | ![failed](images/failed.png) | ![suite-list](images/suite-list.png) |
10390
104-
## Generate a CTRF report
91+
## Generate a report
10592
106-
[CTRF reporters](https://ctrf.io/integrations) are available for
107-
most testing frameworks and easy to install.
93+
You need a CTRF or JUnit report.
10894
109-
**No CTRF reporter? No problem!**
95+
This reporter works best with a CTRF as it's packed with modern properties. [CTRF reporters](https://ctrf.io/integrations) are available for most testing frameworks and easy to install.
11096
111-
Use the [JUnit to CTRF integration](docs/integrations.md#junit-to-ctrf-integration) or [junit-to-ctrf](https://github.com/ctrf-io/junit-to-ctrf) cli to convert a JUnit
112-
report to CTRF.
97+
For more details on using JUnit, see [JUnit integration instructions](docs/integrations.md#junit-to-ctrf-integration)
11398
11499
## Available Inputs
115100
116-
There are several inputs available
101+
For more advanced usage, there are several inputs available.
117102
118103
```yaml
119104
- name: Publish Test Report
@@ -123,7 +108,7 @@ There are several inputs available
123108
report-path: './ctrf/*.json' # Path or glob pattern to the CTRF report JSON file.
124109
template-path: './templates/custom-summary.hbs' # Path to the Handlebars template for customizing markdown output.
125110

126-
# Reports - Choose as many as you like. Default is false
111+
# Reports - Choose as many as you like. Default is false. Choosing none will use default reports.
127112
summary-report: true
128113
github-report: false
129114
test-report: false

__tests__/ctrf/report-preparation.test.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -600,4 +600,4 @@ function createSingleReportInputs(): Inputs {
600600
statusCheckName: '',
601601
reportOrder: []
602602
}
603-
}
603+
}

0 commit comments

Comments
 (0)