소스 코드 Python



import os import re import sys # ────────────────────────────────────────────────────────────────────── # 1. 환경 설정 및 정규식 정의 # ────────────────────────────────────────────────────────────────────── REQ_ID_PATTERN = re.compile(r'\b(REQ-[A-Z]{3}-\d{3})\b') ERR_CODE_PATTERN = re.compile(r'\b(ERR-[A-Z]{3}-\d{3})\b') # 예시용 단순 경로 지정 (실제 구동 환경에 맞게 조정 필요) TERMINOLOGY_PATH = "docs/terminology.md" ERROR_POLICY_PATH = "docs/error-code-policy.md" PRD_DIR = "docs/prd/" # ────────────────────────────────────────────────────────────────────── # 2. 형상 기준 데이터 로드 로직 # ────────────────────────────────────────────────────────────────────── def load_allowed_terms(filepath): """표준 용어집 문서에서 정의된 표준 명칭들을 파싱하여 셋(Set)으로 반환합니다.""" allowed_terms = set() if not os.path.exists(filepath): print(f"[경고] 표준 용어집 파일이 없습니다: {filepath}") return allowed_terms # 예시: '## 용어 사전' 이하 영역의 목록 패턴에서 백틱(`) 기호 내부의 단어 추출 term_pattern = re.compile(r'-\s+`([^`]+)`') with open(filepath, 'r', encoding='utf-8') as f: for line in f: match = term_pattern.search(line) if match: allowed_terms.add(match.group(1).strip()) return allowed_terms def load_defined_error_codes(filepath): """에러 코드 정책 문서에서 승인된 에러 코드 목록을 파싱하여 반환합니다.""" defined_codes = set() if not os.path.exists(filepath): print(f"[경고] 에러 코드 정책 파일이 없습니다: {filepath}") return defined_codes with open(filepath, 'r', encoding='utf-8') as f: for line in f: matches = ERR_CODE_PATTERN.findall(line) for code in matches: defined_codes.add(code) return defined_codes # ────────────────────────────────────────────────────────────────────── # 3. 개별 사양서 파일 유효성 검증 엔진 # ────────────────────────────────────────────────────────────────────── def verify_specification_file(filepath, allowed_terms, defined_error_codes): """개별 마크다운 사양서 파일의 정합성을 검증합니다.""" errors_found = [] seen_req_ids = set() with open(filepath, 'r', encoding='utf-8') as f: lines = f.readlines() for idx, line in enumerate(lines, start=1): clean_line = line.strip() if not clean_line or clean_line.startswith('```'): continue # 코드 블록 경계선은 검사 제외 # 가) 요구사항 ID 중복 여부 판정 req_matches = REQ_ID_PATTERN.findall(clean_line) for req_id in req_matches: # 사양서 정의 구문(예: '#### REQ-...' 등으로 시작하는 경우)에서 중복 선언 판정 if clean_line.startswith('#') and req_id in seen_req_ids: errors_found.append(f"[{idx}행] 중복된 요구사항 ID 선언 감지: {req_id}") elif clean_line.startswith('#'): seen_req_ids.add(req_id) # 나) 에러 코드 일관성 검정 (정책서에 정의된 정식 코드인가?) err_matches = ERR_CODE_PATTERN.findall(clean_line) for err_code in err_matches: if err_code not in defined_error_codes: errors_found.append(f"[{idx}행] 정의되지 않은 불법 에러 코드 참조 감지: {err_code}") return errors_found # ────────────────────────────────────────────────────────────────────── # 4. 메인 컨트롤러 실행 루틴 # ────────────────────────────────────────────────────────────────────── def main(): print("[형상관리 시스템] 소프트웨어 사양서 정적 분석 및 자동화 검증을 시작합니다...") # 지식 베이스 기준 데이터 로딩 allowed_terms = load_allowed_terms(TERMINOLOGY_PATH) defined_errors = load_defined_error_codes(ERROR_POLICY_PATH) print(f"- 로드된 표준 용어 수: {len(allowed_terms)}") print(f"- 로드된 공식 에러 코드 수: {len(defined_errors)}") all_errors = {} if not os.path.exists(PRD_DIR): print(f"[오류] 검증 대상 사양서 디렉토리가 존재하지 않습니다: {PRD_DIR}") sys.exit(1) # 디렉토리 내 모든 마크다운 사양서 탐색 for root, _, files in os.walk(PRD_DIR): for file in files: if file.endswith('.md'): full_path = os.path.join(root, file) file_errors = verify_specification_file(full_path, allowed_terms, defined_errors) if file_errors: all_errors[full_path] = file_errors # ────────────────────────────────────────────────────────────────────── # 5. 최종 검증 결과 출력 및 품질 게이트 통제 # ────────────────────────────────────────────────────────────────────── if all_errors: print("\n" + "="*80) print("[실패] 사양서 정합성 검증 실패! 아래 위반 사항을 수정해야 합니다.") print("="*80) for filepath, errors in all_errors.items(): print(f"\n▶ 파일 경로: {filepath}") for err in errors: print(f" {err}") print("\n[안내] 이 오류가 해결되지 않으면 품질 게이트 규칙에 따라 버전 머지가 제한됩니다.") sys.exit(1) # 에러 코드를 반환하여 빌드 또는 커밋 차단 else: print("\n" + "="*80) print("[성공] 모든 사양서의 정합성이 완벽하게 일치합니다. 검증 빌드 통과!") print("="*80) sys.exit(0) # 무사히 커밋 및 머지 프로세스 진행 if __name__ == "__main__": main()+