Import environment variables from .env files using PowerShell

Import-DotEnv.ps1

<#
.SYNOPSIS
    Imports environment variables from .env files
.DESCRIPTION
    Imports environment variables from .env files. '.env', then '.env.local'
.NOTES
    Ordering for '.env.<not local> and '.env.*.local' is the default
    order of Get-ChildItem.
#>

[CmdletBinding()]
param (
)

(
    (
        (
            # Get all of the .env files
            Get-ChildItem .env* | 
            # Sort so that '.local' files are after others.
            Sort-Object { 
                [int]($_.Extension -ieq '.local')
            } |
            # Get the contents of each .env file
            ForEach-Object {
                Write-Host "Importing environment variables from $($_.Name)" -ForegroundColor Cyan
                $_ | Get-Content
            } | 
            # Convert output to string
            Out-String 
            # Concatenate 
        ) -join [System.Environment]::NewLine
    ) | 
    # Convert to hashtable
    ConvertFrom-StringData
    # Enumerate each key/value pair in the hash table
).GetEnumerator() |
ForEach-Object {
    # Set the environment variable
    Set-Item -Path "env:$($_.Name)" -Value $_.Value
}