webget_ruby_password_text 1.2.0

data.tar.gz.sig

@@ -0,0 +1 @@
+�~x9VǑC�E���A���I����.s
���a[�~iI��y�+�Kn�q�B_���9

data/lib/webget_ruby_password_text.rb

@@ -0,0 +1,102 @@
+=begin rdoc
+
+= WebGet Ruby Gem: PasswordText class to generate secure random passwords.
+
+Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+Copyright:: Copyright (c) 2006-2010 Joel Parker Henderson
+License:: CreativeCommons License, Non-commercial Share Alike
+License:: LGPL, GNU Lesser General Public License
+
+Password tool to create strong user-friendly passwords,
+using Ruby's secure random cryptographic functions.
+
+==Examples
+  PasswordText.new => "avzwbnxremcd"
+  PasswordText.new(4) => "avzw"
+  PasswordText.new(4,['x','y','z']) => "yzyx"
+
+PasswordText is a string, so you can do string methods on it.
+You can change how passwords are randomly created however you want.
+
+The default length is 12 to make a sufficiently strong password.
+for usual web applications. You can make this stronger as needed.
+
+The default character array is chosen for the best usability,
+to help people who use mobile phones and who have disabilities:
+all lowercase and omitting "i", "l", "o" which look like numbers.
+
+If SecureRandom is not defined, e.g. if you are using Ruby 1.8.6,
+then we require our webget_ruby_secure_random gem which provides it.
+
+=end
+
+
+class PasswordText < String
+
+ if !defined?(SecureRandom) then require 'webget_ruby_secure_random' end
+
+ # Default characters
+ @@chars=['a','b','c','d','e','f','g','h','j','k','m','n','p','q','r','s','t','u','v','w','x','y','z']
+
+ # Default length
+ @@length=12
+
+
+ # Return a new secure random password.
+ #
+ # The password has a given length (or the default)
+ # and is picked from a given character array (or the default).
+ #
+ # To set the default length, see #length.
+ #
+ # To set the default character array, see #chars
+ #
+ # ==Examples
+ #   PasswordText.new => "avzwbnxremcd"
+ #   PasswordText.new(4) => "avzw"
+ #   PasswordText.new(4,['x','y','z']) => "yzyx"
+  
+ def initialize(length=@@length,chars=@@chars)
+   super(Array.new(length){chars[SecureRandom.random_number(chars.size)]}.join)
+ end
+
+ # Get the default character array.
+ #
+ # To improve usability, the passwords only use lowercase letters.
+ # This helps people who use mobile phones and also helps people
+ # who have some kinds disabilities related to manual dexterity.
+ # We also omit letters that may be confused with numbers: "i", "l", "o".
+ #
+ # We choose this as a valuable tradeoff between usability and complexity.
+
+ def self.chars
+  @@chars
+ end
+
+
+ # Set the default character array
+
+ def self.chars=(chars)
+  @@chars=chars
+ end
+
+
+ # Get the default length
+ #
+ # We choose 12 characters to make a sufficiently strong password.
+ # for usual web applications. You can make this stronger as needed.
+
+ def self.length
+  @@length||=12
+ end
+
+
+ # Set the default length
+
+ def self.length=(length)
+  @@length=length
+ end
+
+end
+
+

data/test/webget_ruby_password_text_test.rb

@@ -0,0 +1,44 @@
+require 'test/unit'
+require 'webget_ruby_password_text'
+
+class PasswordTextTest < Test::Unit::TestCase
+
+  def test_default
+    s = PasswordText.new
+    assert_equal(12,s.length)
+    assert_equal(0,s=~/^[abcdefghjkmnpqrstuvwxyz]{12}$/)
+  end
+
+  def test_with_length
+    s = PasswordText.new(20)
+    assert_equal(20,s.length)
+    assert_equal(0,s=~/^[abcdefghjkmnpqrstuvwxyz]{20}$/)
+  end
+
+  def test_with_length_and_characters
+    s = PasswordText.new(20,['a','b','c'])
+    assert_equal(20,s.length)
+    assert_equal(0,s=~/^[abc]{20}$/)
+  end
+
+  def test_chars
+    chars=['a','b','c']
+    PasswordText.chars=(chars)
+    assert_equal(chars,PasswordText.chars)
+    s=PasswordText.new
+    assert_equal(0,s=~/^[abc]+$/)
+  end
+
+  def test_length
+    length=99
+    PasswordText.length=(length)
+    assert_equal(length,PasswordText.length)
+    s=PasswordText.new
+    assert_equal(length,s.length)
+  end
+
+end
+
+
+
+

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification 
+name: webget_ruby_password_text
+version: !ruby/object:Gem::Version 
+  version: 1.2.0
+platform: ruby
+authors: 
+- WebGet
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDvDCCAyWgAwIBAgIJAIlSqEkDQaZIMA0GCSqGSIb3DQEBBQUAMIGbMQswCQYD
+  VQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5j
+  aXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UECxMKV2ViR2V0LmNvbTET
+  MBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJARYRd2ViZ2V0QHdlYmdl
+  dC5jb20wHhcNMDkwMjI2MTk0NDU4WhcNMTExMTIzMTk0NDU4WjCBmzELMAkGA1UE
+  BhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lz
+  Y28xEzARBgNVBAoTCldlYkdldC5jb20xEzARBgNVBAsTCldlYkdldC5jb20xEzAR
+  BgNVBAMTCldlYkdldC5jb20xIDAeBgkqhkiG9w0BCQEWEXdlYmdldEB3ZWJnZXQu
+  Y29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDXCFYfW6hCQl0ToNjaMIXG
+  ZfPF6OoR20BO/Tg6V37qPi7gDSZ6vIC6Mxcs8LtEcju85cD9lnKKl/lo4S5/w9Ha
+  hGD2ZFFfbF8420X5Za5G2KuriS3GzRz7F5dKCTjb1NH9TPlgOc71bcrDmCwwtFJl
+  T+tdfBju0YxLSBiMXf4y5QIDAQABo4IBBDCCAQAwHQYDVR0OBBYEFHB1kXO/Xd4g
+  G+AJ2/wwh6JOWXzNMIHQBgNVHSMEgcgwgcWAFHB1kXO/Xd4gG+AJ2/wwh6JOWXzN
+  oYGhpIGeMIGbMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQG
+  A1UEBxMNU2FuIEZyYW5jaXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UE
+  CxMKV2ViR2V0LmNvbTETMBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJ
+  ARYRd2ViZ2V0QHdlYmdldC5jb22CCQCJUqhJA0GmSDAMBgNVHRMEBTADAQH/MA0G
+  CSqGSIb3DQEBBQUAA4GBADzVXlwuff0/w3yK4LflGKKhtC3oChIrwmSyP6tk628N
+  BHokpc4Kz63xSXqzYTnBS7rFBwlYThtNalQeWmoUjGh3Z0ZR0JlhU0ln8899LuJ3
+  DXnLFY0cVuBnNDMOOFl8vk1qIcZjcTovhzgcixpG6Uk5qmUsKHRLQf4oQJx7TfLK
+  -----END CERTIFICATE-----
+
+date: 2010-02-17 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bcrypt-ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.5
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: webget_ruby_secure_random
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.0
+    version: 
+description: 
+email: webget@webget.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/webget_ruby_password_text.rb
+has_rdoc: true
+homepage: http://webget.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "WebGet Ruby Gem: Password text generator for strong web-savvy passwords"
+test_files: 
+- test/webget_ruby_password_text_test.rb