feat: Get-Vector ( Fixes #1 )

Author: StartAutomating

Commands/Get-Vector.ps1

@@ -0,0 +1,119 @@
+function Get-Vector
+{
+    <#
+    .SYNOPSIS
+        Gets a one dimensional vector
+    .DESCRIPTION
+        Gets a one dimensional vector (or, more simply, a list of numbers)
+
+        This will convert a variety of types into numbers.
+    .NOTES
+        This attempts to convert any type into a number.
+
+        Some types are special:
+        
+        * Primitive types will be casted to float
+        * `[Numerics.Vector2]`,`[Numerics.Vector3]`,`[Numerics.Vector4]` output each component
+        * `[string]`s that match a range (`$start..$end`) will output that range
+        * `[Version]`s will output each numeric component
+        * `[semver]`s will output each numeric component, followed by the bytes of a release type
+        * `[DateTime]` and `[DateTimeOffset]` will become a series of 12 numbers
+          * `year`,`month`,`day`
+          * `hour`, `minute`, `second`
+          * `millisecond`, `microsecond`, `nanosecond`
+          * `offset.hours`, `offset.minutes`, `offset.seconds`
+        * `[string]s` will return their bytes in the current `$outputEncoding`
+        * Anything unknown will be stringified and the bytes will be returned
+    #>
+    [Alias('Vector','Vector1','V1')]
+    param()
+
+    filter toVector { 
+        $arg = $_
+        # Return primitive types
+        if ($arg.GetType -and $arg.GetType().IsPrimitive) {
+            # casted to float
+            return ($arg -as [float])
+        }
+        # Return vector components
+        if ($arg -is [ValueType]) {        
+            if ($arg -is [Numerics.Vector2]) {
+                return $arg.X,$arg.Y
+            }
+            elseif ($arg -is [Numerics.Vector3]) {
+                return $arg.X,$arg.Y,$arg.Z
+            }
+            elseif ($arg -is [Numerics.Vector4]) {
+                return $arg.X,$arg.Y,$arg.Z, $arg.W
+            }
+        }
+        # Look for inline ranges.
+        if ($arg -is [string]) {
+            if ($arg -match '^\d..\d') {
+                $start, $end = $arg -split '\..', 2
+                $startInt = ($start -as [int])
+                $endInt   = ($end -as [int])            
+                if ($null -ne $startInt -and $null -ne $endInt) {
+                    # If found, return them expanded.
+                    return ($startInt..$endInt)
+                }
+            }
+            if ($arg -as [float]) {
+                return $arg -as [float]
+            }
+        }
+        
+
+        # If the arg is a version, get each number of the version
+        if ($arg -is [version]) {return $arg.Major,$arg.Minor,$arg.Build,$arg.Revision}
+
+        # If we support semver and the arg is semver
+        if (('semver' -as [type]) -and $arg -is [semver]) {
+            # Return the numeric parts of the semver
+            $arg.Major,$arg.Minor,$arg.Patch
+            # and turn any string portions to bytes            
+            if ($arg.PreReleaseLabel) {
+                # make sure to include a leading dash for pre-releases
+                $OutputEncoding.GetBytes("-$($arg.PreReleaseLabel)")
+            }
+            
+            if ($arg.BuildLabel) {
+                # make sure to include a leading plus for build labels
+                $OutputEncoding.GetBytes("+$($arg.BuildLabel)")
+            }
+            return
+        }
+
+        # If the arg is a datetime or datetimeoffset 
+        if ($arg -is [DateTime] -or $arg -is [DateTimeOffset]) {
+            # make it an offset, and then output 12 values
+            $dateArg = $arg -as [DateTimeOffset]
+            # * `year` `month` `day`
+            $dateArg.Year, $dateArg.Month, $dateArg.Day, 
+            # * `hour` `minute` `second`
+            $dateArg.Hour, $dateArg.Minute, $dateArg.Second,
+            # * `millisecond`, `microsecond`, `nanosecond`
+            $dateArg.Millisecond, $dateArg.Microsecond, $dateArg.Nanosecond,
+            # * `offset hours`, `offset minutes`, `offset seconds`
+            $dateArg.Offset.Hours,$dateArg.Offset.Minutes,$dateArg.Offset.Seconds
+            return
+        }
+        # If the arg is a string
+        if ($arg -is [string]) {
+            # return its bytes
+            return $OutputEncoding.GetBytes($arg)
+        }
+        # any input we have not caught, stringify and turn to bytes
+        return $OutputEncoding.GetBytes("$arg")        
+    }
+
+    
+    # Collect all of our input and arguments
+    $allIn = @($input) + @(
+        foreach ($arg in $args) {
+            $arg            
+        }
+    )
+
+    return $allIn | toVector
+}