Text.WordPass

Main module generating passwords.

Documentation

type WordSet = Set Text

Explanatory type alias for the type of wordlists during preprocessing.

type WordList = Vector Text

Explanatory type alias for immutable, preprocessed wordlist used by random number generator.

Reading inputs

resolveSymbolicLink :: FilePath -> IO FilePath

Try to resolve symbolic link chain for given filename.

readDict :: FilePath -> IO WordSet

Reads a dict format to get a list of unique words without any special chars.

dictFiles :: FilePath -> IO [FilePath]

Find all plausible dictionaries in a given directory

readDicts :: [FilePath] -> IO (Set Text)

Read a set of dictionaries and put the together.

readDictDir :: FilePath -> IO (Set Text)

Read all dictionaries from a given directory.

defaultDictionary :: FilePath

Filename for default dictionary (should be command line argument or default glob.)

randomPassword :: WordList -> Int -> Gen Text

Pick a random password, given a words list, and a number of words it will contain.

capitalized :: Text -> Text

First character uppercase, all others lowercase

uncapitalized :: Text -> Text

First character lowercase, all others uppercase

evenUpperOddLower :: Text -> Text

Swap case for each letter, starting from upper

evenLowerOddUpper :: Text -> Text

Swap case, starting from lower

randomCase :: Gen Text -> Gen Text

Randomize letter case within the word.

caseVariants :: [Text -> Text]

Different uppercase/lowercase variants of each word.

randomPasswordStrength :: Vector a -> Int -> Double

Estimate strength of random password with given inputs.

numSymbols :: Int

Number of characters within alphabet.

numNumericSeparators :: Int

Since we use two-digit separators, there are 100 different.

Random separators

randomSeparator :: Gen Text

Randomly pick a word separator as a two-digit number, or a symbol character.

randomNumericSeparator :: Gen Text

Two-digit number as a separator 10^2 = 6.6 bits of entropy.

(|||) :: (t -> Bool) -> (t -> Bool) -> t -> Bool

Conjunction of two unary predicates

randomElement :: Vector a -> Gen a

symbolChars :: Vector Char

List of symbol and punctuation characters in ASCII Should be 5 bits of entropy

randomSymbolSeparator :: Gen Text

Text with random symbol character, 5 bits of entropy