dicegen

Super simple library for generating very strong, memorable passphrases.

Clojars Project

Installing

Using homebrew for Mac OS

  1. Install homebrew
  2. Run: brew tap scstarkey/homebrew-scstarkey https://git.calmabiding.me/scstarkey/homebrew-scstarkey
  3. Run: brew install dicegen

Using inlein directly

  1. Install inlein
  2. Run the following: curl https://git.calmabiding.me/scstarkey/dicegen/raw/branch/master/dicegen -o ~/bin/dicegen && chmod +x ~/bin/dicegen

Tests

use {"ns" "dicegen.itl.fixtures"}

If you run lein itl, the following table will be executed:

IndexPhraseEntropyCountStrong?
0outcome chitchat verbally reference dismantle70.225367133297655true
1rematch unrefined unkind chill abdominal72.911774897578355true
2paramedic kosher pending rental rally71.032722055355255true
3satirical system overcrowd jet hangout67.659387735944075true
4crushed playhouse bulk shingle verse72.876466357384055true

passwords

Running the application

After installing using the above methods

Run dicegen --help for a description of various options you can pass.

The wordlist option is possibly confusing. The two wordlists we support are:

Directly from source control

  1. Install leiningen (you can use homebrew)
  2. lein run

Packaging and running as standalone jar

lein do clean, uberjar && java -jar target/dicegen.jar

Building

You'll need at least Java 8 and Leiningen

License

Copyright © 2019, Stephen Starkey.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.