Taskfile.yml

---
# https://taskfile.dev
#
# Python tools live in the Poetry env. Always invoke them via `poetry run`
# so `task …` works without activating .venv (and without relying on Task
# PATH templating, which varies by Task version).

version: '3'

vars:
  # Prefix for project Python tooling (black, pytest, …)
  PY: poetry run

includes:
  docs:
    taskfile: ./docs/Taskfile.yml
    dir: ./docs
    vars:
      PY: '{{.PY}}'

tasks:

  list:
    desc: "Show available commands"
    aliases:
      - default
    silent: true
    cmds:
      - task --list-all

  clean:
    desc: Remove local venvs, caches, and build artifacts (fresh-clone-like workspace)
    cmds:
      - bash ./scripts/clean_workspace.sh

  # Publish and release
  # =============

  publish_pypi_test:
    desc: Publish package on test.pypi.org
    cmds:
      - poetry config repositories.testpypi https://test.pypi.org/legacy/
      - poetry build
      - poetry publish -r testpypi

  publish_pypi:
    desc: Publish package on pypi.org
    cmds:
      - poetry build
      - poetry publish


  # Fix
  # =============

  fix_lint:
    desc: fix all what can be fixed
    cmds:
      - "{{.PY}} isort --profile black --overwrite-in-place $(git ls-files | grep '\\.py$')"
      - "{{.PY}} black $(git ls-files | grep '\\.py$')"
      - "{{.PY}} pymarkdownlnt fix $( git ls-files | grep '\\.md$' | grep -v 'docs/' )"

  test_lint:
    desc: show what can be improved
    cmds:
      - "{{.PY}} isort --profile black $(git ls-files | grep '\\.py$')"
      - "{{.PY}} black --check $(git ls-files | grep '\\.py$')"
      - "{{.PY}} pylint $(git ls-files | grep '\\.py$' | grep clak/)"

  test_lint_full:
    desc: run all linting tests
    cmds:
      - task: test_lint
      - "{{.PY}} yamllint $( git ls-files | grep '\\.yml$' )"
      - "{{.PY}} pymarkdownlnt scan $( git ls-files | grep '\\.md$' | grep -v 'docs/' )"
      - shellcheck $( git ls-files | grep '\.sh$' )
      - task: docs:test

  # Tests
  # =============

  test:
    desc: Test everything
    once: true
    cmds:
      - task: test_pytest
      - task: test_regressions
      - task: test_report
      # - task: test_lab
      # - task: test_examples
      - task: test_lint_full


  # test_lab:
  #   dest: Test lab
  #   cmds:
  #     - bash ./scripts/run_python_scripts.sh lab 'test[0-9]*'

  # test_examples:
  #   dest: Test examples
  #   cmds:
  #     - bash ./scripts/run_python_scripts.sh examples 'example[0-9]*'

  fix_regressions:
    desc: Fix regressions
    cmds:
      - "{{.PY}} pytest tests/ --force-regen"

  test_pytest:
    desc: Test with pytest
    once: true
    cmds:
      - "{{.PY}} pytest tests/ -vv --tags unit-tests examples-unit examples-regressions"

  test_regressions:
    desc: Test for regressions (slow)
    once: true
    env:
      # Note: we need to disable colors in regression tests to prevent
      # colorama to patch python stdout/err and break the tests.
      CLAK_COLORS: false
    cmds:
      - "{{.PY}} pytest tests/ --tags examples-regressions"
      - "{{.PY}} pytest tests/ --tags examples-regressions-cli"

  test_report:
    desc: Report tests
    once: true
    cmds:
      # - pytest tests --tb no -vv -q
      - "{{.PY}} pytest tests/ --tb no -q --cov=clak --cov-report term-missing --tags examples-unit unit-tests"

  test_matrix:
    desc: Run pytest matrix (3.10–3.14) via mise + isolated .venvs
    cmds:
      - bash ./scripts/run_python_matrix.sh

  test_matrix_one:
    desc: "Run pytest for one Python version (PYTHON_VERSION=3.11)"
    requires:
      vars: [PYTHON_VERSION]
    cmds:
      - PYTHON_VERSION={{.PYTHON_VERSION}} bash ./scripts/run_python_matrix.sh