---
argument_specs:
  main:
    short_description: Install and configure Forgejo runners
    description:
      - Install and configure [Forgejo](https://forgejo.org/) runners.
    author:
      - jriou
    options:
      forgejo_runners_version:
        description:
          - Version of the runners
        default: 9.1.1

      forgejo_runners_config_dir:
        description:
          - Path to the configuration directory of the runners
        type: path
        default: /etc/forgejo-runners

      forgejo_runners_instance:
        description:
          - URL of the Forgejo instance to register the runners

      forgejo_runners_settings:
        description:
          - Dict of runners to configure
          - The key is the name of the repository on the instance
          - The value is a dict with a `token` key and optionally a dict of `labels`
        type: dict