Python AppVeyor 示例项目教程

Python AppVeyor 示例项目教程

python-appveyor-demoDemo project for building Python wheels with appveyor.com项目地址:https://gitcode.com/gh_mirrors/py/python-appveyor-demo

本教程将引导您了解 ogrisel/python-appveyor-demo 开源项目，它展示如何在 Windows 平台上构建 Python 轮子文件（.whl）使用 AppVeyor。该项目支持 Python 2 和 3 的多种架构。

1. 项目目录结构及介绍

项目的基本结构如下：

.
├── appveyor.yml         # 配置AppVeyor的主文件
├── dev-requirements.txt # 开发依赖项清单
├── setup.py              # 项目设置和打包脚本
├── gitattributes
├── gitignore
├── LICENSE               # 许可证文件
├── README.md             # 项目的主要说明文档
└── ...

• appveyor.yml: 这是AppVeyor的构建配置文件，定义了整个持续集成流程。
• dev-requirements.txt: 包含开发和测试所需的第三方库列表。
• setup.py: Python标准的项目配置文件，用于安装和发布项目。
• gitattributes 和 gitignore: 分别用来控制Git的文件属性和忽略特定的文件或目录不纳入版本控制。
• LICENSE: 指定项目的授权方式，本项目采用 CC0-1.0 许可。
• README.md: 项目简介、安装指南和快速入门等内容。

2. 项目的启动文件介绍

在这个项目中，没有一个传统意义上的“启动文件”，因为其主要功能集中在自动化构建而非运行一个应用程序。但可以认为，setup.py 在某种程度上扮演了一个重要角色，当通过Python的 pip install . 命令执行时，它负责编译和安装项目到本地环境，同时也用于上传到Python包索引(Python Package Index, PyPI)。

3. 项目的配置文件介绍

appveyor.yml 文件详解

appveyor.yml 是AppVeyor的关键配置文件，决定了如何在Windows平台上进行构建与测试。下面是一些关键部分的概览：

# appveyor.yml示例片段
version: 1.0.{build}
image: Visual Studio 2019
environment:
  matrix:
    - PYTHON_VERSION: "2.7"
      MINICONDA: C:\Miniconda-x64
...
install:
  - cmd: "%MINICONDA%\\Scripts\\conda.exe install numpy wheel"
...
build_script:
  - cmd: "%PYTHON%\\python setup.py bdist_wheel"
...
artifacts:
  - path: dist\*.whl

• version: 构建版本号格式。
• image: 使用的构建环境，这里是Visual Studio 2019的镜像。
• environment.matrix: 定义了不同的Python版本矩阵以进行兼容性测试。
• install: 安装阶段命令，这里安装必要的软件包如 Miniconda 和构建轮子所需的依赖。
• build_script: 实际的构建指令，使用指定版本的Python执行 setup.py bdist_wheel 来创建轮子文件。
• artifacts: 指定构建产出物，通常是生成的 .whl 文件，会被保存并可用于后续部署步骤。

此配置确保项目能在多个Python版本上自动构建二进制包，非常适合Python项目在Windows平台上的持续集成场景。

python-appveyor-demoDemo project for building Python wheels with appveyor.com项目地址:https://gitcode.com/gh_mirrors/py/python-appveyor-demo