#!/usr/bin/env python3 """Clean violation patterns from dacli source comments. Targets 6 patterns from check_clean_comments.sh: 1. BS-[a-zA-Z]*[0-9] 2. R[0-9]+[a-z]* 3. Round[0-9]+ 4. jxcj|workSystem|developSystem|tds 5. v0.XX.YY+ 6. ssw-XXX-biz/common Only modifies comment lines (//, *, /*). """ import re, sys, os def clean_line(line: str) -> str: """Clean one line. Returns '' to delete the line entirely.""" s = line.strip() if not (s.startswith('//') or s.startswith('*') or s.startswith('/*')): return line # code line, don't touch # --- Pattern 1: BS-* tags --- # Delete lines that are ONLY a BS tag comment (no other useful content) if re.match(r'^\s*//\s*BS-\S+\s*(?:fix|修复|修正|强化|兜底)?\s*$', line): return '' if re.match(r'^\s*\*\s*BS-\S+\s*(?:fix|修复|修正|强化|兜底)?\s*$', line): return '' # Strip BS tag from mixed-content lines: "// BS-XX fix: real text" -> "// real text" line = re.sub(r'BS-\S+\s*(?:fix|修复|修正|强化|兜底)?\s*:\s*', '', line) line = re.sub(r'BS-\S+\s+', '', line) # "// BS-XX explanation" -> "// explanation" # --- Pattern 2: R tags --- if re.match(r'^\s*//\s*R\d+[a-z]*\s*$', line): return '' if re.match(r'^\s*\*\s*R\d+[a-z]*\s*$', line): return '' line = re.sub(r'R\d+[a-z]*\s+P\d+-\d+\s*:\s*', '', line) line = re.sub(r'R\d+[a-z]*\s*(?:fix|修复|修正)?\s*:\s*', '', line) line = re.sub(r'R\d+[a-z]*\s+', '', line) # --- Pattern 3: Round tags --- if re.match(r'^\s*//\s*Round\d+\s*$', line): return '' if re.match(r'^\s*\*\s*Round\d+\s*$', line): return '' line = re.sub(r'Round\d+\s+BS-\S+\s*:\s*', '', line) line = re.sub(r'Round\d+\s+', '', line) # --- Pattern 4: jxcj/workSystem/developSystem/tds --- # Only in comments. Replace with generic term. line = re.sub(r'\bjxcj\b', 'app', line) line = re.sub(r'\bworkSystem\b', 'reference app', line) line = re.sub(r'\bdevelopSystem\b', 'reference app', line) line = re.sub(r'\btds\b', 'app', line) # --- Pattern 5: v0.x+ version markers (handle v0.10, v0.10.1, v0.11h+, v0.21+) --- if re.match(r'^\s*//\s*v0\.\d+(?:\.\d+)?[a-z]*\+?\s*$', line): return '' if re.match(r'^\s*\*\s*v0\.\d+(?:\.\d+)?[a-z]*\+?\s*$', line): return '' line = re.sub(r'v0\.\d+(?:\.\d+)?[a-z]*\+?\s*(?:fix|修复|修正)?\s*:\s*', '', line) line = re.sub(r'v0\.\d+(?:\.\d+)?[a-z]*\+?\s+', '', line) # --- Pattern 6: ssw-*-biz/ssw-common --- # Only in comments. Remove or simplify. line = re.sub(r'ssw-[a-z]+-biz', 'ssw module', line) line = re.sub(r'ssw-common', 'shared module', line) # --- Additional cleanup: dates, B-*, P* tags in comments --- line = re.sub(r'\(\d{4}-\d{2}-\d{2}\)\s*', '', line) line = re.sub(r'\(\d{4}-\d{2}-\d{2}\s+[^)]+\)\s*:?\s*', '', line) line = re.sub(r'\d{4}-\d{2}-\d{2}\s+', '', line) line = re.sub(r'B-\d+\s*(?:fix|修复)?\s*:\s*', '', line) line = re.sub(r'P[01]-\d+\s*(?:fix|修复|兜底)?\s*:\s*', '', line) # --- Cleanup whitespace --- line = re.sub(r'//\s{2,}', '// ', line) line = re.sub(r'\*\s{2,}', '* ', line) # Delete line if it became just empty comment noise stripped = line.strip() if stripped in ('//', '// fix:', '// 修复:', '// 修正:', '*', '* fix:', '* 修复:', '// app', '* app', '// app M1', '* app M1', '// ssw module', '* ssw module', '// shared module', '* shared module'): return '' # Remove leading "修复: " or "fix: " at comment start (when marker was prefix) line = re.sub(r'^(\s*//\s*)(?:fix:|修复:|修正:|强化:|兜底:)\s*', r'\1', line) line = re.sub(r'^(\s*\*\s*)(?:fix:|修复:|修正:|强化:|兜底:)\s*', r'\1', line) # After all stripping, if main content is gone, delete if re.match(r'^\s*//\s*$', line): return '' if re.match(r'^\s*\*\s*$', line): return '' return line def clean_file(filepath: str) -> int: with open(filepath, 'r', encoding='utf-8') as f: lines = f.readlines() new_lines = [] modified = 0 for line in lines: cleaned = clean_line(line) if cleaned != line: modified += 1 if cleaned: new_lines.append(cleaned) elif cleaned == '': continue else: new_lines.append(line) if modified > 0: with open(filepath, 'w', encoding='utf-8') as f: f.writelines(new_lines) return modified def main(): files = sys.argv[1:] if not files: print("Usage: clean_comments.py [file2 ...]") sys.exit(1) total = 0 for f in files: if not os.path.exists(f): print(f"SKIP: {f}") continue n = clean_file(f) total += n print(f" {n:4d} lines: {f}") print(f"Total: {total} lines modified across {len(files)} files") if __name__ == '__main__': main()