Skip to content

ENH: Adding badges to README.md for project health overview - #103

Merged
aylward merged 1 commit into
Project-MONAI:mainfrom
aylward:badges
Aug 1, 2026
Merged

ENH: Adding badges to README.md for project health overview#103
aylward merged 1 commit into
Project-MONAI:mainfrom
aylward:badges

Conversation

@aylward

@aylward aylward commented Aug 1, 2026

Copy link
Copy Markdown
Collaborator

Summary by CodeRabbit

  • Documentation
    • Added project status, documentation, package, license, tooling, and quality badges to the README.

Copilot AI review requested due to automatic review settings August 1, 2026 17:34
@coderabbitai

coderabbitai Bot commented Aug 1, 2026

Copy link
Copy Markdown

Walkthrough

Changes

README documentation

Layer / File(s) Summary
Add project and tooling badges
README.md
Adds linked badges for CI, documentation, nightly health, coverage, PyPI, Python version, license, Ruff, mypy, and pre-commit.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Suggested reviewers: copilot

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the README badge additions, which are the main changes in the pull request.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a set of project “health” and metadata badges at the top of README.md to give readers an at-a-glance view of CI status, docs builds, nightly health, coverage, and key tooling.

Changes:

  • Added GitHub Actions workflow badges for CI, documentation, and nightly health.
  • Added project metadata/tooling badges (PyPI, supported Python versions, license, Ruff, mypy, pre-commit).
  • Added Codecov coverage badge.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 5: Replace the Nightly Health badge’s endpoint URL and target with the
existing GitHub Actions workflow badge/source, so the README directly reflects
the nightly-health workflow status instead of the nightly-status Pages endpoint.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1da5baaa-b716-4a69-9c75-93a9e72ab994

📥 Commits

Reviewing files that changed from the base of the PR and between 59ca5e6 and af61481.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md

[![CI](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/ci.yml/badge.svg)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/ci.yml)
[![Documentation](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/docs.yml/badge.svg)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/docs.yml)
[![Nightly Health](https://img.shields.io/endpoint?url=https://project-monai.github.io/physiotwin4d/status.json)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "README line:"
sed -n '1,20p' README.md 2>/dev/null || true

echo
echo "Relevant workflow:"
if [ -f .github/workflows/nightly-health.yml ]; then
  sed -n '1,220p' .github/workflows/nightly-health.yml
else
  echo ".github/workflows/nightly-health.yml not found"
fi

echo
echo "Endpoint status response (if reachable):"
python3 - <<'PY'
import json, urllib.request, urllib.error
url = "https://project-monai.github.io/physiotwin4d/status.json"
try:
    with urllib.request.urlopen(url, timeout=20) as r:
        print("status", r.status)
        text = r.read().decode("utf-8", "replace")
        print("body", text[:2000])
        try:
            data = json.loads(text)
            print("parsed_message", data.get("message"))
            print("parsed_color", data.get("color"))
        except Exception as e:
            print("parse_error", repr(e))
except Exception as e:
    print("error", repr(e))
PY

Repository: Project-MONAI/physiotwin4d

Length of output: 12076


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "Build dashboard script:"
if [ -f .github/scripts/build_dashboard.py ]; then
  sed -n '1,240p' .github/scripts/build_dashboard.py
else
  echo ".github/scripts/build_dashboard.py not found"
fi

echo
echo "Upload dashboard artifact steps:"
rg -n -C 6 "Upload dashboard|upload-artifact|status\.json|project-monai\.github\." README.md .github/workflows/nightly-health.yml .github/scripts/build_dashboard.py || true

Repository: Project-MONAI/physiotwin4d

Length of output: 22793


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "docs.yml deployment status handling:"
if [ -f .github/workflows/docs.yml ]; then
  sed -n '1,260p' .github/workflows/docs.yml
else
  echo ".github/workflows/docs.yml not found"
fi

echo
echo "Docs workflow references for status.json and Pages output:"
rg -n -C 6 "status\.json|pages|upload-pages-artifact|ghp-*|nightly-status|continues-on-error|continue-on-error" .github/workflows/docs.yml README.md || true

Repository: Project-MONAI/physiotwin4d

Length of output: 9507


Use the GitHub Actions status badge for nightly health.

The README links to the nightly-status Pages endpoint, but the direct endpoint source returns a self-signed certificate error in the sandbox. The workflow already documents the Actions badge as the live pass/fail README indicator, and the generated endpoint uses unknown/critical when test results are unavailable. Use the Actions badge instead of the endpoint link.

Proposed change
-[![Nightly Health](https://img.shields.io/endpoint?url=https://project-monai.github.io/physiotwin4d/status.json)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml)
+[![Nightly Health](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml/badge.svg)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
[![Nightly Health](https://img.shields.io/endpoint?url=https://project-monai.github.io/physiotwin4d/status.json)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml)
[![Nightly Health](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml/badge.svg)](https://github.com/Project-MONAI/physiotwin4d/actions/workflows/nightly-health.yml)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` at line 5, Replace the Nightly Health badge’s endpoint URL and
target with the existing GitHub Actions workflow badge/source, so the README
directly reflects the nightly-health workflow status instead of the
nightly-status Pages endpoint.

@aylward
aylward merged commit 66cd788 into Project-MONAI:main Aug 1, 2026
7 checks passed
@aylward
aylward deleted the badges branch August 1, 2026 17:36
@codecov

codecov Bot commented Aug 1, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 35.40%. Comparing base (775e4ba) to head (af61481).
⚠️ Report is 25 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #103      +/-   ##
==========================================
- Coverage   35.99%   35.40%   -0.60%     
==========================================
  Files          58       63       +5     
  Lines        7292     8203     +911     
==========================================
+ Hits         2625     2904     +279     
- Misses       4667     5299     +632     
Flag Coverage Δ
integration-tests 35.20% <ø> (?)
unittests 35.40% <ø> (-0.60%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants