add gitea_runner_python

gitea_runner_python/README.md

@@ -0,0 +1,49 @@
+# Gitea Runner Python
+
+基于 `timi/gitea_runner_base` 的通用 Python job 镜像，适用于 Gitea Actions。
+
+## 包含环境
+
+| 类别 | 工具 |
+|------|------|
+| Python | `python3`、`pip3`、`virtualenv`；提供 `python` 和 `pip` 命令别名 |
+| 原生扩展构建 | `python3-dev`、`build-base`、`cargo`、`libffi-dev`、`openssl-dev` |
+| Gitea Actions | 继承基础镜像中的 Node.js、Git、Bash、SSH、`sshpass`、Docker CLI 等工具 |
+
+Python 版本由基础镜像所使用的 Alpine 仓库提供。这个镜像直接预装 Python，因此不要在 Alpine job 容器中再运行 `actions/setup-python`；该 Action 的预编译版本列表不包含 Alpine。使用镜像内的 `python` 即可。
+
+## 构建
+
+先构建基础镜像，再构建 Python 镜像：
+
+```bash
+./rebuild.sh gitea_runner_base latest
+./rebuild.sh gitea_runner_python latest
+```
+
+如果 Gitea Runner 在另一台机器上运行，需要先把 `timi/gitea_runner_python:latest` 推送到该机器可访问的镜像仓库，或加载到 Runner 使用的 Docker daemon。
+
+## Gitea Actions 用法
+
+```yaml
+jobs:
+  build:
+    runs-on: act_runner_java
+    container:
+      image: timi/gitea_runner_python:latest
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          virtualenv .venv
+          .venv/bin/python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: .venv/bin/python -m pytest
+```
+
+`runs-on` 仍选择可用的 Gitea Runner；`container.image` 选择 job 执行环境。Runner 的 Docker daemon 必须能访问上面指定的镜像。