Initial commit

Author: alan-null

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: [alan-null]
+custom: ['https://www.paypal.com/paypalme/plocieniak']

.gitignore

@@ -0,0 +1,2 @@
+Fake-UserAgent/data/user-agents.json
+Fake-UserAgent/data/user-agents.dat

Fake-UserAgent/Fake-UserAgent.psd1

@@ -0,0 +1,19 @@
+
+@{
+    RootModule        = 'Fake-UserAgent.psm1'
+    ModuleVersion     = '0.1.0'
+    GUID              = 'ef6d1c27-66ac-4f6c-8cc6-2bbae0f24543'
+    Author            = 'Alan Plocieniak'
+    CompanyName       = 'Alan Plocieniak'
+    Copyright         = '(c) 2025 Alan Plocieniak. All rights reserved.'
+    Description       = 'PowerShell module for generating random User Agents.'
+    PowerShellVersion = '5.0'
+    FunctionsToExport = '*'
+    PrivateData       = @{
+        PSData = @{
+            Tags       = @('powershell', 'fake', 'ps', 'power-shell', 'fake-useragent', 'useragent', 'user', 'agent' )
+            LicenseUri = 'https://github.com/PowerShellLibrary/Fake-UserAgent/blob/master/LICENSE.md'
+            ProjectUri = 'https://github.com/PowerShellLibrary/Fake-UserAgent'
+        }
+    }
+}

Fake-UserAgent/Fake-UserAgent.psm1

@@ -0,0 +1,12 @@
+$Public = @( Get-ChildItem -Path $PSScriptRoot\Public -Recurse -Filter *.ps1 -ErrorAction SilentlyContinue )
+$Private = @( Get-ChildItem -Path $PSScriptRoot\Private -Recurse -Filter *.ps1 -ErrorAction SilentlyContinue )
+
+Foreach ($import in @($Public + $Private)) {
+    try {
+        . $import.fullname
+    }
+    catch {
+        Write-Error -Message "Failed to import function $($import.fullname): $_"
+    }
+}
+Export-ModuleMember -Function $Public.Basename

Fake-UserAgent/Private/ConvertFrom-Gzip.ps1

@@ -0,0 +1,33 @@
+function ConvertFrom-Gzip {
+    Param (
+        [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
+        [ValidateScript( { (Get-Item $_).Name.EndsWith(".gz") })]
+        [System.IO.FileInfo]
+        $InputObject,
+
+        [Parameter(Mandatory = $false)]
+        [switch]
+        $RemoveInputFile
+    )
+    Process {
+        # Create a new file and open a filestream for it
+        $NewFilename = $InputObject.FullName.Remove($InputObject.FullName.Length - $InputObject.Extension.Length)
+        $DecompressedFileStream = [System.IO.File]::Create($NewFilename)
+
+        # Open the compressed file and copy the file to the decompressed stream
+        $CompressedFileStream = $InputObject.OpenRead()
+        $GZipStream = [System.IO.Compression.GZipStream]::new($CompressedFileStream, [System.IO.Compression.CompressionMode]::Decompress)
+        $GZipStream.CopyTo($DecompressedFileStream)
+
+        # Cleanup
+        $DecompressedFileStream.Dispose()
+        $GZipStream.Dispose()
+        $CompressedFileStream.Dispose()
+        $DecompressedFileStream, $GZipStream, $CompressedFileStream = $null
+
+        # Remove the initial file if requested.
+        if ($PSBoundParameters.ContainsKey('RemoveInputFile')) {
+            $InputObject.Delete()
+        }
+    }
+}

Fake-UserAgent/Private/Get-UserAgentData.ps1

@@ -0,0 +1,11 @@
+function Get-UserAgentData {
+    [CmdletBinding()]
+
+    $datPath = Join-Path -Path $PSScriptRoot -ChildPath "..\data\user-agents.dat"
+
+    if (-Not(Test-Path $datPath)) {
+        Initialize-Dataset
+    }
+
+    Import-Clixml -Path $datPath
+}

Fake-UserAgent/Private/Initialize-Dataset.ps1

@@ -0,0 +1,39 @@
+function Initialize-Dataset {
+    Process {
+
+        $gzPath = Join-Path -Path $PSScriptRoot -ChildPath "..\data\user-agents.json.gz"
+        $jsonPath = Join-Path -Path $PSScriptRoot -ChildPath "..\data\user-agents.json"
+        $dll = Join-Path -Path $PSScriptRoot -ChildPath "..\tools\UAParser.dll"
+
+        if (-Not(Test-Path $jsonPath)) {
+            ConvertFrom-Gzip -InputObject (Get-Item -Path $gzPath)
+        }
+
+        if (-Not(Test-Path $datPath)) {
+            Add-Type -Path $dll
+            $uaParser = [UAParser.Parser]::GetDefault()
+
+
+            $jsonFile = (Get-Item -Path $jsonPath)
+            $processed = $jsonFile | Get-Content -Raw | ConvertFrom-Json | % {
+                $ua_result = $uaParser.Parse($_.userAgent)
+
+                [PSCustomObject]@{
+                    ua                          = $_.userAgent
+                    percent                     = [decimal]($_.weight * 100)
+                    type                        = $_.deviceCategory
+                    device_brand                = $ua_result.Device.Brand
+                    browser                     = $ua_result.UserAgent.Family
+                    browser_version             = [version]::new($ua_result.UserAgent.Major, $ua_result.UserAgent.Minor, $ua_result.UserAgent.Patch, $ua_result.UserAgent.PatchMinor)
+                    browser_version_major_minor = [version]::new($ua_result.UserAgent.Major, $ua_result.UserAgent.Minor)
+                    os                          = $ua_result.OS.Family
+                    os_version                  = [version]::new($ua_result.OS.Major, $ua_result.OS.Minor, $ua_result.OS.Patch, $ua_result.OS.PatchMinor)
+                    platform                    = $_.platform
+                }
+            }
+
+            $jsonFile | Remove-Item
+            $processed | Export-Clixml -Path $datPath
+        }
+    }
+}

Fake-UserAgent/Public/Get-UserAgent.ps1

@@ -0,0 +1,10 @@
+function Get-UserAgent {
+    [CmdletBinding()]
+    param ()
+
+    $data = Get-UserAgentData
+    return $data
+
+}
+
+Export-ModuleMember -Function Get-UserAgent