sixarm_ruby_password_text 1.2.1

data.tar.gz.sig

@@ -0,0 +1 @@
+���"�O策

data/LICENSE.txt

@@ -0,0 +1,12 @@
+LICENSE
+
+You may choose any of these licenses:
+
+  - CreativeCommons License, Non-commercial Share Alike
+  - LGPL, GNU Lesser General Public License
+  - MIT License
+  - Ruby License
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

data/README.rdoc

@@ -0,0 +1,28 @@
+
+= SixArm Ruby Gem: 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
+
+Generates strong yet user-friendly passwords using Ruby's secure random cryptographic functions.
+
+You can change how passwords are created using the optional parameters and the return value is a string, so you can do string methods on it.
+
+The default length is 12 characters, which is sufficiently strong for most web applications. You can make this stronger as needed.
+
+The default character array is optimized for usability and accessibility, to help mobile phone users and people with disabilities: all letters are lowercase and letters that look like numbers (specifically, "i", "l", "o") are not used.
+
+== Method
+* new: optional, named parameters are length (integer) and alternate character set (array of characters, which forces the password to contain only characters from the passed array)
+
+== Examples
+  pt = PasswordText.new => "avzwbnxremcd"
+  pt4 = PasswordText.new(:length => 4) => "avzw"
+  pt4a = PasswordText.new(:length => 4, :chars => ['x','y','z']) => "yzyx"
+
+== SecureRandom
+
+Ruby 1.8.6 and older does not include a secure random number method so this gem checks to see if the SecureRandom class is defined and, if not, requires the sixarm_ruby_secure_random gem (http://github.com/sixarm/sixarm_ruby_secure_random).
+

data/lib/sixarm_ruby_password_text.rb

@@ -0,0 +1,110 @@
+=begin rdoc
+
+= SixArm Ruby Gem: PasswordText class to generate good 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
+
+Generates strong yet user-friendly passwords using Ruby's secure random cryptographic functions.
+
+You can change how passwords are created using the optional parameters and the return value is a string, so you can do string methods on it.
+
+The default length is 12 characters, which is sufficiently strong for most web applications. You can make this stronger as needed.
+
+The default character array is optimized for usability and accessibility, to help mobile phone users and people with disabilities: all letters are lowercase and letters that look like numbers (specifically, "i", "l", "o") are not used.
+
+== Method
+
+* new: optional, named parameters are length (integer) and alternate character set (array of characters, which forces the password to contain only characters from the passed array)
+
+== Examples
+  password = PasswordText.new => "avzwbnxremcd"
+  password = PasswordText.new(:length => 4) => "avzw"
+  password = PasswordText.new(:length => 4, :chars => ['x','y','z']) => "yzyx"
+
+== SecureRandom
+
+Ruby 1.8.6 and older does not include a secure random number method so this gem checks to see if the SecureRandom class is defined and, if not, requires the sixarm_ruby_secure_random gem (http://github.com/sixarm/sixarm_ruby_secure_random).
+
+=end
+
+
+if !defined?(SecureRandom) then require 'sixarm_ruby_secure_random' end
+
+
+class PasswordText < String
+
+
+ # 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
+ #   password = PasswordText.new => "avzwbnxremcd"
+ #   password = PasswordText.new(4) => "avzw"
+ #   password = PasswordText.new(4,['x','y','z']) => "yzyx"
+ #
+ # DEPRECATED, BREAKS CURRENT IMPLEMENTATION
+ # def initialize(length=@@length,chars=@@chars)
+ #   super(Array.new(length){chars[SecureRandom.random_number(chars.size)]}.join)
+ # end
+ def initialize(opts={})
+   @@length ||= opts[:length],
+   @@chars ||= opts[: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/sixarm_ruby_password_text_test.rb

@@ -0,0 +1,44 @@
+require 'test/unit'
+require 'sixarm_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,101 @@
+--- !ruby/object:Gem::Specification 
+name: sixarm_ruby_password_text
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 2
+  - 1
+  version: 1.2.1
+platform: ruby
+authors: 
+- SixArm
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDBDCCAm2gAwIBAgIJAKPwEETU5bHoMA0GCSqGSIb3DQEBBQUAMGAxCzAJBgNV
+  BAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1TYW4gRnJhbmNp
+  c2NvMQ8wDQYDVQQKEwZTaXhBcm0xEzARBgNVBAMTCnNpeGFybS5jb20wHhcNMTAx
+  MjEzMjMyNzEzWhcNMTMwOTA4MjMyNzEzWjBgMQswCQYDVQQGEwJVUzETMBEGA1UE
+  CBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5jaXNjbzEPMA0GA1UEChMG
+  U2l4QXJtMRMwEQYDVQQDEwpzaXhhcm0uY29tMIGfMA0GCSqGSIb3DQEBAQUAA4GN
+  ADCBiQKBgQC94mD9JDwBsunsOI0VR3CXXbOWg9cWaWciwFyJNFiM7A9I8KPLfXUw
+  QC4czUe5ZuG4WHvinrWhkrCK+1dWBqoEClxdF/FoKO5a+tonGCjjmfy81JmFjjyx
+  eTsjsHyvw+Qik9kpf9aj6+pnkNrVswgNHVea2o9yabbEiS6VSeJWoQIDAQABo4HF
+  MIHCMB0GA1UdDgQWBBQzPJtqmSgc53eDN7aSzDQwr9TALDCBkgYDVR0jBIGKMIGH
+  gBQzPJtqmSgc53eDN7aSzDQwr9TALKFkpGIwYDELMAkGA1UEBhMCVVMxEzARBgNV
+  BAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lzY28xDzANBgNVBAoT
+  BlNpeEFybTETMBEGA1UEAxMKc2l4YXJtLmNvbYIJAKPwEETU5bHoMAwGA1UdEwQF
+  MAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAooEexP/oPam1TP71SyuhxMb+uTrZbSQe
+  jVB+ExRwWadGwaNPUA56d39qwavwP+iu+3JpeonNMVvbWXF5naCX/dNFIeREHzER
+  ZDRQYMqru9TEMna6HD9zpcstF7vwThGovlOQ+3Y6plQ4nMzipXcZ9THqs65PIL0q
+  eabwpCbAopo=
+  -----END CERTIFICATE-----
+
+date: 2010-12-13 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bcrypt-ruby
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 5
+        version: 2.0.5
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: sixarm@sixarm.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- LICENSE.txt
+- lib/sixarm_ruby_password_text.rb
+- test/sixarm_ruby_password_text_test.rb
+has_rdoc: true
+homepage: http://sixarm.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: "SixArm Ruby Gem: Password text generator for strong web-savvy passwords"
+test_files: 
+- test/sixarm_ruby_password_text_test.rb

metadata.gz.sig

@@ -0,0 +1 @@
+e�϶��q��D�0��K�[G]i�`�t�p~醐�t�8�o�]�{4���fu�͠k�c�1��WŁ3l/*u�u�4�ڀՑm�ՖF�Wq��[I���2�&�������i���$�B