FileEncodingHelper

0.1

Get-FileEncoding.ps1

<#
.SYNOPSIS
Get the encoding of the item at the specified location.
 
.DESCRIPTION
The Get-FileEncoding cmdlet gets the encoding of the item at the location specified by the path. It use Ude(universalchardet) to detect encoding.
 
.PARAMETER Path
Specifies the path to an item where Get-FileEncoding gets the content. Wildcard characters are permitted. The paths must be paths to items, not to containers. For example, you must specify a path to one or more files, not a path to a directory.
 
.PARAMETER LiteralPath
Specifies a path to one or more locations. The value of LiteralPath is used exactly as it is typed. No characters are interpreted as wildcards. If the path includes escape characters, enclose it in single quotation marks. Single quotation marks tell PowerShell not to interpret any characters as escape sequences.
 
.INPUTS
System.String[]
 
.OUTPUTS
FileEncodingOutput[]
 
.EXAMPLE
Get-FileEncoding 1.txt
 
.EXAMPLE
Get-FileEncoding -LiteralPath "2[1].txt"
 
.EXAMPLE
Get-FileEncoding "*.txt"
 
.NOTES
To read more about Ude please open https://mxr.mozilla.org/mozilla/source/extensions/universalchardet/ .
#>
function Get-FileEncoding {
    [CmdletBinding(DefaultParameterSetName="Items")]
    param (
        [Parameter(Mandatory = $true,
            Position = 0,
            ParameterSetName = "Items",
            ValueFromPipeline = $true,
            ValueFromPipelineByPropertyName = $true,
            HelpMessage = "Path to one or more locations.")]
        [ValidateNotNullOrEmpty()]
        [SupportsWildcards()]
        [string[]]
        $Path,
        [Parameter(Mandatory = $true,
            Position = 0,
            ParameterSetName = "LiteralItems",
            ValueFromPipelineByPropertyName = $true,
            HelpMessage = "Literal path to one or more locations.")]
        [Alias("PSPath")]
        [Alias("LP")]
        [ValidateNotNullOrEmpty()]
        [string[]]
        $LiteralPath
    )
    process {
        $files = $null
        try {
            if ($Path.Count -ge 1) {
                $files = Get-ChildItem -Path $Path -ErrorAction Stop
            }
            else {
                $files = Get-ChildItem -LiteralPath $LiteralPath -ErrorAction Stop
            }
        }
        catch {
            Write-Error -Exception $_.Exception;
            return;
        }
        foreach ($item in $files) {
            $result = [UtfUnknown.CharsetDetector]::DetectFromFile($item);
            [FileEncodingOutput]::new($item.FullName, $result);
        }
    }
}