wildling

GNAT Ada library and CLI for pattern-based string generation. Zero third-party crates — Ada standard library only (Ada.*) with a hand-rolled JSON parser for --template. Pattern splitting is hand-rolled (no regex package).

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 ada
./build.sh
./bin/wildling "Year 19##"

From a release tag:

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

Produces dist/wildling. Use the packages under src/ (except cli.adb) as a library.

with Ada.Strings.Unbounded; use Ada.Strings.Unbounded;
with Ada.Text_IO;
with Parse_Pattern; use Parse_Pattern;
with Token; use Token;
with Wildling; use Wildling;

procedure Example is
   Patterns : String_List;
   Dicts    : Dictionaries;
   W        : Wildling_Type;
   Value    : Unbounded_String;
begin
   Patterns.Append (To_Unbounded_String ("Year 19##"));
   W := Create (Patterns, Dicts);
   while Next (W, Value) loop
      Ada.Text_IO.Put_Line (To_String (Value));
   end loop;
end Example;

CLI

./bin/wildling "Year 19##"
./bin/wildling --dictionary planets:../dictionaries/planets.txt "%{'planets'}"
./bin/wildling --template ./config.json

Help text and --check output follow docs/cli.md / docs/help.txt. Out-of-range --select / --range write out of range: <index> on stderr and exit 1.

Build

./build.sh   # Docker (gcc:14-bookworm + gnat/gprbuild): → dist/wildling + help.txt

Project tests live in ../tests/ and are run with ../test.sh.

Layout

ada/
  src/
    token.ads/.adb         token expansion
    parse_pattern.ads/.adb hand-rolled pattern split + tokenizers
    generator.ads/.adb     single-pattern generator
    wildling.ads/.adb      multi-pattern API
    json.ads/.adb          template JSON parser
    cli.adb                CLI entry point
  wildling.gpr             GPRbuild project
  bin/wildling             launcher script
  build.sh                 Docker build (gnat/gprbuild via apt)
  dist/                    build output (gitignored)
  obj/                     compiler units (gitignored)