# vim: set filetype=yaml.ansible :
---
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:
      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 B(Available Packages) in README.md
      extra_packages:
        type: list
        elements: str
        description:
          - Extra system packages by installation name to install using the system package manager
      default_flatpak_method:
        type: str
        default: system
        description:
          - Default installation method for flatpaks.
          - Possible values are 'system' and 'user'
      default_install_method:
        type: str
        default: system
        choices:
          - system
          - source
          - appimage
          - flatpak
          - cask
          - snap
        description:
          - Default installation method for packages.
          - Varies between each indivdual package, but this is for overall package installation.
          - Possible values are V(system), V(source), V(appimage), V(flatpak), V(cask), V(snap)
      default_install_prefix:
        type: path
        default: /usr/local
        description:
          - Default installation prefix when installation non-system packages.
      path_suffix_appimage:
        type: path
        default: "{{ default_install_prefix }}/appimage"
        description:
          - Where appimage files are stored.
      path_suffix_archive:
        type: path
        default: "{{ default_install_prefix }}/archive"
        description:
          - Where archives are downloaded and extracted.