Refactor action.yml and main.ps1 to remove Path input and add WorkingDirectory input; implement Convert-VersionSpec function for version range handling.

Author: MariusStorhaug

action.yml

@@ -9,10 +9,6 @@ inputs:
   Name:
     description: Name of the module to process.
     required: false
-  Path:
-    description: The path to the root of the repo.
-    required: false
-    default: ${{ github.workspace }}
   Debug:
     description: Enable debug output.
     required: false
@@ -28,15 +24,19 @@ inputs:
     description: Allow prerelease versions if available.
     required: false
     default: 'false'
+  WorkingDirectory:
+    description: The working directory where the script will run from.
+    required: false
+    default: ${{ github.workspace }}
 
 runs:
   using: composite
   steps:
     - name: Document-PSModule
       env:
         GITHUB_ACTION_INPUT_Name: ${{ inputs.Name }}
-        GITHUB_ACTION_INPUT_Path: ${{ inputs.Path }}
       shell: pwsh
+      working-directory: ${{ inputs.WorkingDirectory }}
       run: |
         # Build-PSModuleDocumentation
-        ${{ github.action_path }}\scripts\main.ps1
+        ${{ github.action_path }}/scripts/main.ps1

scripts/helpers/Convert-VersionSpec.ps1

@@ -0,0 +1,98 @@
+function Convert-VersionSpec {
+    <#
+            .SYNOPSIS
+            Converts legacy version parameters into a NuGet version range string.
+
+            .DESCRIPTION
+            This function takes minimum, maximum, or required version parameters
+            and constructs a NuGet-compatible version range string.
+
+            - If `RequiredVersion` is specified, the output is an exact match range.
+            - If both `MinimumVersion` and `MaximumVersion` are provided,
+              an inclusive range is returned.
+            - If only `MinimumVersion` is provided, it returns a minimum-inclusive range.
+            - If only `MaximumVersion` is provided, it returns an upper-bound range.
+            - If no parameters are provided, `$null` is returned.
+
+            .EXAMPLE
+            Convert-VersionSpec -MinimumVersion "1.0.0" -MaximumVersion "2.0.0"
+
+            Output:
+            ```powershell
+            [1.0.0,2.0.0]
+            ```
+
+            Returns an inclusive version range from 1.0.0 to 2.0.0.
+
+            .EXAMPLE
+            Convert-VersionSpec -RequiredVersion "1.5.0"
+
+            Output:
+            ```powershell
+            [1.5.0]
+            ```
+
+            Returns an exact match for version 1.5.0.
+
+            .EXAMPLE
+            Convert-VersionSpec -MinimumVersion "1.0.0"
+
+            Output:
+            ```powershell
+            [1.0.0, ]
+            ```
+
+            Returns a minimum-inclusive version range starting at 1.0.0.
+
+            .EXAMPLE
+            Convert-VersionSpec -MaximumVersion "2.0.0"
+
+            Output:
+            ```powershell
+            (, 2.0.0]
+            ```
+
+            Returns an upper-bound range up to version 2.0.0.
+
+            .OUTPUTS
+            string
+
+            .NOTES
+            The NuGet version range string based on the provided parameters.
+            The returned string follows NuGet versioning syntax.
+
+            .LINK
+            https://psmodule.io/Convert/Functions/Convert-VersionSpec
+        #>
+    [OutputType([string])]
+    [CmdletBinding()]
+    param(
+        # The minimum version for the range. If specified alone, the range is open-ended upwards.
+        [Parameter()]
+        [string] $MinimumVersion,
+
+        # The maximum version for the range. If specified alone, the range is open-ended downwards.
+        [Parameter()]
+        [string] $MaximumVersion,
+
+        # Specifies an exact required version. If set, an exact version range is returned.
+        [Parameter()]
+        [string] $RequiredVersion
+    )
+
+    if ($RequiredVersion) {
+        # Use exact match in bracket notation.
+        return "[$RequiredVersion]"
+    } elseif ($MinimumVersion -and $MaximumVersion) {
+        # Both bounds provided; both are inclusive.
+        return "[$MinimumVersion,$MaximumVersion]"
+    } elseif ($MinimumVersion) {
+        # Only a minimum is provided. Use a minimum-inclusive range.
+        return "[$MinimumVersion, ]"
+    } elseif ($MaximumVersion) {
+        # Only a maximum is provided; lower bound open.
+        return "(, $MaximumVersion]"
+    } else {
+        return $null
+    }
+}

scripts/helpers/Resolve-PSModuleDependency.ps1

@@ -29,30 +29,6 @@
         [string] $ManifestFilePath
     )
 
-    # Helper: Convert legacy version parameters into a NuGet version range string.
-    function Convert-VersionSpec {
-        param(
-            [string]$MinimumVersion,
-            [string]$MaximumVersion,
-            [string]$RequiredVersion
-        )
-        if ($RequiredVersion) {
-            # Use exact match in bracket notation.
-            return "[$RequiredVersion]"
-        } elseif ($MinimumVersion -and $MaximumVersion) {
-            # Both bounds provided; both are inclusive.
-            return "[$MinimumVersion,$MaximumVersion]"
-        } elseif ($MinimumVersion) {
-            # Only a minimum is provided. Use a minimum-inclusive range.
-            return "[$MinimumVersion, ]"
-        } elseif ($MaximumVersion) {
-            # Only a maximum is provided; lower bound open.
-            return "(, $MaximumVersion]"
-        } else {
-            return $null
-        }
-    }
-
     Write-Host 'Resolving dependencies'
     $manifest = Import-PowerShellDataFile -Path $ManifestFilePath
     Write-Host " - Reading [$ManifestFilePath]"

scripts/main.ps1

@@ -22,15 +22,12 @@ $env:GITHUB_REPOSITORY_NAME = $env:GITHUB_REPOSITORY -replace '.+/'
 $moduleName = [string]::IsNullOrEmpty($env:GITHUB_ACTION_INPUT_Name) ? $env:GITHUB_REPOSITORY_NAME : $env:GITHUB_ACTION_INPUT_Name
 Write-Host "Module name:         [$moduleName]"
 
-$moduleSourceFolderPath = Resolve-Path -Path "$env:GITHUB_ACTION_INPUT_Path/src"
-if (-not (Test-Path -Path $moduleSourceFolderPath)) {
-    throw "Module path [$moduleSourceFolderPath] does not exist."
-}
+$moduleSourceFolderPath = Resolve-Path -Path 'src' | Select-Object -ExpandProperty Path
 Write-Host "Module source path:  [$moduleSourceFolderPath]"
 
-$modulesOutputFolderPath = Join-Path -Path $env:GITHUB_ACTION_INPUT_Path 'outputs/module'
+$modulesOutputFolderPath = New-Item -Path 'outputs/module' -Force
 Write-Host "Module output path:  [$modulesOutputFolderPath]"
-$docsOutputFolderPath = Join-Path -Path $env:GITHUB_ACTION_INPUT_Path 'outputs/docs'
+$docsOutputFolderPath = New-Item -Path 'outputs/docs' -Force
 Write-Host "Docs output path:    [$docsOutputFolderPath]"
 
 $params = @{