PowerShell module for randomly generating names
Clone or download
Latest commit 28fd72e Sep 28, 2018

README.md

PowerShell NameIT

PowerShell module for randomly generating names

This project is a port of https://github.com/mitchdenny/namerer. Hat tip to Mitch Denny.

September 2018

Added New-NameItTemplate. Pass an object with properties and it will generate a NameIT template.

If a property name has has the value name, zip, address, or state the appropriate NameIT template is applied, otherwise the type is inferred as numeric or alpha.

New-NameItTemplate {[PSCustomObject]@{Company="";Name=""}}
Company=[alpha 6]
Name=[person]

OR

Pass it to Invoke-Generate directly.

Invoke-Generate (New-NameItTemplate {[PSCustomObject]@{Company="";Name=""}}) -Count 5 -AsPSObject

Output

Name          Company
----          -------
Elvis Potts   cuajwj
Janae Herring kyzfgb
Cecelia Cruz  slseam
Akira Kelly   bltamv
Bella Bean    wfhats

In Action

image

image1

7/10/2018

[person female first]
[person female last]
[person male first]
[person male last]
[person both first]
[person both last]

Release 1.8.5 : 6/18/2018

Added RandomDate

ig "[person] [randomdate]" -Count 5
Austin Jones 06/04/2007
Kristin Hernandez 06/04/2007
Lindsay Richardson 06/04/2007
Alex Morales 06/04/2007
Nicholas Sanders 06/04/2007

Release 1.8.2 : 03/5/2017

Added more adjectives and stored them randomly, suggested by Joel Bennett.

Added guid to the template. Chris Hunt suggested and then delegated the implementation to me after I showed him I was randomly generating guid parts.

Invoke-Generate "[guid]"
Invoke-Generate "[guid 0]"
Invoke-Generate "[guid 3]"
690dcb11-a5b5-462a-a860-8de11626f5fd
eeb507b0
9873

Release 1.7.0 : 10/3/2016

  • Generate random cmdlet names (verb-noun) and limit it to approved verbs
PS C:\> Invoke-Generate "[cmdlet]" -c 3
Boat-Other
Lawyer-South
Loose-Trip
PS C:\> Invoke-Generate "[cmdlet]" -c 3 -ApprovedVerb
Request-Purchase
Push-Grocery
Format-River
  • Thank you Chris Hunt for:
    • Adding the address feature (and more)
    • Suggesting of adding adjective, noun and verb

Manage Your PowerShell Window Titles

Put this line in your $Profile.

$Host.UI.RawUI.WindowTitle = Invoke-Generate "PowerShell[space]-[space][Adjective][Noun]"

Or try this gist snippet.

PS C:\> Invoke-Generate "[person],[space][address][space]" -c 5
Derrick Cox, 1 Yicxizehpuw Av
Bethany Jones, 237 Tataqe Keys
Courtney Lewis, 162 Goyinu Ranch
Stacy Davis, 127 Odwus Lgt
Shane Carter, 308 Qeep Harb

Release 1.04: 1/16/2016

PS C:\> Invoke-Generate "[person]" -c 3
Meghan Cruz
Cassandra Smith
Luis Flores
PS C:\> Invoke-Generate "[person female]" -c 3
Heather Rogers
Meghan Bailey
Julia Perez
PS C:\> Invoke-Generate "[person male]" -c 3
Chad Bailey
Jordan Gray
Matthew Jackson

Examples

Invoke-Generate
# Output:
lhcqalmf

Will generate an eight character name with a random set of characters in the A-Z alphabet. You can change which alphabet is being used by using the -alphabet parameter.

Invoke-Generate -alphabet abc
# Output:
cabccbca

This is just a default template, most users will have some idea of what they want to generate, but want to randomly splice in other characters to make it unique or come up with some other ideas. For this you can provide a template string.

Invoke-Generate "cafe###"
# Output:
cafe176

Using the ? symbol injects a random letter, the # symbol injects a random number.

Invoke-Generate "???###"
# Output:
yhj561

Template Functions

The ? and # characters in a template are just shorthand for functions that you can use in a template, so the previous example could also be written as:

Invoke-Generate "[alpha][alpha][alpha][numeric][numeric][numeric]"
# Output:
voe336

NameIT exposes a bunch of useful functions to help create more useful (and pronouncable names). Here is the current list that is supported:

  • [alpha]; selects a random character (constrained by the ```-alphabet` parameter).
  • [numeric]; selects a random numeric (constrained by the -numbers parameter).
  • [vowel]; selects a vowel from a, e, i, o or u.
  • [phoneticVowel]; selects a vowel sound, for example ou.
  • [consonant]; selects a consonant from the entire alphabet.
  • [syllable]; generates (usually) a pronouncable single syllable.
  • [synonym word]; finds a synonym to match the provided word.
  • [person]; generate random name of female or male based on provided culture like <FirstName><Space><LastName>.
  • [person female];generate random name of female based on provided culture like <FirstName><Space><LastName>.
  • [person male];generate random name of male based on provided culture like <FirstName><Space><LastName>.
  • [address]; generate a random street address. Formatting is biased to US currently.
  • [space]; inserts a literal space. Spaces are striped from the templates string by default.

One of the most common functions you'll use is [syllable()] because it generally produces something that you can pronounce. For example, if we take our earlier cafe naming example, you might do something like this:

Invoke-Generate "cafe_[syllable][syllable]"
# Output:
cafe_amoy

You can combine the tempalate functions to produce some interesting results, for example here we use the [synonym] function with the [syllable] function to also replace the word cafe.

Invoke-Generate "[synonym cafe]_[syllable][syllable]"
# Output:
coffeehouse_iqza

You can also get the tool to generate a bunch of names at a time using the --count switch. Here is an example:

Invoke-Generate -count 5 "[synonym cafe]_[syllable][syllable]"
# Output:
restaurant_owkub
coffeebar_otqo
eatingplace_umit
coffeeshop_fexuz
coffeebar_zuvpe

You can generate also names of people like <FirstName><Space><LastName> based on provided sex (female/male/both) and culture (currently only en-US). The cultures can be added by putting csv files with the last/first names in the subfoders "cultures", in the module directory - please see en-US.csv for the file structure.

Invoke-Generate "[person female]" -count 3
# Output:
Jacqueline Walker
Julie Richardson
Stacey Powell

Stay tuned for additional capability