Taskfile.yaml

version: '3'

vars:
  IMG: '{{.IMG | default "ghcr.io/datum-cloud/galactic:latest"}}'
  CONTAINER_TOOL: '{{.CONTAINER_TOOL | default "docker"}}'
  LOCALBIN:
    sh: echo "$(pwd)/bin"
  GOBIN:
    sh: |
      gobin=$(go env GOBIN)
      [ -n "$gobin" ] && echo "$gobin" || echo "$(go env GOPATH)/bin"
  GOLANGCI_LINT: '{{.LOCALBIN}}/golangci-lint'
  YAMLFMT: '{{.LOCALBIN}}/yamlfmt'
  GO_LICENSES: '{{.LOCALBIN}}/go-licenses'
  GOLANGCI_LINT_VERSION: v2.12.2
  YAMLFMT_VERSION: v0.21.0
  GO_LICENSES_VERSION: v1.6.0

tasks:
  default:
    silent: true
    cmds:
      - task --list

  ##
  ## Development
  ##

  fmt:
    desc: Format code
    run: once
    cmds:
      - go fmt ./...

  vet:
    desc: Vet code
    run: once
    cmds:
      - GOOS=linux go vet ./...

  ci:
    desc: Run the full CI pipeline (lint, build, test:unit, test:e2e)
    cmds:
      - task: lint
      - task: build
      - task: test:unit
      - task: test:e2e

  test:
    desc: Run all tests
    cmds:
      - task: test:unit
      - task: test:e2e

  lint:
    desc: Lint
    deps: [golangci-lint, yamlfmt, yaml-ext]
    cmds:
      - '{{.GOLANGCI_LINT}} run'
      - '{{.YAMLFMT}} -lint'

  lint-fix:
    desc: Lint and apply fixes
    deps: [golangci-lint, yamlfmt]
    cmds:
      - '{{.GOLANGCI_LINT}} run --fix'
      - '{{.YAMLFMT}}'

  notice:
    desc: Regenerate NOTICE file
    deps: [go-licenses]
    cmds:
      - '{{.GO_LICENSES}} report ./... --ignore go.datum.net/galactic --template scripts/licenses/notice.tmpl > NOTICE'

  ##
  ## Build
  ##

  build:
    desc: Build binaries
    deps: [fmt, vet]
    vars:
      VERSION:
        sh: git describe --tags --always --dirty 2>/dev/null || echo "dev"
      GIT_COMMIT:
        sh: git rev-parse --short HEAD
      GIT_TREE_STATE:
        sh: git diff --quiet && echo "clean" || echo "dirty"
      BUILD_DATE:
        sh: date -u +%Y-%m-%dT%H:%M:%SZ
      LDFLAGS: >-
        -s -w
        -X go.datum.net/galactic/internal/metadata.Version={{.VERSION}}
        -X go.datum.net/galactic/internal/metadata.GitCommit={{.GIT_COMMIT}}
        -X go.datum.net/galactic/internal/metadata.GitTreeState={{.GIT_TREE_STATE}}
        -X go.datum.net/galactic/internal/metadata.BuildDate={{.BUILD_DATE}}
    cmds:
      - go build -ldflags "{{.LDFLAGS}}" -o bin/galactic-cni cmd/galactic-cni/main.go

  docker-build:
    desc: Build container image
    vars:
      VERSION:
        sh: git describe --tags --always --dirty 2>/dev/null || echo "dev"
      GIT_COMMIT:
        sh: git rev-parse --short HEAD
      GIT_TREE_STATE:
        sh: git diff --quiet && echo "clean" || echo "dirty"
      BUILD_DATE:
        sh: date -u +%Y-%m-%dT%H:%M:%SZ
    cmds:
      - '{{.CONTAINER_TOOL}} build -t {{.IMG}} -f containers/galactic/Dockerfile
          --build-arg VERSION={{.VERSION}}
          --build-arg GIT_COMMIT={{.GIT_COMMIT}}
          --build-arg GIT_TREE_STATE={{.GIT_TREE_STATE}}
          --build-arg BUILD_DATE={{.BUILD_DATE}}
          .'

  ##
  ## CI
  ##

  test:unit:
    desc: Unit tests with race detection and coverage
    cmds:
      - bash scripts/ci.sh unittest

  test:e2e:
    desc: E2E tests (Kind cluster, build+load image, lifecycle)
    cmds:
      - bash scripts/ci.sh e2etest

  ##
  ## Cleanup
  ##

  clean:
    desc: Remove build artifacts
    cmds:
      - rm -rf bin/
      - rm -rf dist/
      - rm -f cover.out

  ##
  ## Dependencies
  ##

  golangci-lint:
    desc: Download golangci-lint if needed
    run: once
    cmds:
      - task: install-tool
        vars:
          TARGET: '{{.GOLANGCI_LINT}}'
          PACKAGE: github.com/golangci/golangci-lint/v2/cmd/golangci-lint
          VERSION: '{{.GOLANGCI_LINT_VERSION}}'

  yamlfmt:
    desc: Download yamlfmt if needed
    run: once
    cmds:
      - task: install-tool
        vars:
          TARGET: '{{.YAMLFMT}}'
          PACKAGE: github.com/google/yamlfmt/cmd/yamlfmt
          VERSION: '{{.YAMLFMT_VERSION}}'

  yaml-ext:
    desc: Enforce .yaml extension (no .yml)
    run: once
    cmds:
      - |
        if find . -name "*.yml" -not -path "./.git/*" -not -path "./deploy/containerlab/clab-gvpc/*" | grep -q .; then
          find . -name "*.yml" -not -path "./.git/*" -not -path "./deploy/containerlab/clab-gvpc/*"
          echo "ERROR: .yml files found; rename to .yaml"
          exit 1
        fi

  go-licenses:
    internal: true
    run: once
    cmds:
      - task: install-tool
        vars:
          TARGET: '{{.GO_LICENSES}}'
          PACKAGE: github.com/google/go-licenses
          VERSION: '{{.GO_LICENSES_VERSION}}'

  install-tool:
    internal: true
    cmds:
      - mkdir -p {{.LOCALBIN}}
      - |
        if [ ! -f "{{.TARGET}}-{{.VERSION}}" ]; then
          echo "Downloading {{.PACKAGE}}@{{.VERSION}}"
          rm -f "{{.TARGET}}" || true
          GOBIN={{.LOCALBIN}} go install {{.PACKAGE}}@{{.VERSION}}
          mv "{{.TARGET}}" "{{.TARGET}}-{{.VERSION}}"
        fi
        ln -sf "{{.TARGET}}-{{.VERSION}}" "{{.TARGET}}"