wildling

Pattern-based string generator — library and CLI for PowerShell 5.1+ / PowerShell 7.

Docs: Website · Sandbox · Syntax · Source

Example

http://${'dev,stage,prod'}\-${'api,web'}#{0-2}.example.${'com,net,org'}/@.html

(The \- is a literal hyphen; bare - would mean “one letter or digit”. @ is one lowercase letter.)

That builds URL-shaped candidates: scheme http://, then environment × service × optional digits × TLD, then a one-letter path page. Three environments, two services, zero–two digits ('', 0–9, 00–99), three TLDs, and a–z → 51948 strings — the kind of list you generate for fuzzing links or probing staging hosts, not type out.

A few of them:

http://dev-api.example.com/a.html / http://stage-web.example.com/z.html
http://dev-api0.example.net/a.html / http://prod-web9.example.org/m.html
http://dev-api00.example.com/a.html / http://prod-web99.example.org/z.html

Named dictionaries (%{'hosts'}) work the same way when the word lists live in files.

Try it in the sandbox, or see pattern syntax for length ranges, dictionaries, and escapes.

Install

From this repository:

cd powershell
./build.sh

From a release tag:

git clone --branch v2.0.0 --depth 1 https://github.com/dotmonk/wildling.git
cd wildling
./build.sh powershell

Registry: PowerShell Gallery Wildling (when published)

Build

Requires Docker (host does not need pwsh installed):

./build.sh

Copies shared help text from docs/help.txt and syntax-checks all .ps1 files inside mcr.microsoft.com/powershell.

CLI

./bin/wildling "Year 19##"
./bin/wildling --help
./bin/wildling --check "##"

If pwsh or powershell is on PATH, the launcher runs locally. Otherwise it falls back to Docker (mcr.microsoft.com/powershell).

Library

Dot-source the library files (or import as a module):

$LibDir = Join-Path $PSScriptRoot 'lib'
. (Join-Path $LibDir 'Wildling.Token.ps1')
. (Join-Path $LibDir 'Wildling.ParsePattern.ps1')
. (Join-Path $LibDir 'Wildling.Generator.ps1')
. (Join-Path $LibDir 'Wildling.ps1')

$wildling = New-WildlingClient -Patterns @('Year 19##') -Dictionaries ([ordered]@{})
$value = $wildling.Next()
while ($value -isnot [bool] -or $value -ne $false) {
    Write-Output $value
    $value = $wildling.Next()
}

Shared CLI contracts: docs/cli.md.