Taskfile.yaml

version: 3

tasks:
  # --------------------------- SETUP ------------------------------------

  activate:
    desc: Activates the virtual environment in development mode
    cmds:
      - hatch shell

  clean_ruff:
    desc: "Remove all .ruff_cache directories"
    cmds:
      - |
        find . \
          -type d \
          -name ".ruff_cache" \
          -exec rm -rf {} +

  clean_mypy:
    desc: "Remove all .mypy_cache directories"
    cmds:
      - |
        find . \
          -type d \
          -name ".mypy_cache" \
          -exec rm -rf {} +

  clean_pytest:
    desc: "Remove all .pytest_cache directories"
    cmds:
      - |
        find . \
          -type d \
          -name ".pytest_cache" \
          -exec rm -rf {} +

  clean:
    desc: Cleans caching, pyc and pycache files
    cmds:
      - hatch run clean_pyc
      - hatch run clean_pyi
      - hatch run clean_pycache
      - task clean_ruff
      - task clean_mypy
      - task clean_pytest

  build_with_checks:
    desc: Builds the project with checks
    cmds:
      - hatch run build_with_check

  lint:
    desc: Lints the project
    cmds:
      - hatch run lint

  format:
    desc: Formats the project
    cmds:
      - hatch run format

  mypy:
    desc: Runs the type checker only, no formatting
    cmds:
      - hatch run test:check_types

  #---------------------------- DOCS -------------------------------

  build:
    desc: Builds the documentation
    cmds:
      - hatch run docs:build

  docs_test:
    desc: Executes documentation examples and validates navigation and internal links
    cmds:
      - hatch run docs:test

  serve:
    desc: Runs the documentation in live mode
    cmds:
      - hatch run docs:serve

  # --------------------------- TEST ------------------------------------

  test:
    desc: Runs the suite tests
    cmds:
      - hatch run test:test {{ .ARGS }}

  test_man:
    desc: Runs the manual tests with more output details and python breakpoints allowed
    cmds:
      - hatch run test:test_man {{ .ARGS }}

  coverage:
    desc: Runs the coverage tests
    cmds:
      - hatch run test:coverage {{ .ARGS }}

  benchmark_schema:
    desc: Benchmarks canonical annotation resolution
    cmds:
      - hatch run test:benchmark_schema

  benchmark_spec:
    desc: Benchmarks Spec declaration, construction, failure, scaling, and memory
    cmds:
      - hatch run test:benchmark_spec

  benchmark_composition:
    desc: Benchmarks nested and inherited Spec construction, declaration, and memory
    cmds:
      - hatch run test:benchmark_composition

  benchmark_validator:
    desc: Benchmarks validator compilation and execution
    cmds:
      - hatch run test:benchmark_validator

  benchmark_types:
    desc: Benchmarks strict standard types, Literal, and constraints
    cmds:
      - hatch run test:benchmark_types

  benchmark_hooks:
    desc: Benchmarks custom validation and unhooked construction canaries
    cmds:
      - hatch run test:benchmark_hooks

  benchmark_errors:
    desc: Benchmarks structured error creation, rendering, projection, and allocations
    cmds:
      - hatch run test:benchmark_errors

  benchmark_mapping:
    desc: Benchmarks compiled Mapping input, aggregation, allocations, and declaration cost
    cmds:
      - hatch run test:benchmark_mapping

  benchmark_json:
    desc: Benchmarks JSON decode, Talea boundary work, full input, codecs, and allocations
    cmds:
      - hatch run test:benchmark_json

  benchmark_serialization:
    desc: Benchmarks compiled Python projection, JSON projection, encoding, and output costs
    cmds:
      - hatch run test:benchmark_serialization

  benchmark_recursive_generics:
    desc: Benchmarks generic specialization and recursive execution
    cmds:
      - hatch run test:benchmark_recursive_generics

  benchmark_utilities:
    desc: Benchmarks Contract, create_spec, introspection, and copy.replace
    cmds:
      - hatch run test:benchmark_utilities

  benchmark_metadata:
    desc: Benchmarks canonical metadata and sensitive failure redaction
    cmds:
      - hatch run test:benchmark_metadata

  benchmark_tagged:
    desc: Benchmarks tagged dispatch, boundaries, output, failure, and branch scaling
    cmds:
      - hatch run test:benchmark_tagged

  benchmark_recursive_named:
    desc: Benchmarks recursive alias and TypedDict graph resolution and execution
    cmds:
      - hatch run test:benchmark_recursive_named

  benchmark_presence:
    desc: Benchmarks derived declarations, presence-aware execution, patching, and memory
    cmds:
      - hatch run test:benchmark_presence

  benchmark_json_schema:
    desc: Benchmarks JSON Schema/OpenAPI projection, size, scaling, and memory
    cmds:
      - hatch run test:benchmark_json_schema

  benchmark_resources:
    desc: Benchmarks boundary resource enforcement, adversarial scaling, and retention
    cmds:
      - hatch run test:benchmark_resources

  benchmark_dataclasses:
    desc: Benchmarks stdlib dataclass Contract interoperability and zero-tax canaries
    cmds:
      - hatch run test:benchmark_dataclasses

  benchmark_representation:
    desc: Benchmarks canonical representation input execution and zero-tax canaries
    cmds:
      - hatch run test:benchmark_representation

  benchmark_callables:
    desc: Benchmarks compiled strict callable execution, failures, and retained artifacts
    cmds:
      - hatch run test:benchmark_callables