---
argument_specs:
  main:
    short_description: Install software using ansible
    description:
      - Make the installation of packages consistent on each platform.
      - Installs for RedHat, Debian and MacOS based systems.
    author:
      - Matthew Stobbs <matthew@stobbs.ca>
    options:
      use_local:
        type: bool
        default: true
        required: false
        description:
            Install packages using the current users
            `$HOME/.local` directory as the install prefix.

            WHen `false`, uses the system wide `/usr/local`
            as the install prefix, and stores other parts
            (appimages, extracted archives, cache) in the
            appropriate path starting with `/opt`.
      packages:
        type: list
        elements: str
        required: true
        description: |
            The list of packages to install by name.
            The list must contain only values that exist in
            `Available Packages` in `README.md`
      prefer_method:
        type: str
        required: false
        default: system
        choices:
          - flatpak
          - langtool
          - snap
          - source
          - system