passwd 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in passwd.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 i2bskn
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,60 @@
+# Passwd
+
+Password utility
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'passwd'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install passwd
+
+## Usage
+
+    require 'passwd'
+
+Create random password:
+
+    password = Passwd.create
+
+Options that can be specified:
+
+* :length => Number of characters. default is 8.
+* :lower => Skip lower case if set false. default is true.
+* :upper => Skip upper case if set false. default is true.
+* :number => Skip numbers if set false. default is true.
+* :letters_lower => Define an array of lower case. default is ("a".."z").to_a
+* :letters_upper => Define an array of upper case. default is ("A".."Z").to_a
+* :letters_number => Define an array of numbers. default is ("0".."9").to_a
+
+Password hashing:
+
+    password_hash = Passwd.hashing(password)
+
+Password policy check:
+
+    Passwd.policy_check(password)
+
+Options that can be specified:
+
+* :min_length => Minimum length of password. default is 8.
+* :min_type => Minimum types of password. default is 2.(types is lower/upper/number)
+* :specify_type => Check of each types. default is false.
+* :require_lower => Require lower case if set true. specify_type enabled when true.
+* :require_upper => Require upper case if set true. specify_type enabled when true.
+* :require_number => Require number case if set true. specify_type enabled when true.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+
+Bundler.setup
+require 'rspec/core/rake_task'
+
+desc "run spec"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = ["-c", "-fs"]
+end

data/lib/passwd.rb

@@ -0,0 +1,108 @@
+# coding: utf-8
+
+require "passwd/version"
+require "digest/sha1"
+
+class Passwd
+  attr_reader :text, :hash
+  @@config = {
+    length: 8,
+    lower: true,
+    upper: true,
+    number: true,
+    letters_lower: ('a'..'z').to_a,
+    letters_upper: ('A'..'Z').to_a,
+    letters_number: ('0'..'9').to_a
+  }
+
+  @@policy = {
+    min_length: 8,
+    min_type: 2,
+    specify_type: false,
+    require_lower: true,
+    require_upper: true,
+    require_number: true
+  }
+
+  def initialize(password=nil)
+    if password.nil?
+      # Create letters
+      letters = Array.new
+      letters += @@config[:letters_lower] if @@config[:lower]
+      letters += @@config[:letters_upper] if @@config[:upper]
+      letters += @@config[:letters_number] if @@config[:number]
+
+      # Create random password
+      @text = Array.new(@@config[:length]){letters[rand(letters.size)]}.join
+    else
+      @text = password
+    end
+    # @text = password.nil? ? self.class.create : password
+    @hash = Digest::SHA1.digest @text
+  end
+
+  def text=(password)
+    @text = password
+    @hash = Digest::SHA1.digest @text
+    @text
+  end
+
+  def policy_check
+    Passwd.policy_check @text
+  end
+
+  class << self
+    def create(options={})
+      config = @@config.merge(options)
+
+      # Create letters
+      letters = Array.new
+      letters += config[:letters_lower] if config[:lower]
+      letters += config[:letters_upper] if config[:upper]
+      letters += config[:letters_number] if config[:number]
+
+      # Create random password
+      Array.new(config[:length]){letters[rand(letters.size)]}.join
+    end
+
+    def policy_check(passwd, options={})
+      policy = @@policy.merge(options)
+
+      # Check number of characters
+      return false if passwd.size < policy[:min_length]
+
+      # Check number of types of characters
+      ctype = Array.new
+      passwd.each_char.with_index do |char, i|
+        case
+        when @@config[:letters_lower].include?(char) then ctype << 0
+        when @@config[:letters_upper].include?(char) then ctype << 1
+        when @@config[:letters_number].include?(char) then ctype << 2
+        end
+      end
+      ctype.uniq!
+      return false if ctype.size < policy[:min_type]
+
+      # Check of each character type
+      if policy[:specify_type]
+        return false if policy[:require_lower] && !ctype.include?(0)
+        return false if policy[:require_upper] && !ctype.include?(1)
+        return false if policy[:require_number] && !ctype.include?(2)
+      end
+
+      true
+    end
+
+    def hashing(passwd)
+      Digest::SHA1.digest passwd
+    end
+
+    def config(options={})
+      @@config.merge!(options)
+    end
+
+    def policy(options={})
+      @@policy.merge!(options)
+    end
+  end
+end

data/lib/passwd/version.rb

@@ -0,0 +1,3 @@
+class Passwd
+  VERSION = "0.0.1"
+end

data/passwd.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'passwd/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "passwd"
+  spec.version       = Passwd::VERSION
+  spec.authors       = ["i2bskn"]
+  spec.email         = ["i2bskn@gmail.com"]
+  spec.description   = %q{The various utilities on password}
+  spec.summary       = %q{Password utility}
+  spec.homepage      = "https://github.com/i2bskn/passwd"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/spec/passwd_spec.rb

