feat: support for extended/deploy edition (#12)

* ci: downgrade asdf plugin test action to v3

* feat: add extended/deploy edition support

* docs: update README to use asdf >= v0.16 commands

Refs: https://asdf-vm.com/guide/upgrading-to-v0-16.html#breaking-changes

* feat(list-all): add version expansion for extended and extended_withdeploy variants

* fix: update version format for extended versions to use hyphen

Required for compatibility with mise

* fix(list-all): reorder version output  so that extended_with_deploy comes first

* ci: add test for extended and extended_withdeploy versions

* docs: fix list comment to use hyphens

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* docs(readme): add hyphen in with-deploy

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix: make major_version and minor_version in lib/utils.bash

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: aaccioly

.github/workflows/build.yml

@@ -15,9 +15,11 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest]
+        version: [latest, latest:extended, latest:extended_withdeploy]
     runs-on: ${{ matrix.os }}
     steps:
       - name: asdf_plugin_test
-        uses: asdf-vm/actions/plugin-test@v4
+        uses: asdf-vm/actions/plugin-test@v3
         with:
           command: hugo version
+          version: ${{ matrix.version }}

README.md

@@ -12,9 +12,12 @@
 
 # Contents
 
+- [asdf-hugo  ](#asdf-hugo--)
+- [Build History](#build-history)
+- [Contents](#contents)
 - [Dependencies](#dependencies)
 - [Install](#install)
-- [Why?](#why)
+  - [Extended builds for Sass/SCSS support and deploy edition](#extended-builds-for-sassscss-support-and-deploy-edition)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -36,13 +39,13 @@ hugo:
 
 ```shell
 # Show all installable versions
-asdf list-all hugo
+asdf list all hugo
 
 # Install specific version
 asdf install hugo latest
 
-# Set a version globally (on your ~/.tool-versions file)
-asdf global hugo latest
+# Set a version for your user (writes to your ~/.tool-versions)
+asdf set -u hugo latest
 
 # Now hugo commands are available
 hugo version
@@ -51,20 +54,36 @@ hugo version
 Check [asdf](https://github.com/asdf-vm/asdf) readme for more instructions on how to
 install & manage versions.
 
-## Extended builds for Sass/SCSS support
+## Extended builds for Sass/SCSS support and deploy edition
 
-To install an extended Hugo version with Sass/SCSS support simply prefix the version number in the `asdf install` command with `extended_`.
+To install an extended Hugo version with Sass/SCSS support simply prefix the version number in the `asdf install`
+command with `extended_`.
 
 ```shell
 # Install extended hugo version
-asdf install hugo extended_0.85.0
+asdf install hugo extended_0.154.3
 
 # Now you can manage it like you're used to
-asdf global hugo extended_0.85.0
+asdf set -u hugo extended_0.154.3
 ```
 
-**NOTE**: The extended builds for hugo are only available for 64bit Linux, macOS, and Windows.
-See the asset list at https://github.com/gohugoio/hugo/releases/latest.
+There is also an "extended/deploy" variant which includes the extended build plus additional deployment/cloud
+functionality.
+
+```shell
+# Install extended/deploy hugo version
+asdf install hugo extended_withdeploy-0.154.3
+
+# Manage it the same way
+asdf set --home hugo extended_withdeploy-0.154.3
+```
+
+See the [Editions section in the Hugo README](https://github.com/gohugoio/hugo/blob/master/README.md#editions) for more
+details.
+
+**NOTE**: The extended builds for Hugo (including the with-deploy edition) are only available for 64bit Linux, macOS,
+and Windows. See the asset list at https://github.com/gohugoio/hugo/releases/latest.
+
 
 # Contributing
 

bin/list-all

@@ -8,4 +8,4 @@ plugin_dir=$(dirname "$(dirname "$current_script_path")")
 # shellcheck source=lib/utils.bash
 source "${plugin_dir}/lib/utils.bash"
 
-list_all_versions | sort_versions | xargs echo
+list_all_versions | sort_versions | expand_versions | xargs echo

lib/utils.bash

@@ -37,14 +37,57 @@ list_all_versions() {
   echo "$tags"
 }
 
-# Determine release extension to download for a given version (tar.gz or pkg)
-get_release_ext() {
+# Expand sorted versions with special variant tags.
+# For each version V (one per input line):
+# - emit V
+# - if V >= 0.43 emit extended-V
+# - if V >= 0.137 emit extended_withdeploy-V
+expand_versions() {
+  local regular=()
+  local extended=()
+  local extended_withdeploy=()
+
+  while IFS= read -r ver; do
+    [ -z "${ver}" ] && continue
+    regular+=("$ver")
+    read -r version_path major_version minor_version <<<"$(parse_version "$ver")"
+    if [[ "$major_version" =~ ^[0-9]+$ ]] && [[ "$minor_version" =~ ^[0-9]+$ ]]; then
+      if [ "$major_version" -eq 0 ] && [ "$minor_version" -ge 43 ]; then
+        extended+=("extended-${ver}")
+      fi
+      if [ "$major_version" -eq 0 ] && [ "$minor_version" -ge 137 ]; then
+        extended_withdeploy+=("extended_withdeploy-${ver}")
+      fi
+    fi
+  done
+
+  # Print regular versions first, then extended_withdeploy, then extended
+  printf '%s\n' "${regular[@]:-}"
+  printf '%s\n' "${extended_withdeploy[@]:-}"
+  printf '%s\n' "${extended[@]:-}"
+}
+
+# Parse a version string into a plain version path and its major/minor parts.
+# Supports prefixes like "extended_", "extended-", "extended_withdeploy_",
+# and "extended_withdeploy-".
+parse_version() {
   local version="$1"
-  local version_path="${version//extended_/}"
+  local version_path="${version}"
+  version_path="${version_path#extended_withdeploy_}"
+  version_path="${version_path#extended_withdeploy-}"
+  version_path="${version_path#extended_}"
+  version_path="${version_path#extended-}"
   local major_version
   major_version=$(echo "$version_path" | awk -F. '{print $1}')
   local minor_version
   minor_version=$(echo "$version_path" | awk -F. '{print $2}')
+  printf '%s %s %s' "$version_path" "$major_version" "$minor_version"
+}
+
+# Determine release extension to download for a given version (tar.gz or pkg)
+get_release_ext() {
+  local version="$1"
+  read -r version_path major_version minor_version <<<"$(parse_version "$version")"
   local platform
   platform=$(get_platform)
 
@@ -93,14 +136,13 @@ get_platform() {
 
 download_release() {
   local version="$1"
-  local version_path="${version//extended_/}"
+  local version_path
   local filename="$2"
-  local platform
-  platform=$(get_platform)
   local major_version
-  major_version=$(echo "$version_path" | awk -F. '{print $1}')
   local minor_version
-  minor_version=$(echo "$version_path" | awk -F. '{print $2}')
+  read -r version_path major_version minor_version <<<"$(parse_version "$version")"
+  local platform
+  platform=$(get_platform)
 
   # For Mac downloads use universal binaries for releases >= 0.102.0
   local arch
@@ -117,7 +159,13 @@ download_release() {
 
   local ext
   ext=$(get_release_ext "$version")
-  local url="${GH_REPO}/releases/download/v${version_path}/hugo_${version}_${platform}-${arch}.${ext}"
+  # Some expanded variants use '-' between prefix and version (eg
+  # extended-0.154.3). GitHub release asset names use '_' separators, so
+  # convert '-' to '_' for the artifact filename while keeping the
+  # original `version` value used elsewhere.
+  local version_file
+  version_file="${version//-/_}"
+  local url="${GH_REPO}/releases/download/v${version_path}/hugo_${version_file}_${platform}-${arch}.${ext}"
 
   echo "* Downloading $TOOL_NAME release $version..."
   curl "${curl_opts[@]}" -o "$filename" -C - "$url" || fail "Could not download $url"