Skip to content

Print actionable error message when --check finds stale files#3487

Open
immanuwell wants to merge 1 commit into
open-telemetry:mainfrom
immanuwell:check-mode-error-message
Open

Print actionable error message when --check finds stale files#3487
immanuwell wants to merge 1 commit into
open-telemetry:mainfrom
immanuwell:check-mode-error-message

Conversation

@immanuwell
Copy link
Copy Markdown
Contributor

@immanuwell immanuwell commented May 29, 2026

Summary

update-sig-tables.py and update-community-members.py support --check mode (used by make check-generate in CI).
When generated file is out of date, they currently exit with code 1 but print no output - leaving developers with only a bare exit-code failure in CI logs and no indication of which file is stale or how to fix it.

This PR adds a one-line stderr message in both scripts so failure is self-explanatory:

README.md is out of date. Run 'make generate' to update it.
community-members.md is out of date. Run 'make generate' to update it.

The success path (exit 0, no output) is unchanged

Test plan

  • python3 scripts/update-sig-tables.py --check -> exit 0, no output (files are up to date)
  • python3 scripts/update-community-members.py --check -> exit 0, no output
  • Simulated stale README.md -> exit 1 + message on stderr
  • Simulated stale community-members.md -> exit 1 + message on stderr
  • python3 scripts/validate-workstreams.py still passes

@linux-foundation-easycla
Copy link
Copy Markdown

linux-foundation-easycla Bot commented May 29, 2026

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: immanuwell / name: immanuwell (268e5ab)

@immanuwell immanuwell force-pushed the check-mode-error-message branch from 44b4a04 to b62598d Compare May 29, 2026 04:39
Previously both update-sig-tables.py and update-community-members.py
silently exited with code 1 when run in --check mode and the generated
file was out of date, making CI failures hard to diagnose. Now they
print a clear message to stderr naming the file and the remediation
command ('make generate').

Signed-off-by: immanuwell <pchpr.00@list.ru>
@immanuwell immanuwell force-pushed the check-mode-error-message branch from b62598d to 268e5ab Compare May 29, 2026 04:43
Copy link
Copy Markdown
Member

@arminru arminru left a comment

Choose a reason for hiding this comment

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

Thank you!

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