Create README.md

Author: farid-zare

community-reports/cobra-report/README.md

@@ -0,0 +1,78 @@
+```markdown
+# Template Name: cobra-report
+
+## Description
+
+The **cobra-report** template is designed for the COBRA Toolbox to provide a concise overview of your test suite results. It displays key metrics including the total number of tests, passed tests, failed tests, and skipped tests. Additionally, when failures occur, it renders a detailed table listing each failed test along with its failure message.
+
+---
+
+## How to Use
+
+Reference this template by its name in your workflow configuration:
+
+```
+cobra-report
+```
+
+Then, add it to your workflow file as follows:
+
+```yaml
+- name: Publish Test Report
+  uses: ctrf-io/github-test-reporter@v1
+  with:
+    report-path: './ctrf/*.json'
+    community-report: true
+    communty-reportn-name: cobra-report
+  if: always()
+```
+
+Ensure your report JSON files are generated correctly and placed in the expected path.
+
+## Important Considerations
+
+- **JSON Structure:** Verify that your test results JSON conforms to the expected format, so that the template can correctly parse the summary values and test statuses.
+- **Custom Helpers:** This template utilizes custom helpers such as `getCtrfEmoji`, `formatMessage`, and `anyFailedTests`. Make sure these are available in your environment.
+- **Conditional Rendering:** The detailed table of failed tests will only appear if there is at least one test with a `failed` status.
+
+## What it Looks Like
+
+### Summary Section
+
+| **Tests 📝** | **Passed ✅** | **Failed ❌** | **Skipped ⏭️** |
+| --- | --- | --- | --- |
+| {{ctrf.summary.tests}} | {{ctrf.summary.passed}} | {{ctrf.summary.failed}} | {{ctrf.summary.skipped}} |
+
+### Failed Tests Details
+
+{{#if (anyFailedTests ctrf.tests)}}
+<table>
+  <thead>
+    <tr>
+      <th>Failed Tests {{getCtrfEmoji "failed"}}</th>
+      <th>Fail Message</th>
+    </tr>
+  </thead>
+  <tbody>
+    {{#each ctrf.tests}}
+      {{#if (eq status "failed")}}
+      <tr>
+        <td>{{getCtrfEmoji "failed"}} {{name}}</td>
+        <td>
+          {{#if message}}
+            {{~{formatMessage message}}}
+          {{else}}
+            No failure message
+          {{/if}}
+        </td>
+      </tr>
+      {{/if}}
+    {{/each}}
+  </tbody>
+</table>
+{{else}}
+<p>No failed tests ✨</p>
+{{/if}}
+
+This template provides a streamlined and effective overview of your testing performance, making it easy to identify issues and monitor overall progress.
+```