@@ -0,0 +1,177 @@
+# coding: utf-8
+
+$:.unshift File.join(File.dirname(__FILE__),'..','lib')
+
+require "passwd"
+require "digest/sha1"
+
+describe Passwd do
+  describe "singleton methods" do
+    context "#create" do
+      it "return string object" do
+        expect(Passwd.create.class).to eq(String)
+      end
+
+      it "password was created 8 characters" do
+        expect(Passwd.create.size).to eq(8)
+      end
+
+      it "password was created specified characters" do
+        expect(Passwd.create(length: 10).size).to eq(10)
+      end
+
+      it "password create without lower case" do
+        password = Passwd.create(lower: false)
+        expect(("a".."z").to_a.include?(password)).to eq(false)
+      end
+
+      it "password create without upper case" do
+        password = Passwd.create(upper: false)
+        expect(("A".."Z").to_a.include?(password)).to eq(false)
+      end
+
+      it "password create without number" do
+        password = Passwd.create(number: false)
+        expect(("0".."9").to_a.include?(password)).to eq(false)
+      end
+    end
+
+    context "#policy_check" do
+      it "return true with valid password" do
+        expect(Passwd.policy_check("09aVCud5")).to eq(true)
+      end
+
+      it "return false with less number of characters" do
+        expect(Passwd.policy_check("Secret")).to eq(false)
+      end
+
+      it "return false with less number of types" do
+        expect(Passwd.policy_check("password")).to eq(false)
+      end
+
+      it "require lower case if require_lower is true" do
+        password = Passwd.create(lower: false)
+        expect(
+          Passwd.policy_check(password, min_type: 1, specify_type: true, require_lower: true)
+        ).to eq(false)
+      end
+
+      it "require upper case if require_upper is true" do
+        password = Passwd.create(upper: false)
+        expect(
+          Passwd.policy_check(password, min_type: 1, specify_type: true, require_upper: true)
+        ).to eq(false)
+      end
+
+      it "require number case if require_number is true" do
+        password = Passwd.create(number: false)
+        expect(
+          Passwd.policy_check(password, min_type: 1, specify_type: true, require_number: true)
+        ).to eq(false)
+      end
+    end
+
+    context "#hashing" do
+      it "return string object" do
+        expect(Passwd.hashing(Passwd.create).class).to eq(String)
+      end
+
+      it "return hashed password" do
+        password = Passwd.create
+        password_hash = Digest::SHA1.digest(password)
+        expect(Passwd.hashing(password)).to eq(password_hash)
+      end
+    end
+
+    context "#config" do
+      before(:all) do
+        @default_value = Passwd.config.clone
+      end
+
+      after(:all) do
+        Passwd.config(@default_value)
+      end
+
+      it "return config hash" do
+        expect(Passwd.config.class).to eq(Hash)
+      end
+
+      it "set config value" do
+        old_value = Passwd.config[:length]
+        Passwd.config(length: 10)
+        expect(Passwd.config[:length]).not_to eq(old_value)
+      end
+    end
+
+    context "#policy" do
+      before(:all) do
+        @default_value = Passwd.policy.clone
+      end
+
+      after(:all) do
+        Passwd.policy(@default_value)
+      end
+
+      it "return policy hash" do
+        expect(Passwd.policy.class).to eq(Hash)
+      end
+
+      it "set config value" do
+        old_value = Passwd.policy[:min_length]
+        Passwd.policy(min_length: 10)
+        expect(Passwd.policy[:min_length]).not_to eq(old_value)
+      end
+    end
+  end
+
+  describe "instance methods" do
+    context "#initialize" do
+      it "set instance valiables" do
+        password = Passwd.new
+        expect(password.text.size).to eq(8)
+        expect(password.text.class).to eq(String)
+        expect(password.hash.class).to eq(String)
+      end
+
+      it "@text is specified password" do
+        pass_text = Passwd.create
+        password = Passwd.new(pass_text)
+        expect(password.text).to eq(pass_text)
+      end
+
+      it "@hash is hash of specified password" do
+        pass_text = Passwd.create
+        pass_hash = Digest::SHA1.digest(pass_text)
+        password = Passwd.new(pass_text)
+        expect(password.hash).to eq(pass_hash)
+      end
+    end
+
+    context "#text=" do
+      before(:each) do
+        @password = Passwd.new("Secret!!")
+      end
+
+      it "@text is changed" do
+        old_password = @password.text
+        @password.text = Passwd.create
+        expect(@password.text).not_to eq(old_password)
+      end
+
+      it "@hash is changed" do
+        old_hash = @password.hash
+        @password.text = Passwd.create
+        expect(@password.hash).not_to eq(old_hash)
+      end
+    end
+
+    context "#policy_check" do
+      it "Passwd.policy_check is called with pass_text" do
+        pass_text = Passwd.create
+        Passwd.should_receive(:policy_check).with(pass_text)
+        password = Passwd.new(pass_text)
+        password.policy_check
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: passwd
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- i2bskn
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The various utilities on password
+email:
+- i2bskn@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/passwd.rb
+- lib/passwd/version.rb
+- passwd.gemspec
+- spec/passwd_spec.rb
+homepage: https://github.com/i2bskn/passwd
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -460687481186337323
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -460687481186337323
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Password utility
+test_files:
+- spec/passwd_spec.rb