编辑“︁Python 持续集成”︁（章节）

= Python持续集成 =

'''持续集成'''（Continuous Integration，简称CI）是一种软件开发实践，旨在通过频繁地将代码变更集成到共享的主干（如Git仓库）中，并自动运行测试和构建流程，以尽早发现和修复问题。在Python开发中，持续集成可以帮助开发者确保代码质量、减少集成冲突，并提高交付效率。

== 什么是持续集成？ ==
持续集成的核心思想是：
* 开发者频繁提交代码到版本控制系统（如Git）。
* 每次提交都会触发自动化构建和测试流程。
* 快速反馈构建或测试失败，以便及时修复。

对于Python项目，持续集成通常包括：
* 运行单元测试（如`pytest`或`unittest`）。
* 检查代码风格（如`flake8`或`black`）。
* 生成文档（如`Sphinx`）。
* 部署到测试环境。

== 为什么需要持续集成？ ==
持续集成的主要优势包括：
* '''早期发现问题'''：自动化测试可以在代码合并前捕获错误。
* '''减少集成冲突'''：频繁集成减少了大规模合并时的冲突风险。
* '''提高开发效率'''：开发者可以专注于编写代码，而不必手动运行测试或构建。
* '''可重复的构建'''：确保在不同环境中构建的一致性。

== Python持续集成工具 ==
以下是Python项目中常用的CI工具：

=== GitHub Actions ===
GitHub Actions是GitHub提供的CI/CD服务，可以直接集成到仓库中。以下是一个简单的Python项目配置示例：

<syntaxhighlight lang="yaml">
name: Python CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python 3.9
      uses: actions/setup-python@v2
      with:
        python-version: 3.9
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt
    - name: Run tests
      run: |
        pytest
</syntaxhighlight>

=== Travis CI ===
Travis CI是另一个流行的CI服务，支持Python项目。配置示例：

<syntaxhighlight lang="yaml">
language: python
python:
  - "3.9"
install:
  - pip install -r requirements.txt
script:
  - pytest
</syntaxhighlight>

=== Jenkins ===
Jenkins是一个开源的自动化服务器，可以高度定制化CI流程。以下是Python项目的Jenfile示例：

<syntaxhighlight lang="groovy">
pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'python -m pip install -r requirements.txt'
            }
        }
        stage('Test') {
            steps {
                sh 'pytest'
            }
        }
    }
}
</syntaxhighlight>

== 实际案例 ==
假设我们有一个Python项目，包含以下结构：
<pre>
my_project/
├── src/
│   └── calculator.py
├── tests/
│   └── test_calculator.py
├── requirements.txt
└── .github/
    └── workflows/
        └── ci.yml
</pre>

=== calculator.py ===
<syntaxhighlight lang="python">
def add(a, b):
    return a + b

def subtract(a, b):
    return a - b
</syntaxhighlight>

=== test_calculator.py ===
<syntaxhighlight lang="python">
from src.calculator import add, subtract

def test_add():
    assert add(2, 3) == 5

def test_subtract():
    assert subtract(5, 3) == 2
</syntaxhighlight>

=== requirements.txt ===
<pre>
pytest
</pre>

=== .github/workflows/ci.yml ===
<syntaxhighlight lang="yaml">
name: Python CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python
      uses: actions/setup-python@v2
      with:
        python-version: 3.9
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt
    - name: Run tests
      run: |
        pytest
</syntaxhighlight>

== 持续集成流程 ==
以下是典型的Python持续集成流程：

<mermaid>
graph LR
    A[开发者提交代码] --> B[CI服务器检测变更]
    B --> C[拉取最新代码]
    C --> D[安装依赖]
    D --> E[运行测试]
    E --> F{测试通过?}
    F -->|是| G[生成报告/部署]
    F -->|否| H[通知开发者]
</mermaid>

== 高级主题 ==
对于更复杂的Python项目，持续集成可以扩展为：
* '''多环境测试'''：在不同Python版本或操作系统中运行测试。
* '''并行测试'''：使用`pytest-xdist`加速测试。
* '''代码覆盖率'''：集成`pytest-cov`生成覆盖率报告。
* '''依赖缓存'''：缓存Python依赖以加快构建速度。

=== 多环境测试示例（GitHub Actions） ===
<syntaxhighlight lang="yaml">
jobs:
  test:
    strategy:
      matrix:
        python-version: ["3.7", "3.8", "3.9"]
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ matrix.python-version }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ matrix.python-version }}
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt
    - name: Run tests
      run: |
        pytest
</syntaxhighlight>

== 总结 ==
持续集成是Python开发中不可或缺的一部分，它通过自动化测试和构建流程，帮助团队保持代码质量并加速交付。无论是小型项目还是大型系统，合理配置CI工具都能显著提高开发效率和软件可靠性。

[[Category:编程语言]]
[[Category:Python]]
[[Category:Python 测试与调试]]