---
argument_specs:
  main:
    short_description: install software easily
    description:
      - Make the installation of packages consistent on each platform.
      - Installs for RedHat, Debian or Darwin 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.
      syspkglist:
        type: "list"
        elements: "str"
        required: false
        description: |
            Additional packages to install via the system
            default package manager. Is combined with the
            completed list of packages to install.
            Only use this if you a package isn't available to the role.
      install_state:
        type: "str"
        choices:
          - "present"
          - "latest"
          - "absent"
        required: false
        default: present
        description: |
            Desired state of the packages to install.
      full_upgrade:
        type: "bool"
        required: false
        default: false
        description: |
            Do a full system upgrade before installing
            additional packages. This does not handle
            rebooting a machine that has been upgraded.