Taskfile.yml

version: "1"
name: my-api
description: "CI generation: taskfile ci generate → GitHub, GitLab, Gitea, Drone, Jenkins, Makefile"

variables:
  APP_NAME: my-api
  IMAGE: ghcr.io/myorg/my-api
  TAG: latest

environments:
  local:
    container_runtime: docker
    compose_command: docker compose

  staging:
    ssh_host: staging.example.com
    ssh_user: deploy
    ssh_key: ~/.ssh/id_ed25519
    container_runtime: docker
    variables:
      DOMAIN: staging.example.com

  prod:
    ssh_host: prod.example.com
    ssh_user: deploy
    ssh_key: ~/.ssh/id_ed25519
    container_runtime: podman
    service_manager: quadlet
    variables:
      DOMAIN: api.example.com

# ─── Pipeline ─────────────────────────────────────────
# This section is the SOURCE for `taskfile ci generate`.
# It declares stages, triggers, secrets, and artifacts.
# The CI generators translate this into platform-specific configs.

pipeline:
  python_version: "3.12"
  runner_image: ubuntu-latest
  install_cmd: pip install taskfile
  branches: [main, develop]
  secrets: [GHCR_TOKEN, SSH_PRIVATE_KEY, DEPLOY_KEY]
  cache: [~/.cache/pip]
  artifacts: [dist/, coverage/]

  stages:
    - name: lint
      tasks: [lint]

    - name: test
      tasks: [test]
      artifacts: [coverage/]
      cache: [~/.cache/pip]

    - name: build
      tasks: [build, push]
      docker_in_docker: true

    - name: deploy-staging
      tasks: [deploy-staging]
      env: staging
      when: "branch:develop"

    - name: deploy-prod
      tasks: [deploy-prod]
      env: prod
      when: manual

    - name: release
      tasks: [release]
      when: tag

# ─── Tasks ────────────────────────────────────────────

tasks:

  lint:
    desc: Run linters
    stage: lint
    cmds:
      - ruff check src/
      - mypy src/
    ignore_errors: true

  test:
    desc: Run tests with coverage
    stage: test
    cmds:
      - pytest tests/ -v --cov=src/ --cov-report=html:coverage/

  build:
    desc: Build Docker image
    stage: build
    deps: [test]
    cmds:
      - docker build -t ${IMAGE}:${TAG} .

  push:
    desc: Push to GHCR
    stage: build
    deps: [build]
    cmds:
      - docker push ${IMAGE}:${TAG}

  deploy-staging:
    desc: Deploy to staging
    env: [staging]
    cmds:
      - "@remote docker pull ${IMAGE}:${TAG}"
      - "@remote docker compose pull"
      - "@remote docker compose up -d"

  deploy-prod:
    desc: Deploy to production
    env: [prod]
    cmds:
      - "@remote podman pull ${IMAGE}:${TAG}"
      - "@remote systemctl --user restart ${APP_NAME}"

  release:
    desc: Create GitHub release
    cmds:
      - gh release create ${TAG} dist/* --title "Release ${TAG}"

  # ─── CI management tasks ────────────────────────────

  ci-generate-github:
    desc: "Generate GitHub Actions workflow"
    cmds:
      - taskfile ci generate --target github
      - echo "Generated: .github/workflows/taskfile.yml"

  ci-generate-gitlab:
    desc: "Generate GitLab CI config"
    cmds:
      - taskfile ci generate --target gitlab
      - echo "Generated: .gitlab-ci.yml"

  ci-generate-gitea:
    desc: "Generate Gitea Actions workflow"
    cmds:
      - taskfile ci generate --target gitea
      - echo "Generated: .gitea/workflows/taskfile.yml"

  ci-generate-drone:
    desc: "Generate Drone CI config"
    cmds:
      - taskfile ci generate --target drone
      - echo "Generated: .drone.yml"

  ci-generate-jenkins:
    desc: "Generate Jenkinsfile"
    cmds:
      - taskfile ci generate --target jenkins
      - echo "Generated: Jenkinsfile"

  ci-generate-makefile:
    desc: "Generate Makefile wrapper"
    cmds:
      - taskfile ci generate --target makefile
      - echo "Generated: Makefile"

  ci-generate-all:
    desc: "Generate CI configs for ALL 6 platforms"
    cmds:
      - taskfile ci generate --all
      - echo "Generated configs for 6 CI platforms"

  ci-preview:
    desc: "Preview GitHub Actions config without writing"
    cmds:
      - taskfile ci preview --target github

  ci-list:
    desc: "List pipeline stages"
    cmds:
      - taskfile ci list

  ci-run-local:
    desc: "Run full pipeline locally"
    cmds:
      - taskfile ci run

  ci-run-test:
    desc: "Run only test stage locally"
    cmds:
      - taskfile ci run --stage test