Taskfile.yml

version: '3'

dotenv: ['.env.local', '.env']

vars:
  DOCKER_COMPOSE: '{{.TASK_DOCKER_COMPOSE | default "docker compose"}}'
  COMPOSER: '{{.DOCKER_COMPOSE}} exec phpfpm composer'
  CONSOLE: '{{.DOCKER_COMPOSE}} exec phpfpm bin/console'
  PHPUNIT: '{{.DOCKER_COMPOSE}} exec phpfpm bin/phpunit'
  PHP_CS_FIXER: '{{.DOCKER_COMPOSE}} exec phpfpm vendor/bin/php-cs-fixer'
  PHPSTAN: '{{.DOCKER_COMPOSE}} exec phpfpm vendor/bin/phpstan'
  TWIG_CS_FIXER: '{{.DOCKER_COMPOSE}} exec phpfpm vendor/bin/twig-cs-fixer'
  PRETTIER: '{{.DOCKER_COMPOSE}} run --rm prettier'
  MARKDOWNLINT: '{{.DOCKER_COMPOSE}} run --rm markdownlint markdownlint'

tasks:
  compose:
    desc: 'Install Composer dependencies'
    cmds:
      - '{{.COMPOSER}} {{.CLI_ARGS}}'
  install:
    desc: 'First-time setup: start, install deps, migrate, load fixtures'
    cmds:
      - '{{.DOCKER_COMPOSE}} up -d'
      - '{{.COMPOSER}} install'
      - '{{.CONSOLE}} doctrine:database:create --if-not-exists'
      - '{{.CONSOLE}} doctrine:migrations:migrate --no-interaction'
      - '{{.CONSOLE}} doctrine:fixtures:load --no-interaction'

  console:
    desc: 'Run a Symfony console command (usage: task console -- <command>)'
    cmds:
      - '{{.CONSOLE}} {{.CLI_ARGS}}'

  coding-standards:check:
    desc: 'Check coding standards'
    cmds:
      - '{{.PHP_CS_FIXER}} fix --dry-run --diff'
      - '{{.TWIG_CS_FIXER}} lint'
      - "{{.PRETTIER}} 'assets/**/*.js' --check"
      - "{{.PRETTIER}} 'assets/**/*.{css,scss}' --check"
      - "{{.PRETTIER}} '**/*.{yml,yaml}' --check"
      - "{{.MARKDOWNLINT}} '**/*.md'"

  coding-standards:apply:
    desc: 'Apply coding standards'
    cmds:
      - '{{.PHP_CS_FIXER}} fix'
      - '{{.TWIG_CS_FIXER}} lint --fix'
      - "{{.PRETTIER}} 'assets/**/*.js' --write"
      - "{{.PRETTIER}} 'assets/**/*.{css,scss}' --write"
      - "{{.PRETTIER}} '**/*.{yml,yaml}' --write"
      - "{{.MARKDOWNLINT}} '**/*.md' --fix"

  static-analysis:
    desc: 'Run PHPStan static analysis'
    cmds:
      - '{{.PHPSTAN}} analyse --memory-limit=1G'

  test:setup:
    desc: 'Create the test database, run migrations and load fixtures'
    cmds:
      - '{{.DOCKER_COMPOSE}} exec phpfpm composer run test-setup'

  test:
    desc: 'Run the PHPUnit test suite'
    cmds:
      - '{{.PHPUNIT}} {{.CLI_ARGS}}'

  test:coverage:
    desc: 'Run tests with coverage and enforce the 100% gate'
    cmds:
      - '{{.DOCKER_COMPOSE}} exec -e XDEBUG_MODE=coverage phpfpm composer run test-coverage'

  create-admin:
    desc: 'Create (or update) an administrator (usage: task create-admin -- you@example.com "Your Name")'
    cmds:
      - '{{.CONSOLE}} app:create-admin {{.CLI_ARGS}}'

  ci:
    desc: 'Run everything CI runs'
    cmds:
      - task: coding-standards:check
      - task: static-analysis
      - task: test:setup
      - task: test:coverage

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