Show `vars`, `requires` when calling `task --summary`

[deepbrook]

Description

I want taskfile to automatically show the vars and requires when calling taskfile --summary <task>, so that I do not have to manually document them.

---

Given the following:

> cat Taskfile.yaml
version: 3

tasks:
  mytask:
    desc: It does things
    summary: |
      It does things and has optional and required variables.
    vars:
      OPTIONAL_VAR: "hello"
    requires:
      vars:
        - REQUIRED_VAR
    cmds:
      - cmd: echo {{ .OPTIONAL_VAR }} {{ .REQUIRED_VAR }}

Current behaviour

> task --summary mytask
task: infrastructure:mytask

It does things and has optional and required variables.

commands:
 - echo hello

Desired behaviour

task: infrastructure:mytask

It does things and has optional and required variables.

vars:
  OPTIONAL_VAR: "hello"

requires:
  vars:
    - REQUIRED_VAR

commands:
 - echo hello

[trulede]

You may be interested in this PR #2348

I use it for generating documentation in MD format (essentially VARS and REQUIRES), however you can do almost anything with it.

[vmaerten]

I think Task should be batteries-included, so let’s begin with #2524.
We can always add more customization options later.