Crates.io | xpg |
lib.rs | xpg |
version | 0.14.1 |
source | src |
created_at | 2019-09-08 15:18:20.722029 |
updated_at | 2024-04-04 18:37:53.062879 |
description | xkcd-style password generator |
homepage | |
repository | https://github.com/qtfkwk/xpg |
max_upload_size | |
id | 163235 |
size | 318,518 |
xkcd-style password generator
$ xpg -h
xpg 0.14.1 <https://crates.io/crates/xpg>
xkcd-style password generator
Usage: xpg [OPTIONS] [PATTERNS]...
Arguments:
[PATTERNS]... Pattern(s) (see note 1) [default: `wwww`, `-L`: `{a}`]
Options:
-c, --count <NUMBER> Number of passwords (0:∞ ) [default: 1]
-l, --length <NUMBER> Length
-m, --minimum <NUMBER> Minimum length
-M, --maximum <NUMBER> Maximum length
-a, --attempts <NUMBER> Attempts (see note 2) [default: 10]
-C, --config <PATH> Configuration file
-e, --extended Merge extended words (see note 3)
-L, --list List words in `{sub}`(s)
-d, --dump-config Print configuration
-r, --readme Print readme
-h, --help Print help
-V, --version Print version
---
Notes
1. Patterns
* Words
* `W`: WORD
* `w`: word
* `T`: Word
* `k`: `shuffle(cccc(c|d)(C|c))`
* `{sub}`: see `WordKind`s section in readme
* Characters
* `C`: A-Z
* `c`: a-z
* `d`: 0-9
* `s`: `~!@#$%^&*-_=+;:,./?()[]{}<>`
* `a`: `C` | `c` | `d` | `s`
* Special
* `keychain`
* `codename`
* `codename-series`
* `haiku`
* `haiku+`
* `haiku-`
* `haiku--`
* `haiku++`
* `haiku+++`
2. Ten attempts are made to satisfy the given length requirements by default;
use `-a N` and set `N` to the number of attempts to increase chances.
It will exit with an error if unable to satisfy requirements; some
configurations will always produce an error.
3. Extended words are only available in exclusively extended word kinds by
default; however, with `-e`, they are merged with regular word kinds; use
with the `-L` option to see its effect.
$ xpg -V
xpg 0.14.1
See also the Configuration section below.
$ xpg
judgegavemontanadraw
$ xpg -c 10
beginmoonmothertube
belgiuminsteadthingouter
windowideapoundsdoes
untilneedleneckabove
measurelikeriseamerica
doctorpropertyreacheduncle
donefoundprobableplease
newswednesdaybasketbroken
matterdevelopedincludepounds
provefrontlittlejordan
or until Ctrl+C / SIGINT
$ xpg -c 0
moresincesoiltexas
finallyitselfevenmeat
crossteamdelawareridden
processthousandplaintone
bellnetherlandsedgebranches
suddenelsewingsstory
sundaywedgenatureaustria
sentsoldiersbeganwent
continuedspecialduskbecome
newskilledsomeonefarmers
^C
$ xpg wwwwwwww
fingerbecamecitydemandlaughedmoscoweffectafraid
$ xpg wwwwwwww -c 10
englishmondayamountwhatopinionislandthickdictionary
successenoughfullbusyearthinsectshellofrom
rolledpulledbelieveknownreasonchairshownloss
spreadwheatturnbrokeproductssouthbonescolor
governmentslowlysmallbridgeyellowwellwithinscore
likelytwelvepresentgirlinsteadmorningbookclock
bottleunderstoodoncefebruaryclosetookrulebetween
listlengthsilverduskscalefuturestaytoday
shownspainkissappeartheybritishpossibledied
whosemembersproudpropertystillgoessouthernlondon
$ xpg wwddd
towardcare285
$ xpg wwss
showbrought&?
$ xpg wwds
warsawreal8-
$ xpg wwwwcc
coastbloodfencehusbandzq
$ xpg wwwwCC
untiljamaicasureshoutXU
$ xpg TTTT
MilePromiseTeamRepresent
$ xpg WWWW
HANGTHEMSELVESSHOWFOOT
An "any" character can be a lowercase letter, uppercase letter, digit, or symbol.
$ xpg wwwwaaaaa
noticebrightjumpedlandM44OE
$ xpg www -m 15
signbellpartial
$ xpg www -M 20
divideprocessglass
$ xpg www -m 20 -M 25 -a 1000
patternmainstatement
See also Usage note 2.
$ xpg wwddds -l 16 -a 1000
monthsmadrid593+
See also Usage note 2.
1
, 2 title case words, and !
$ xpg '1TT!'
1LossUpon!
$ xpg 's{adj}{adj}{n}dd'
!bettersoutherncompound00
$ xpg 'ww{ext}'
oxygenwalknorthdakota
$ xpg 'ww{T:ext}'
rememberrestMegaclite
$ xpg 'ww{W:ext}'
belfastfirmCOLORADO
$ xpg -ec 10 TTTT
KilledHouseManySettle
FirmHuntConsiderMinute
MaterialLadderNearFruit
PickMayorEuantheTraining
PlanKalykeDemandHowever
MeanSendFineHold
HeavenDoesIronDemand
ProductsNatureVillageEarly
MayEffectNounToday
GoesDegreeDelawareParty
$ xpg keychain
mwprb5-vCcmys-ynwmjo
$ xpg codename
HIGH FRIENDS
$ xpg codename-series
FOURSTREAM BRITISHELEMENTS
FOURSTREAM SAMEWITHOUT
FOURSTREAM RICHSURPRISE
FOURSTREAM EQUALRADIO
FOURSTREAM ANGRYADVANCE
FOURSTREAM ELSETILL
FOURSTREAM LATERLIGHT
FOURSTREAM AFRAIDSTORE
FOURSTREAM PARTIALOBJECT
FOURSTREAM FLATOPINION
$ xpg codename-series -c 20
NEAREGGS CORRECTMONDAY
NEAREGGS SUDDENINTEREST
NEAREGGS OUTSIDESILVER
NEAREGGS SIMILARBUILD
NEAREGGS PLANEREACH
NEAREGGS THICKFIFTEEN
NEAREGGS THISTYPE
NEAREGGS MINUTERETURN
NEAREGGS THESEVIEW
NEAREGGS TALLCHARGE
NEAREGGS WESTSATURDAY
NEAREGGS MAINFEAR
NEAREGGS TWENTYGREEN
NEAREGGS ANIMALMOTHER
NEAREGGS THIRTEENCARE
NEAREGGS WIDEFREE
NEAREGGS ALONESOUND
NEAREGGS CONSONANTSINGLE
NEAREGGS NICEAUGUST
NEAREGGS REALHEAT
$ xpg haiku
Died experiment / Poor considerable stay / Copenhagen best
$ xpg haiku+
Europe today fruit (2,2,1) / Considerable kept wire (5,1,1) / Cold suggested sight (1,3,1)
$ xpg haiku-
Developed-either(3,2)/However-inches-above(3,2,2)/Cotton-solution(2,3)
$ xpg haiku--
Considerable/Take-electricity-thank/Season-nature-land
$ xpg haiku++
Bulgaria thing
Within similar height class
Hurt direction free
$ xpg haiku+++
Greece America (1,4)
Guess brought considerable (1,1,5)
Equal leave over (2,1,2)
$ xpg -e haiku
Miss February / Consonant condition grown / Dionysus slept
$ xpg aaaaaaaaaaaaaaaaaaaa
fE6H}ax<h?,4oILFFn;3
This works because a character-only pattern is padded to the minimum length with the last character.
$ xpg a -m 20
pi*;,h~JVyd=J3K6I[jz
$ xpg wwww WWWW TTTT
expressseeddoublehome
ROLLEDEVERYLIFEESCAPE
SameFlowDescribeCould
$ xpg '{a:1}-{W:a:2}-{T:a:3}-{olympian:4}-{T:ext:5}'
eggs-OSLO-Uranus-aphrodite-Northcarolina
{color}
$ xpg -L '{color}'
black
blue
brown
gray
green
white
yellow
{color}
in uppercase$ xpg -L '{W:color}'
BLACK
BLUE
BROWN
GRAY
GREEN
WHITE
YELLOW
{color}
in title case$ xpg -L '{T:color}'
Black
Blue
Brown
Gray
Green
White
Yellow
{color}
$ xpg -L '{color}' |wc -l
7
{color}
and Element / {W:el}
$ xpg -L '{color}' '{W:el}'
black
blue
brown
gray
green
white
yellow
GOLD
IRON
LEAD
MERCURY
OXYGEN
SILVER
$ xpg -L |wc -l
1257
$ xpg -Le |wc -l
1403
See config.json
or use -d
for the default configuration compiled into the
binary executable.
If another file is placed at any of the following locations or the path provided
via the -C
option at runtime, it will be used instead.
/home/username/.config/xpg/config.json
C:\Users\username\AppData\Roaming\qtfkwk\xpg\config\config.json
/Users/username/Library/Application Support/com.qtfkwk.xpg/config.json
WordKind
s{a.ext}
{a}
{adj}
{color}
{nat}
{adv}
{conj}
{i}
{n}
{n.pl}
{n.pro}
{n.s}
{ast}
{moon}
{planet}
{color}
{day}
{mon}
{n.prop}
{el}
{name}
{fname}
{mname}
{place}
{city}
{cont}
{country}
{us-state}
{myth}
{greekmyth}
{olympian}
{chthonic}
{romanmyth}
{prep}
{v}
{v.aux}
{v.int}
{v.tr}
{v.past}
{ext}
{n}
{n.s}
{ast}
{moon}
{marsmoon}
{jupitermoon}
{saturnmoon}
{uranusmoon}
{neptunemoon}
Notes
WordKind / {sub}
It is only necessary to set the most descriptive WordKind
(s) since they are
automatically included in the larger word kinds.
The characters
object value must contain the C
, c
, and d
keys with
non-empty values.
Additional keys/values can be added and used.
{sub}
s produce lowercase words by default, but if prefixed with W:
or
T:
words will be uppercase or title case, respectively: i.e. {W:sub}
or
{T:sub}
(replace sub
with an actual {sub}
name above).
{sub}
s include all words by default, but if suffixed with :N
where N
is
a number, it will only include words with that number of syllables: i.e.
{sub:N}
(replace sub
with an actual {sub}
name above and N
with the
desired number of syllables ~1-5).
choose_multiple
; tests; benchmark various implementations; xpg
function; xpg!
macro to enable optional word count argument; command line interface via clap
xpg!
macro; improve documentation-c 0
-r
and -C
options; restore
-c 0
functionality; add codename-series
special pattern; add word kind subpatterns; enable
external runtime configuration via new Config
struct
-C
option-e
and -L
options; make
-d
dump the loaded not default configurationhaiku*
special patterns; fix the codename series
algorithm; make olympian/chthonic kinds extended; update dependencies