Squash merge move_to_single_file_pkgs into main

meta/argument_spec.yml

@@ -5,37 +5,149 @@ argument_specs:
     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>
+      - Will install via system package managers, source, or specific install tool. For example, a go package installed via source will run `go install`.
+    maintainers:
+      - Matthew Stobbs
     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:
+        description:
+          - List of packages to install using this role's package name.
+          - See README.md for the list of available packages.
+      install_become:
+        type: bool
+        default: true
+        description:
+          - Install packages using privilege elevation.
+      install_become_user:
+        type: bool
+        default: root
+        description:
+          - User to become when install_become is true.
+      imethod:
+        type: str
+        default: system
+        description:
+          - Install packages using system package manager when available.
+          - When a package doesn't have a system install candidate for the host,
+            it uses it's default install method as defined in the pkglist variables called `<pkgname>_install_methods`
+          - Most packages will be either `system` or `source` installs.
+          - System installs default to using the system package manager, if possible.
+          - Source installs download, build and install the package via source code.
+            Source installs could be of different types based on the language.
+            For example; python packages installed using `source` are installed with either pipx (default) or system pip.
+        choices:
+          - system
+          - source
+      python_package_method:
+        type: str
+        default: pipx
+        description:
+          - How to install pip packages.
+        choices:
+          - pipx
+          - system
+      install_prefix:
+        type: str
+        required: false
+        default: /usr/local
+        description:
+          - The prefix to use for non-system package installs.
+          - All package files will be installed using the directory prefixed by this prefix.
+      extra_ldd_paths:
+        type: list
+        elements: path
+        required: false
+        default: []
+        description:
+          - Paths to add to the ld.so.conf path list. Will create a file in `/etc/ld.so.conf.d/` on most systems.
+      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
+      packages_extra:
+        type: list
+        elements: str
+        required: false
+        default: []
+        description:
+          - Extra system packages by installation name to install using the system package manager
+          - These are installed directly using the system package manager
+      flatpak_default_remote:
+        type: str
+        required: false
+        default: flathub
+        description:
+          - the Default remote name to use with flatpak installation.
+      flatpak_method:
         type: str
         required: false
         default: system
-        choices:
-          - flatpak
-          - langtool
-          - snap
-          - source
-          - system
+        description:
+          - Default installation method for flatpaks.
+          - Possible values are 'system' and 'user'.
+          - Only applies to linux distros.
+      flatpak_remotes:
+        type: list
+        elements: dict
+        required: false
+        default:
+          - name: flathub
+            url: https://dl.flathub.org/repo/flathub.flatpakrepo
+        description:
+          - List of flatpak remotes to add to the system.
+          - Does not remove pre existing flatpak repos.
+      clean_install:
+        type: bool
+        default: false
+        description:
+          - Remove existing installation of package before installing.
+      path_appimage:
+        type: path
+        default: /usr/local/appimage
+        description:
+          - Where appimage files are stored.
+      path_archive:
+        type: path
+        default: /usr/local/archive
+        description:
+          - Where archives are extracted.
+      path_bin:
+        type: path
+        default: /usr/local/bin
+        description:
+          - Where binaries are installed or linked.
+          - Needs to be added to your PATH to be usable.
+      path_cargo:
+        type: path
+        default: /usr/local/cargo
+        description:
+          - Where cargo installs it's packages
+      path_go:
+        type: path
+        default: /usr/local/go
+        description:
+          - Where go is installed. Equivalent of GOROOT.
+      path_pipx:
+        type: path
+        default: /usr/local/pipx
+        description:
+          - Where pipx installs it's virtual environments
+      store_path:
+        type: path
+        default: /<ansible_user_dir>/.cache/ansible_role_package
+        required: false
+        description:
+          - Where cached files are kept, such as git repositories.
+          - Packages that are compiled have their source extracted here.
+      clean_cache:
+        type: bool
+        default: false
+        description:
+          - Clean the V(store_path) after completing package install.
+          - Removes source code, archives and git repositories

meta/main.yml

@@ -12,12 +12,10 @@ galaxy_info:
   platforms:
   - name: Fedora
     versions:
-    - all
-    - "40"
-    - "41"
+    - "41+"
   - name: EL
     versions:
-    - "9"
+    - "9+"
   - name: macOS
     version:
     - ">=14.2"