59 lines
1.4 KiB
Markdown
59 lines
1.4 KiB
Markdown
|
# keepass-password-generator
|
||
|
|
|
||
|
|
Generate passwords using KeePass password generator patterns.
|
||
|
|
|
||
|
|
## RubyGems installation
|
||
|
|
|
||
|
|
gem install keepass-password-generator
|
||
|
|
|
||
|
|
## Bundler installation
|
||
|
|
|
||
|
|
In your `Gemfile`:
|
||
|
|
|
||
|
|
gem 'keepass-password-generator'
|
||
|
|
|
||
|
|
Install bundled gems:
|
||
|
|
|
||
|
|
bundle
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
require 'keepass/password'
|
||
|
|
|
||
|
|
KeePass::Password.generate('A{6}s')
|
||
|
|
#=> "Un2hd#t"
|
||
|
|
|
||
|
|
See <http://keepass.info/help/base/pwgenerator.html> for information about KeePass patterns.
|
||
|
|
|
||
|
|
## Examples
|
||
|
|
|
||
|
|
A 40-bit WEP key:
|
||
|
|
|
||
|
|
KeePass::Password.generate('h{10}')
|
||
|
|
#=> "ae6929dc0e"
|
||
|
|
|
||
|
|
A random MAC address:
|
||
|
|
|
||
|
|
KeePass::Password.generate('HH\-HH\-HH\-HH\-HH\-HH', :permute => false)
|
||
|
|
#=> "0D-4D-32-64-EB-7D"
|
||
|
|
|
||
|
|
A password with 10 alphanumeric characters, where at least 2 are upper case and at least are 2 lower case characters:
|
||
|
|
|
||
|
|
KeePass::Password.generate('uullA{6}')
|
||
|
|
#=> "us2j1nTIQT"
|
||
|
|
|
||
|
|
A password with 20 alphanumeric and symbol characters, without any lookalike characters (e.g., I and |):
|
||
|
|
|
||
|
|
KeePass::Password.generate('[As]{20}', :remove_lookalikes => true)
|
||
|
|
#=> "-2~[+Rze{hZezk(\\nZ-W"
|
||
|
|
|
||
|
|
Invalid patterns raise an exception:
|
||
|
|
|
||
|
|
KeePass::Password.generate('[\I\|]{3}', :remove_lookalikes => true)
|
||
|
|
#=> KeePass::Password::InvalidPatternError: empty character set for token 1 for "[\\I\\|]{3}"
|
||
|
|
|
||
|
|
## Related gems
|
||
|
|
|
||
|
|
* <https://github.com/dmke/simple-password-gen>
|
||
|
|
* <http://rubygems.org/gems/ruby-password>
|