| --- |
| title: DrivePurge Release Automation |
| emoji: 🗂️ |
| colorFrom: blue |
| colorTo: indigo |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| --- |
| |
| # DrivePurge Release Automation API |
|
|
| FastAPI server that automates version tracking, release scanning, |
| per-OS asset mirroring, and metadata JSON generation for the |
| [DrivePurge_](https://github.com/Drive-Purge/DrivePurge_) GitHub repository. |
|
|
| ## 🔧 Environment Variables (set in Space Secrets) |
|
|
| | Variable | Required | Default | Description | |
| |---|---|---|---| |
| | `GITHUB_TOKEN` | ✅ | — | Fine-grained PAT: **Contents R/W**, **Metadata R** | |
| | `REPO_OWNER` | | `Drive-Purge` | GitHub org / user | |
| | `REPO_NAME` | | `DrivePurge_` | Repository name | |
| | `OUTPUT_DIR` | | `/tmp/releases` | Where assets + JSONs are written | |
|
|
| ## 🚀 Endpoints |
|
|
| | Method | Path | Description | |
| |---|---|---| |
| | `GET` | `/health` | Ping | |
| | `POST` | `/update-file` | Push any file to the repo | |
| | `GET` | `/releases` | All releases with per-OS download URLs | |
| | `GET` | `/releases/{tag}` | Single release detail + `by_os` breakdown | |
| | `POST` | `/process-release/{tag}` | Download assets + write `release{ver}.json` | |
| | `POST` | `/trigger` | **Full pipeline** | |
|
|
| Swagger UI: `https://<your-space>.hf.space/docs` |
|
|
| ## 📦 Asset JSON Schema (per asset) |
|
|
| ```json |
| { |
| "name": "DrivePurge-linux-amd64-v1.0.zip", |
| "os": "linux", |
| "arch": "x86_64", |
| "size_bytes": 214202000, |
| "download_url": "https://github.com/.../DrivePurge-linux-amd64-v1.0.zip", |
| "content_type": "application/zip", |
| "created_at": "2026-05-24T06:20:47Z", |
| "local_path": "/tmp/releases/release1_0/DrivePurge-linux-amd64-v1.0.zip" |
| } |
| ``` |
|
|
| ## 🗂️ Full Release JSON |
|
|
| ```json |
| { |
| "repo": "Drive-Purge/DrivePurge_", |
| "tag": "v1.0", |
| "name": "DrivePurge v1.0", |
| "body": "...", |
| "published_at": "2026-05-24T06:24:00Z", |
| "html_url": "https://github.com/...", |
| "assets": [ ...all assets flat... ], |
| "by_os": { |
| "windows": [ ...exe + zip... ], |
| "macos": [ ...arm zip... ], |
| "linux": [ ...amd64 zip... ], |
| "all": [ ...checksums.txt... ] |
| }, |
| "generated_at": "2026-05-24T07:00:00+00:00" |
| } |
| ``` |
|
|
| ## 🖥️ OS / Arch Detection Rules |
|
|
| | Filename pattern | `os` | `arch` | |
| |---|---|---| |
| | `*windows*amd64*`, `*.exe` | `windows` | `x86_64` | |
| | `*windows*arm64*` | `windows` | `arm64` | |
| | `*macos*arm64*`, `*darwin*arm64*` | `macos` | `arm64` | |
| | `*macos*amd64*`, `*darwin*amd64*` | `macos` | `x86_64` | |
| | `*macos*`, `*darwin*` | `macos` | `universal` | |
| | `*linux*amd64*`, `*linux*x86_64*` | `linux` | `x86_64` | |
| | `*linux*arm64*`, `*linux*aarch64*` | `linux` | `arm64` | |
| | `*checksums*`, `*sha256*` | `all` | `all` | |
|
|
| ## ▶️ Run Locally |
|
|
| ```bash |
| pip install -r requirements.txt |
| export GITHUB_TOKEN="ghp_..." |
| python main.py # listens on :7860 |
| # or |
| uvicorn main:app --reload --port 7860 |
| ``` |
