to_pass
- transform a string to a password
to_pass
[-a ALG | --algorithm ALG] [--pipe | --no-pipe] string
to_pass
[-a ALG | --algorithm ALG] [--pipe | --no-pipe] < <file>
password_of
[-a ALG | --algorithm ALG] [--pipe | --no-pipe] string
password_of
[-a ALG | --algorithm ALG] [--pipe | --no-pipe] < <file>
to_pass converts a string (be it a word, a sentence or a whole book) into a password. The transformation is done according to a algorithm which basically is a list of conversion steps.
Some algorithms and conversions are supplied, but you can easily add your own.
User supplied Algorithms are searched in ~/.to_pass/algorithms/
, converter
classes are searched in ~/.to_pass/converters/
.
to_pass-algorithm(5) files are written in yaml(3pm), to_pass-converter(5) classes are ruby(1) classes.
The to_pass
command can reads both algorithms and converters.
Algorithm names should match the filenames so that the library can find and load them. Search locations are the user-directory ~/.to_pass/algorithm/ and the bundled algorithms. The file is expected to have a ".yml"-extension
Converters should be named like the method they provide. Details about the expected class can be found in to_pass-converter(5).
The following options are supported:
-a ALGORITHM
, --algorithm ALGORITHM
Use the named algorithm.
--pipe
Output just the resulting string, without a line-ending.
Transform the word "test" into a password:
$ to_pass test
t35t
Transform a phrase into a password using a different algorithm:
$ password_of "there is one problem with this sentence: its too long to type into a password field" -a basic_en
ti1pwtsi2ltti@pf
So far, no bugs are known.
ToPass is Copyright (C) 2010 Matthias Viehweger
to_pass-converter(5), to_pass-algorithm(5)