Merge commit 'ac794a6a7051497ff60b947642d44f0f8c04d6c6' into lsp-server

This commit is contained in:
csh
2026-01-08 15:56:37 +08:00
113 changed files with 254751 additions and 176 deletions
@@ -0,0 +1,332 @@
#!/usr/bin/env sh
# CI 模板验证脚本
set -eu
echo "========================================"
echo "🔧 CI 模板验证"
echo "========================================"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
PLAYBOOK_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
TEMPLATES_DIR="$PLAYBOOK_ROOT/templates/ci"
VALIDATION_PASSED=0
VALIDATION_FAILED=0
ERRORS_FILE="/tmp/ci_template_validation_errors.txt"
REPORT_FILE="$SCRIPT_DIR/ci_validation_report.txt"
> "$ERRORS_FILE"
> "$REPORT_FILE"
echo "📁 模板目录: $TEMPLATES_DIR"
echo ""
# ============================================
# 辅助函数
# ============================================
validate_file_exists() {
local file="$1"
local description="$2"
if [ -f "$file" ]; then
echo "$description: $(basename "$file")"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
return 0
else
echo "$description: $(basename "$file") - 文件不存在"
echo "文件不存在: $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
}
validate_yaml_syntax() {
local file="$1"
local description="$2"
if ! command -v yamllint >/dev/null 2>&1; then
echo " ⚠️ $description: 跳过(yamllint 未安装)"
return 0
fi
if yamllint -d relaxed "$file" >/dev/null 2>&1; then
echo "$description: YAML 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
return 0
else
echo "$description: YAML 语法错误"
echo "YAML 语法错误: $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
}
validate_workflow_structure() {
local file="$1"
echo " 📋 检查 workflow 结构:"
# 检查必要字段
if grep -q "^name:" "$file"; then
echo " ✓ 包含 name 字段"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 name 字段"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
if grep -q "^on:" "$file"; then
echo " ✓ 包含 on 触发器"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 on 触发器"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
if grep -q "^jobs:" "$file"; then
echo " ✓ 包含 jobs 定义"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 jobs 定义"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
# 检查 runs-on
if grep -q "runs-on:" "$file"; then
runner=$(grep "runs-on:" "$file" | head -1 | awk '{print $2}')
echo " ✓ 配置了 runner: $runner"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 runs-on 配置"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
# 检查 steps
if grep -q "steps:" "$file"; then
step_count=$(grep -c "^ - name:" "$file" || echo 0)
echo " ✓ 包含 $step_count 个步骤"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 steps 定义"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
}
# ============================================
# 查找并验证 Gitea workflow 文件
# ============================================
echo "🔍 查找 Gitea workflow 文件"
GITEA_WORKFLOWS_DIR="$TEMPLATES_DIR/gitea/.gitea/workflows"
if [ ! -d "$GITEA_WORKFLOWS_DIR" ]; then
echo "⚠️ Gitea workflows 目录不存在: $GITEA_WORKFLOWS_DIR"
echo "跳过 Gitea workflow 验证"
else
WORKFLOW_FILES=$(find "$GITEA_WORKFLOWS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null || true)
if [ -z "$WORKFLOW_FILES" ]; then
echo "⚠️ 未找到 Gitea workflow 文件"
else
for workflow in $WORKFLOW_FILES; do
echo ""
echo "🔍 验证 $(basename "$workflow")"
if validate_file_exists "$workflow" "$(basename "$workflow")"; then
# 验证 YAML 语法
validate_yaml_syntax "$workflow" "$(basename "$workflow")"
# 验证 workflow 结构
validate_workflow_structure "$workflow"
# 检查是否包含中文注释(符合项目风格)
if grep -q "# .*[\u4e00-\u9fa5]" "$workflow" 2>/dev/null || grep -qP "[\x{4e00}-\x{9fa5}]" "$workflow" 2>/dev/null; then
echo " ✓ 包含中文注释(符合项目风格)"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 检查配置区域标记
if grep -q "# ====.*配置.*====" "$workflow"; then
echo " ✓ 包含配置区域标记"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 检查环境变量配置
if grep -q "^env:" "$workflow"; then
echo " ✓ 包含环境变量配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
done
fi
fi
echo ""
# ============================================
# 查找并验证 GitHub Actions workflow 文件
# ============================================
echo "🔍 查找 GitHub Actions workflow 文件"
GITHUB_WORKFLOWS_DIR="$TEMPLATES_DIR/github/.github/workflows"
if [ -d "$GITHUB_WORKFLOWS_DIR" ]; then
WORKFLOW_FILES=$(find "$GITHUB_WORKFLOWS_DIR" -name "*.yml" -o -name "*.yaml" 2>/dev/null || true)
if [ -n "$WORKFLOW_FILES" ]; then
for workflow in $WORKFLOW_FILES; do
echo ""
echo "🔍 验证 $(basename "$workflow")"
if validate_file_exists "$workflow" "$(basename "$workflow")"; then
# 验证 YAML 语法
validate_yaml_syntax "$workflow" "$(basename "$workflow")"
# 验证 workflow 结构
validate_workflow_structure "$workflow"
fi
done
fi
else
echo "️ GitHub Actions workflows 目录不存在(可选)"
fi
echo ""
# ============================================
# 验证特定 workflow 模板
# ============================================
echo "🔍 验证特定 workflow 模板"
# 检查 standards-check workflow
STANDARDS_CHECK="$GITEA_WORKFLOWS_DIR/standards-check.yml"
if [ -f "$STANDARDS_CHECK" ]; then
echo ""
echo "📋 验证 standards-check.yml:"
# 检查是否包含格式化检查
if grep -q "格式化\|format" "$STANDARDS_CHECK"; then
echo " ✓ 包含格式化检查"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 检查是否包含 lint 检查
if grep -q "lint\|检查" "$STANDARDS_CHECK"; then
echo " ✓ 包含 lint 检查"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
else
echo "️ 未找到 standards-check.yml(可选)"
fi
# 检查 test workflow
TEST_WORKFLOW="$GITEA_WORKFLOWS_DIR/test.yml"
if [ -f "$TEST_WORKFLOW" ]; then
echo ""
echo "📋 验证 test.yml:"
# 检查是否包含测试步骤
if grep -q "测试\|test" "$TEST_WORKFLOW"; then
echo " ✓ 包含测试步骤"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 检查是否配置了测试矩阵
if grep -q "strategy:" "$TEST_WORKFLOW" && grep -q "matrix:" "$TEST_WORKFLOW"; then
echo " ✓ 配置了测试矩阵"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
else
echo "️ 未找到 test.yml(可选)"
fi
echo ""
# ============================================
# 验证 README 文档
# ============================================
echo "🔍 验证 CI 模板文档"
if [ -d "$TEMPLATES_DIR" ]; then
# 查找 README
README_FILE=""
for name in README.md readme.md README README.txt; do
if [ -f "$TEMPLATES_DIR/$name" ]; then
README_FILE="$TEMPLATES_DIR/$name"
break
fi
done
if [ -n "$README_FILE" ]; then
echo " ✅ 找到说明文档: $(basename "$README_FILE")"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
# 检查文档内容
if grep -qi "使用\|usage\|how to" "$README_FILE"; then
echo " ✓ 包含使用说明"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
else
echo " ⚠️ 未找到 README 文档(建议添加)"
fi
fi
echo ""
# ============================================
# 生成验证报告
# ============================================
echo "========================================"
echo "📊 验证结果统计"
echo "========================================"
echo "✅ 通过: $VALIDATION_PASSED"
echo "❌ 失败: $VALIDATION_FAILED"
if [ $((VALIDATION_PASSED + VALIDATION_FAILED)) -gt 0 ]; then
echo "📈 通过率: $(awk "BEGIN {printf \"%.1f\", ($VALIDATION_PASSED * 100.0) / ($VALIDATION_PASSED + $VALIDATION_FAILED)}")%"
else
echo "📈 通过率: N/A (无测试项)"
fi
echo ""
# 写入报告文件
{
echo "CI 模板验证报告"
echo "===================="
echo ""
echo "验证时间: $(date '+%Y-%m-%d %H:%M:%S')"
echo "模板目录: $TEMPLATES_DIR"
echo ""
echo "统计结果:"
echo " 通过: $VALIDATION_PASSED"
echo " 失败: $VALIDATION_FAILED"
if [ $((VALIDATION_PASSED + VALIDATION_FAILED)) -gt 0 ]; then
echo " 通过率: $(awk "BEGIN {printf \"%.1f\", ($VALIDATION_PASSED * 100.0) / ($VALIDATION_PASSED + $VALIDATION_FAILED)}")%"
fi
echo ""
if [ -s "$ERRORS_FILE" ]; then
echo "错误详情:"
cat "$ERRORS_FILE"
fi
} > "$REPORT_FILE"
echo "📄 详细报告: $REPORT_FILE"
echo "========================================"
# 清理临时文件
rm -f "$ERRORS_FILE"
# 返回结果
if [ "$VALIDATION_FAILED" -eq 0 ]; then
echo "✅ 所有 CI 模板验证通过"
exit 0
else
echo "❌ CI 模板验证失败 ($VALIDATION_FAILED 个错误)"
exit 1
fi
@@ -0,0 +1,353 @@
#!/usr/bin/env sh
# C++ 模板验证脚本
set -eu
echo "========================================"
echo "⚙️ C++ 模板验证"
echo "========================================"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
PLAYBOOK_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
TEMPLATES_DIR="$PLAYBOOK_ROOT/templates/cpp"
VALIDATION_PASSED=0
VALIDATION_FAILED=0
ERRORS_FILE="/tmp/cpp_template_validation_errors.txt"
REPORT_FILE="$SCRIPT_DIR/cpp_validation_report.txt"
> "$ERRORS_FILE"
> "$REPORT_FILE"
echo "📁 模板目录: $TEMPLATES_DIR"
echo ""
# ============================================
# 辅助函数
# ============================================
validate_file_exists() {
local file="$1"
local description="$2"
if [ -f "$file" ]; then
echo "$description: $(basename "$file")"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
return 0
else
echo "$description: $(basename "$file") - 文件不存在"
echo "文件不存在: $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
}
validate_cmake_syntax() {
local file="$1"
local description="$2"
# 基础语法检查
if [ ! -s "$file" ]; then
echo "$description: 文件为空"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
# 检查必要的 CMake 命令
local has_errors=0
if ! grep -q "cmake_minimum_required" "$file"; then
echo " ✗ 缺少 cmake_minimum_required"
has_errors=1
fi
if ! grep -q "project(" "$file"; then
echo " ✗ 缺少 project()"
has_errors=1
fi
if [ $has_errors -eq 0 ]; then
echo "$description: CMake 基础语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
return 0
else
echo "$description: CMake 语法检查失败"
echo "CMake 语法错误: $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
}
# ============================================
# 验证 CMakeLists.txt
# ============================================
echo "🔍 验证 CMakeLists.txt"
CMAKE_FILE="$TEMPLATES_DIR/CMakeLists.txt"
if validate_file_exists "$CMAKE_FILE" "CMakeLists.txt"; then
# 验证 CMake 语法
validate_cmake_syntax "$CMAKE_FILE" "CMakeLists.txt"
echo " 📋 检查 C++23 配置:"
# 检查 C++23 标准
if grep -q "CMAKE_CXX_STANDARD 23" "$CMAKE_FILE"; then
echo " ✓ 配置了 C++23 标准"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 未配置 C++23 标准"
echo "未配置 C++23: $CMAKE_FILE" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
# 检查 Modules 支持
if grep -q "CMAKE_CXX_SCAN_FOR_MODULES" "$CMAKE_FILE"; then
echo " ✓ 启用了 C++ Modules 扫描"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ⚠️ 未启用 C++ Modules 扫描(可选)"
fi
# 检查 import std; 支持
if grep -q "CMAKE_EXPERIMENTAL_CXX_IMPORT_STD" "$CMAKE_FILE"; then
echo " ✓ 启用了 import std; 支持"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ⚠️ 未启用 import std; 支持(可选)"
fi
# 检查编译命令导出
if grep -q "CMAKE_EXPORT_COMPILE_COMMANDS" "$CMAKE_FILE"; then
echo " ✓ 启用了编译命令导出(用于 clangd)"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ⚠️ 未启用编译命令导出"
fi
fi
echo ""
# ============================================
# 验证 .clang-format
# ============================================
echo "🔍 验证 .clang-format"
CLANG_FORMAT="$TEMPLATES_DIR/.clang-format"
if validate_file_exists "$CLANG_FORMAT" ".clang-format"; then
# 验证 YAML 语法
if command -v yamllint >/dev/null 2>&1; then
if yamllint -d relaxed "$CLANG_FORMAT" >/dev/null 2>&1; then
echo " ✓ YAML 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ YAML 语法错误"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
# 验证关键配置
echo " 📋 检查格式化配置:"
if grep -q "^Language:" "$CLANG_FORMAT" && grep -q "Cpp" "$CLANG_FORMAT"; then
echo " ✓ 配置了 Language: Cpp"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
if grep -q "^BasedOnStyle:" "$CLANG_FORMAT"; then
style=$(grep "^BasedOnStyle:" "$CLANG_FORMAT" | awk '{print $2}')
echo " ✓ 基于风格: $style"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
if grep -q "^Standard:" "$CLANG_FORMAT"; then
std=$(grep "^Standard:" "$CLANG_FORMAT" | awk '{print $2}')
echo " ✓ C++ 标准: $std"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 检查缩进配置
if grep -q "^IndentWidth:" "$CLANG_FORMAT"; then
echo " ✓ 配置了缩进宽度"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 验证 .clangd
# ============================================
echo "🔍 验证 .clangd"
CLANGD="$TEMPLATES_DIR/.clangd"
if validate_file_exists "$CLANGD" ".clangd"; then
# 验证 YAML 语法
if command -v yamllint >/dev/null 2>&1; then
if yamllint -d relaxed "$CLANGD" >/dev/null 2>&1; then
echo " ✓ YAML 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ YAML 语法错误"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
# 验证 CompileFlags
echo " 📋 检查 clangd 配置:"
if grep -q "CompileFlags:" "$CLANGD"; then
echo " ✓ 包含 CompileFlags 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
# 检查 C++23 标准
if grep -q "std=c++23" "$CLANGD"; then
echo " ✓ 配置了 -std=c++23"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
# 验证 CompilationDatabase
if grep -q "CompilationDatabase:" "$CLANGD"; then
echo " ✓ 配置了 CompilationDatabase 路径"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 验证 Index 配置
if grep -q "Index:" "$CLANGD"; then
echo " ✓ 配置了索引选项"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 验证 conanfile.txt
# ============================================
echo "🔍 验证 conanfile.txt"
CONANFILE="$TEMPLATES_DIR/conanfile.txt"
if validate_file_exists "$CONANFILE" "conanfile.txt"; then
echo " 📋 检查 Conan 配置:"
# 验证必要的节
if grep -q "^\[requires\]" "$CONANFILE"; then
echo " ✓ 包含 [requires] 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ⚠️ 缺少 [requires] 配置(可选)"
fi
if grep -q "^\[generators\]" "$CONANFILE"; then
echo " ✓ 包含 [generators] 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
# 检查 CMakeDeps 和 CMakeToolchain
if grep -q "CMakeDeps" "$CONANFILE"; then
echo " ✓ 配置了 CMakeDeps 生成器"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
if grep -q "CMakeToolchain" "$CONANFILE"; then
echo " ✓ 配置了 CMakeToolchain 生成器"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
if grep -q "^\[options\]" "$CONANFILE"; then
echo " ✓ 包含 [options] 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 验证 CMakeUserPresets.json
# ============================================
echo "🔍 验证 CMakeUserPresets.json"
CMAKE_PRESETS="$TEMPLATES_DIR/CMakeUserPresets.json"
if validate_file_exists "$CMAKE_PRESETS" "CMakeUserPresets.json"; then
# 验证 JSON 语法
if command -v python3 >/dev/null 2>&1; then
if python3 -m json.tool "$CMAKE_PRESETS" >/dev/null 2>&1; then
echo " ✓ JSON 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ JSON 语法错误"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
# 验证配置项
echo " 📋 检查 CMake Presets:"
if grep -q "\"version\"" "$CMAKE_PRESETS"; then
echo " ✓ 包含 version 字段"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
if grep -q "\"configurePresets\"" "$CMAKE_PRESETS"; then
echo " ✓ 包含 configurePresets"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
if grep -q "\"buildPresets\"" "$CMAKE_PRESETS"; then
echo " ✓ 包含 buildPresets"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 生成验证报告
# ============================================
echo "========================================"
echo "📊 验证结果统计"
echo "========================================"
echo "✅ 通过: $VALIDATION_PASSED"
echo "❌ 失败: $VALIDATION_FAILED"
echo "📈 通过率: $(awk "BEGIN {printf \"%.1f\", ($VALIDATION_PASSED * 100.0) / ($VALIDATION_PASSED + $VALIDATION_FAILED)}")%"
echo ""
# 写入报告文件
{
echo "C++ 模板验证报告"
echo "===================="
echo ""
echo "验证时间: $(date '+%Y-%m-%d %H:%M:%S')"
echo "模板目录: $TEMPLATES_DIR"
echo ""
echo "统计结果:"
echo " 通过: $VALIDATION_PASSED"
echo " 失败: $VALIDATION_FAILED"
echo " 通过率: $(awk "BEGIN {printf \"%.1f\", ($VALIDATION_PASSED * 100.0) / ($VALIDATION_PASSED + $VALIDATION_FAILED)}")%"
echo ""
if [ -s "$ERRORS_FILE" ]; then
echo "错误详情:"
cat "$ERRORS_FILE"
fi
} > "$REPORT_FILE"
echo "📄 详细报告: $REPORT_FILE"
echo "========================================"
# 清理临时文件
rm -f "$ERRORS_FILE"
# 返回结果
if [ "$VALIDATION_FAILED" -eq 0 ]; then
echo "✅ 所有 C++ 模板验证通过"
exit 0
else
echo "❌ C++ 模板验证失败 ($VALIDATION_FAILED 个错误)"
exit 1
fi
@@ -0,0 +1,329 @@
#!/usr/bin/env sh
# Python 模板验证脚本
set -eu
echo "========================================"
echo "🐍 Python 模板验证"
echo "========================================"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
PLAYBOOK_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
TEMPLATES_DIR="$PLAYBOOK_ROOT/templates/python"
VALIDATION_PASSED=0
VALIDATION_FAILED=0
ERRORS_FILE="/tmp/python_template_validation_errors.txt"
REPORT_FILE="$SCRIPT_DIR/python_validation_report.txt"
> "$ERRORS_FILE"
> "$REPORT_FILE"
echo "📁 模板目录: $TEMPLATES_DIR"
echo ""
# ============================================
# 辅助函数
# ============================================
validate_file_exists() {
local file="$1"
local description="$2"
if [ -f "$file" ]; then
echo "$description: $(basename "$file")"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
return 0
else
echo "$description: $(basename "$file") - 文件不存在"
echo "文件不存在: $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
}
validate_toml_syntax() {
local file="$1"
local description="$2"
if ! command -v python3 >/dev/null 2>&1; then
echo " ⚠️ $description: 跳过(Python3 未安装)"
return 0
fi
if python3 << EOF
import sys
try:
import tomli
except ImportError:
try:
import tomllib as tomli
except ImportError:
import toml as tomli
try:
with open("$file", "rb") as f:
tomli.load(f)
sys.exit(0)
except Exception as e:
print(f"TOML 语法错误: {e}", file=sys.stderr)
sys.exit(1)
EOF
then
echo "$description: TOML 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
return 0
else
echo "$description: TOML 语法错误"
echo "TOML 语法错误: $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
return 1
fi
}
validate_required_sections() {
local file="$1"
local sections="$2"
for section in $sections; do
if grep -q "^\[$section\]" "$file"; then
echo " ✓ 包含 [$section] 配置"
else
echo " ✗ 缺少 [$section] 配置"
echo "缺少配置节: $section in $file" >> "$ERRORS_FILE"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
done
}
# ============================================
# 验证 pyproject.toml
# ============================================
echo "🔍 验证 pyproject.toml"
PYPROJECT="$TEMPLATES_DIR/pyproject.toml"
if validate_file_exists "$PYPROJECT" "pyproject.toml"; then
# 验证 TOML 语法
validate_toml_syntax "$PYPROJECT" "pyproject.toml"
# 验证必要的配置节
echo " 📋 检查必要配置节:"
validate_required_sections "$PYPROJECT" "tool.black tool.isort tool.pytest.ini_options"
# 验证 black 配置
if grep -q "line-length = 80" "$PYPROJECT"; then
echo " ✓ black line-length 配置正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ black line-length 配置缺失或不正确"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
# 验证 isort 配置
if grep -q "profile = \"google\"" "$PYPROJECT"; then
echo " ✓ isort profile 配置正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ isort profile 配置缺失或不正确"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
echo ""
# ============================================
# 验证 .flake8
# ============================================
echo "🔍 验证 .flake8"
FLAKE8="$TEMPLATES_DIR/.flake8"
if validate_file_exists "$FLAKE8" ".flake8"; then
# 验证 [flake8] 节
if grep -q "^\[flake8\]" "$FLAKE8"; then
echo " ✓ 包含 [flake8] 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
# 验证 max-line-length
if grep -q "^max-line-length" "$FLAKE8"; then
echo " ✓ 配置了 max-line-length"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 max-line-length 配置"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
# 验证 extend-ignore
if grep -q "^extend-ignore" "$FLAKE8" || grep -q "^ignore" "$FLAKE8"; then
echo " ✓ 配置了错误忽略规则"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
else
echo " ✗ 缺少 [flake8] 配置节"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
echo ""
# ============================================
# 验证 .pylintrc
# ============================================
echo "🔍 验证 .pylintrc"
PYLINTRC="$TEMPLATES_DIR/.pylintrc"
if validate_file_exists "$PYLINTRC" ".pylintrc"; then
# 验证关键配置节
for section in "MASTER" "MESSAGES CONTROL" "FORMAT"; do
if grep -qi "^\[$section\]" "$PYLINTRC"; then
echo " ✓ 包含 [$section] 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ 缺少 [$section] 配置"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
done
# 验证 max-line-length
if grep -q "^max-line-length" "$PYLINTRC"; then
echo " ✓ 配置了 max-line-length"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 验证 .pre-commit-config.yaml
# ============================================
echo "🔍 验证 .pre-commit-config.yaml"
PRECOMMIT="$TEMPLATES_DIR/.pre-commit-config.yaml"
if validate_file_exists "$PRECOMMIT" ".pre-commit-config.yaml"; then
# 验证 YAML 语法
if command -v yamllint >/dev/null 2>&1; then
if yamllint -d relaxed "$PRECOMMIT" >/dev/null 2>&1; then
echo " ✓ YAML 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ YAML 语法错误"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
# 验证包含 pre-commit hooks
if grep -q "^repos:" "$PRECOMMIT"; then
echo " ✓ 包含 repos 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
# 检查常用 hooks
for hook in "black" "isort" "flake8"; do
if grep -q "$hook" "$PRECOMMIT"; then
echo " ✓ 配置了 $hook hook"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
done
fi
fi
echo ""
# ============================================
# 验证 .editorconfig
# ============================================
echo "🔍 验证 .editorconfig"
EDITORCONFIG="$TEMPLATES_DIR/.editorconfig"
if validate_file_exists "$EDITORCONFIG" ".editorconfig"; then
# 验证包含 root 标记
if grep -q "^root = true" "$EDITORCONFIG"; then
echo " ✓ 包含 root = true"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
# 验证 Python 配置节
if grep -q "^\[\*.py\]" "$EDITORCONFIG" || grep -q "^\[*.py\]" "$EDITORCONFIG"; then
echo " ✓ 包含 Python 文件配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 验证 VSCode 配置
# ============================================
echo "🔍 验证 .vscode/settings.json"
VSCODE_SETTINGS="$TEMPLATES_DIR/.vscode/settings.json"
if validate_file_exists "$VSCODE_SETTINGS" "settings.json"; then
# 验证 JSON 语法
if command -v python3 >/dev/null 2>&1; then
if python3 -m json.tool "$VSCODE_SETTINGS" >/dev/null 2>&1; then
echo " ✓ JSON 语法正确"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
else
echo " ✗ JSON 语法错误"
VALIDATION_FAILED=$((VALIDATION_FAILED + 1))
fi
fi
# 验证 Python 相关配置
if grep -q "python" "$VSCODE_SETTINGS"; then
echo " ✓ 包含 Python 配置"
VALIDATION_PASSED=$((VALIDATION_PASSED + 1))
fi
fi
echo ""
# ============================================
# 生成验证报告
# ============================================
echo "========================================"
echo "📊 验证结果统计"
echo "========================================"
echo "✅ 通过: $VALIDATION_PASSED"
echo "❌ 失败: $VALIDATION_FAILED"
echo "📈 通过率: $(awk "BEGIN {printf \"%.1f\", ($VALIDATION_PASSED * 100.0) / ($VALIDATION_PASSED + $VALIDATION_FAILED)}")%"
echo ""
# 写入报告文件
{
echo "Python 模板验证报告"
echo "===================="
echo ""
echo "验证时间: $(date '+%Y-%m-%d %H:%M:%S')"
echo "模板目录: $TEMPLATES_DIR"
echo ""
echo "统计结果:"
echo " 通过: $VALIDATION_PASSED"
echo " 失败: $VALIDATION_FAILED"
echo " 通过率: $(awk "BEGIN {printf \"%.1f\", ($VALIDATION_PASSED * 100.0) / ($VALIDATION_PASSED + $VALIDATION_FAILED)}")%"
echo ""
if [ -s "$ERRORS_FILE" ]; then
echo "错误详情:"
cat "$ERRORS_FILE"
fi
} > "$REPORT_FILE"
echo "📄 详细报告: $REPORT_FILE"
echo "========================================"
# 清理临时文件
rm -f "$ERRORS_FILE"
# 返回结果
if [ "$VALIDATION_FAILED" -eq 0 ]; then
echo "✅ 所有 Python 模板验证通过"
exit 0
else
echo "❌ Python 模板验证失败 ($VALIDATION_FAILED 个错误)"
exit 1
fi