Contents

require 'pwqgen/wordlist'
require 'sysrandom/securerandom'

# Public: Pwqgen is a Ruby implementation of passwdqc's pwqgen password
# generator.
#
# Examples
#
#   Pwqgen.generate
#   # => "Unrest3Male!trout"
#
#   Pwqgen.new.generate
#   # => "Obese6Perish6viola"
#
# 	Pwqgen::Generator.new.generate
# 	# => "Crime2Behave=growth"
#
# 	Pwqgen::Generator.new.generate 4
# 	# => "Caesar-Madam7draft8choose"
#
module Pwqgen

	# Public: Returns a random generated password string.
	# 
	# length - number of words used to create the passphrase.
	# 
	# Example
	# 
	# 	Pwqgen.generate 2
	# 	# => "Loyal8atomic"
	# 
	# 	Pwqgen.generate
	# 	# => "Gate*Abound&hull"
	#
	# Returns a password string.
	def self.generate(length = 3)
		self::Generator.new.generate length
	end

	def self.new
		self::Generator.new
	end

	class Generator
		def initialize(separators = "-_!$&*+=23456789")
			@@wordlist_size = @@wordlist.length
			@@separators = separators.split(//)
			@@separators_size = @@separators.length
			@rand = SecureRandom
		end

		# Public: Returns a random generated password string.
		# 
		# length - number of words used to create the passphrase.
		# 
		# Example
		# 
		# 	generate 2
		# 	# => "Loyal8atomic"
		# 
		# 	generate
		# 	# => "Gate*Abound&hull"
		#
		# Returns a password string.
		def generate(length = 3)
			output = Array.new
			for i in 1..length
				output << @@wordlist[@rand.random_number(@@wordlist_size)]
				output[i-1] = output[i-1].capitalize if @rand.random_number(2)

				output << @@separators[@rand.random_number(@@separators_size)] unless i == length
			end
			output.join
		end
	end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
pwqgen.rb-0.1.0	lib/pwqgen/pwqgen.rb