feat: create script to update versions automatically #132

shenxianpeng · 2025-10-20T19:45:22Z

closes #123

Summary by CodeRabbit

Chores
- Automated version detection for clang-format and clang-tidy is now scheduled weekly, running every Monday at 2:00 UTC via GitHub Actions.
- Version updates from PyPI are automatically fetched and integrated, eliminating the need for manual version maintenance.

codecov · 2025-10-20T19:46:32Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.44%. Comparing base (cb96c23) to head (75397a4).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #132      +/-   ##
==========================================
+ Coverage   94.39%   94.44%   +0.05%     
==========================================
  Files           3        4       +1     
  Lines         107      108       +1     
==========================================
+ Hits          101      102       +1     
  Misses          6        6

☔ View full report in Codecov by Sentry.
📢 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.

Copilot

Pull Request Overview

This PR introduces an automated system for updating clang-format and clang-tidy versions from PyPI. The implementation extracts version constants into a dedicated module and adds a Python script with GitHub Actions workflow to periodically fetch and update these versions.

Key changes:

Created a dedicated versions.py module containing version constants for clang-format and clang-tidy
Added an automation script that fetches latest versions from PyPI and updates the versions file
Configured a GitHub Actions workflow to run the update script weekly and create PRs with version updates

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
cpp_linter_hooks/versions.py	New module containing extracted version constants with automation-ready structure
scripts/update_versions.py	Script that fetches versions from PyPI and updates the versions.py file programmatically
cpp_linter_hooks/util.py	Refactored to import version constants from the new versions module instead of defining them inline
tests/test_util.py	Updated imports to reference version constants from the new versions module
.github/workflows/update-versions.yml	GitHub Actions workflow for automated weekly version updates via pull requests

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

scripts/update_versions.py

Copilot · 2025-10-20T19:52:50Z

scripts/update_versions.py

+            stable_versions = [
+                v
+                for v in versions
+                if not any(char in v for char in ["a", "b", "rc", "dev"])


The pre-release filtering logic is flawed. Checking if single characters 'a' or 'b' exist in version strings will incorrectly filter out valid stable versions. For example, version '18.1.8' contains 'a' and would be excluded. Use regex pattern matching or check for specific pre-release patterns like 'alpha', 'beta', 'rc', 'dev' instead.

Suggested change

stable_versions = [

v

for v in versions

if not any(char in v for char in ["a", "b", "rc", "dev"])

# Exclude pre-releases: versions with 'aN', 'bN', 'rcN', or '.devN' suffixes

pre_release_pattern = re.compile(r"(a|b|rc|\.dev)\d+", re.IGNORECASE)

stable_versions = [

v

for v in versions

if not pre_release_pattern.search(v)

scripts/update_versions.py

codspeed-hq · 2025-10-20T19:55:12Z

CodSpeed Performance Report

Merging #132 will not alter performance

_{Comparing fix-123 (75397a4) with main (cb96c23)}

Summary

✅ 60 untouched
⏩ 13 skipped¹

13 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

sonarqubecloud · 2025-10-20T19:59:42Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

coderabbitai · 2025-10-20T20:23:47Z

Caution

Review failed

The pull request is closed.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

This PR implements automated version management for clang-format and clang-tidy tools. It creates a centralized versions module, a PyPI-based version fetcher script, and a GitHub Actions workflow that periodically updates version lists from PyPI. Existing imports are refactored to use the new centralized versions module.

Changes

Cohort / File(s)	Summary
GitHub Actions Automation `.github/workflows/update-versions.yml`	Introduces scheduled workflow (weekly on Mondays) that runs a Python script to update tool versions, checks for changes, and creates an automated pull request with updated version data.
Version Management Module `cpp_linter_hooks/versions.py`	New module that centrally stores `CLANG_FORMAT_VERSIONS` and `CLANG_TIDY_VERSIONS` as hardcoded lists marked for automatic updates by GitHub Actions.
Version Update Script `scripts/update_versions.py`	New script that fetches stable versions from PyPI API, filters out pre-releases, and updates `cpp_linter_hooks/versions.py` with new version lists. Includes `fetch_versions_from_pypi()` and `update_versions_file()` functions.
Import Refactoring `cpp_linter_hooks/util.py`, `tests/test_util.py`	Updates to import version lists from `cpp_linter_hooks.versions` instead of defining them locally in `util.py`.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

The changes span multiple components (CI workflow, new script with API/file I/O logic, module refactoring), but are cohesively scoped to version automation with clear separation of concerns. The PyPI API interaction and regex-based string replacement in the update script require careful review, while import refactoring is straightforward.

Possibly related PRs

Migration: From Clang Tools Binaries to Python Wheels #87: Related to how clang-format/clang-tidy version lists are extracted and managed across modules
fix: get rid of toml and packaging and improve performance #89: Related to changes in version sourcing and resolution logic in cpp_linter_hooks/util.py
fix: simplify tool installation and invocation #113: Related to overall refactoring of clang tool version handling and management in the codebase

✨ Finishing touches

📝 Generate docstrings

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch fix-123

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between cb96c23 and 75397a4.

📒 Files selected for processing (5)

.github/workflows/update-versions.yml (1 hunks)
cpp_linter_hooks/util.py (1 hunks)
cpp_linter_hooks/versions.py (1 hunks)
scripts/update_versions.py (1 hunks)
tests/test_util.py (1 hunks)

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 and usage tips.}

feat: create script to update versions automaticlly

c31b410

shenxianpeng marked this pull request as ready for review October 20, 2025 19:45

chore: use full commit SHA hash for this dependency

518be04

shenxianpeng requested a review from Copilot October 20, 2025 19:52

Copilot AI reviewed Oct 20, 2025

View reviewed changes

shenxianpeng changed the title ~~feat: create script to update versions automaticlly~~ feat: create script to update versions automatically Oct 20, 2025

shenxianpeng added 2 commits October 20, 2025 22:58

fix: update update_versions.py

07ec87c

fix: update update_versions.py

75397a4

shenxianpeng added the enhancement New feature or request label Oct 20, 2025

shenxianpeng merged commit 805dfc4 into main Oct 20, 2025
17 of 18 checks passed

shenxianpeng deleted the fix-123 branch October 20, 2025 20:20

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: create script to update versions automatically #132

feat: create script to update versions automatically #132

Uh oh!

shenxianpeng commented Oct 20, 2025 •

edited by coderabbitai bot

Loading

Uh oh!

codecov bot commented Oct 20, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Oct 20, 2025

Uh oh!

Uh oh!

codspeed-hq bot commented Oct 20, 2025 •

edited

Loading

Uh oh!

sonarqubecloud bot commented Oct 20, 2025

Uh oh!

Uh oh!

coderabbitai bot commented Oct 20, 2025

Review failed

Other AI code review bot(s) detected

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

feat: create script to update versions automatically #132

feat: create script to update versions automatically #132

Uh oh!

Conversation

shenxianpeng commented Oct 20, 2025 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

codecov bot commented Oct 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Copilot AI Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

codspeed-hq bot commented Oct 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CodSpeed Performance Report

Merging #132 will not alter performance

Summary

Footnotes

Uh oh!

sonarqubecloud bot commented Oct 20, 2025

Quality Gate passed

Uh oh!

Uh oh!

coderabbitai bot commented Oct 20, 2025

Review failed

Other AI code review bot(s) detected

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

shenxianpeng commented Oct 20, 2025 •

edited by coderabbitai bot

Loading

codecov bot commented Oct 20, 2025 •

edited

Loading

codspeed-hq bot commented Oct 20, 2025 •

edited

Loading