# https://taskfile.dev

version: '3'

env:
  POETRY_VIRTUALENVS_IN_PROJECT: true
  
vars:
  DSTDIR: _build
  LOCALES: en_GB en_US fr
  SPHINX_OPTS: -j 4
  SRCDIR: .
tasks:
  default:
    cmds:
      - echo "To see the available tasks, run task -l"
    silent: true
  install:
    desc: Install required dependencies
    cmds:
      - poetry install --no-root
      - poetry run pip install --no-deps --editable ../api
  clean:
    desc: Remove generated artifacts
    cmds:
      - git clean -xdf .
  dev:
    desc: Start a development web server
    cmds:
      - poetry run sphinx-autobuild . /tmp/_build/ --port 8001
  locale-gen:
    desc: Generate translations
    cmds:
      - poetry run sphinx-build -b gettext {{.SRCDIR}} locales/gettext {{.SPHINX_OPTS}}
  locale-update:
    desc: Update translations
    cmds:
      - for: { var: LOCALES  }
        cmd: poetry run sphinx-intl update -p locales/gettext {{.ITEM}}
  locale-prune-untranslated:
    desc: Prune untranslated locales
    cmds:
      - poetry run _scripts/locale-prune-untranslated.py
  build:
    desc: Build documentation
    cmds:
      - poetru run sphinx-build {{.SRCDIR}} {{.DSTDIR}} {{.SPHINX_OPTS}}
  build-translated:
    desc: Build (translated) documentation
    cmds:
      - for: { var: LOCALES }
        cmd: poetry run sphinx-build {{.SRCDIR}} {{.DSTDIR}}/{{.ITEM}} {{.SPHINX_OPTS}} -D language={{.IT
      - for: { var: LOCALES }
        cmd: poetry run sphinx-build {{.SRCDIR}} {{.DSTDIR}}/{{.ITEM}} {{.SPHINX_OPTS}} -D language={{.ITEM}}