README.md

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

Contributors

• Pavel Argentov