password_generator 0.0.1

data/.gitignore

@@ -0,0 +1,38 @@
+*.gem
+*.rbc
+.bundle
+.config
+.DS_Store
+.ruby-version
+coverage
+coverage.data
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# bundler
+vendor/
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+
+# tmp-old
+.old
+
+# editor
+*~
+.redcar
+
+# other
+*.lock
+*.bak
+tool/
+.rbx/
+*\#*

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+
+rvm:
+  - ruby-head
+  - 2.0.0
+  - 1.9.3
+  - 1.9.2
+  - rbx-nightly-19mode
+  - jruby-head
+  - jruby-19mode
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: rbx-nightly-19mode
+    - rvm: jruby-head
+    - rvm: jruby-19mode
+
+before_install:
+  - gem install bundler

data/.yardopts

@@ -0,0 +1 @@
+--readme README.md lib/**/*.rb

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'rake'
+end
+
+group :test do
+  gem 'rake'
+end

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+(The MIT X11 License)
+
+Copyright (c) 2013 Kenichi Kamiya
+
+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,57 @@
+ruby-password_generator
+=======================
+
+[![Build Status](https://secure.travis-ci.org/kachick/ruby-password_generator.png)](http://travis-ci.org/kachick/ruby-password_generator)
+[![Gem Version](https://badge.fury.io/rb/ruby-password_generator.png)](http://badge.fury.io/rb/password_generator)
+
+Description
+-----------
+
+A generator for daily passwords
+
+Features
+--------
+
+* Using SecureRandom
+* Customizable to choose characters
+
+Usage
+-----
+
+```ruby
+require 'password_generator'
+
+p PasswordGenerator.generate(8)
+p PasswordGenerator.generate(24, avoid_symbols: true)
+p PasswordGenerator.generate(24, avoid_downcases: true)
+p PasswordGenerator.generate(24, avoid_uppercases: true)
+```
+
+Requirements
+-------------
+
+* Ruby - [1.9.3 or later](http://travis-ci.org/#!/kachick/ruby-password_generator)
+
+Install
+-------
+
+```bash
+gem install ruby-password_generator
+```
+
+Link
+----
+
+* [Home](http://kachick.github.com/ruby-password_generator/)
+* [code](https://github.com/kachick/ruby-password_generator)
+* [API](http://kachick.github.com/ruby-password_generator/yard/frames.html)
+* [issues](https://github.com/kachick/ruby-password_generator/issues)
+* [CI](http://travis-ci.org/#!/kachick/ruby-password_generator)
+* [gem](https://rubygems.org/gems/password_generator)
+
+License
+--------
+
+The MIT X11 License  
+Copyright (c) 2013 Kenichi Kamiya  
+See MIT-LICENSE for further details.

data/Rakefile

@@ -0,0 +1,11 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+
+task default: [:spec]
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+  t.ruby_opts = %w[-w]
+end

data/bin/password_generator

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# coding: us-ascii
+
+require_relative '../lib/password_generator'
+
+puts PasswordGenerator.generate(Integer(ARGV.shift))

data/examples/README.rb

@@ -0,0 +1,10 @@
+# coding: us-ascii
+
+$VERBOSE = true
+
+require_relative '../lib/password_generator'
+
+p PasswordGenerator.generate(8)
+p PasswordGenerator.generate(24, avoid_symbols: true)
+p PasswordGenerator.generate(24, avoid_downcases: true)
+p PasswordGenerator.generate(24, avoid_uppercases: true)

data/lib/password_generator.rb

@@ -0,0 +1,72 @@
+# coding: us-ascii
+# password_generator - A generator of daily passwords
+# Copyright (c) 2013 Kenichi Kamiya
+
+require 'securerandom'
+require 'optionalargument'
+
+require_relative 'password_generator/version'
+
+module PasswordGenerator
+
+  DOWNCASES = ('a'..'z').map(&:freeze).freeze
+  UPPERCASES = ('A'..'Z').map(&:freeze).freeze
+  NUMBERS = ('0'..'9').map(&:freeze).freeze
+  SYMBOLS = [*'!'..'/', *':'..'@', *'['..'`', *'{'..'~'].each(&:freeze).freeze
+  WHITESPACE = ' '.freeze
+
+  class << self
+
+    GENERATE_OptArg = OptionalArgument.define {
+      opt :avoid_downcases, default: false, condition: BOOLEAN?
+      opt :avoid_uppercases, default: false, condition: BOOLEAN?
+      opt :avoid_numbers, default: false, condition: BOOLEAN?
+      opt :avoid_symbols, default: false, condition: BOOLEAN?
+      opt :avoid_whitespace, default: true, condition: BOOLEAN?
+    }
+
+    # @param length [Fixnum, #to_int]
+    # @param options [Hash]
+    # @option options [Boolean] :avoid_downcases
+    # @option options [Boolean] :avoid_uppercases
+    # @option options [Boolean] :avoid_numbers
+    # @option options [Boolean] :avoid_symbols
+    # @option options [Boolean] :avoid_whitespace
+    # @return [String]
+    def generate(length, options={})
+      length = length.to_int
+      unless length >= 1
+        raise ArgumentError, "too small length thrown: #{length.inspect}"
+      end
+      options = GENERATE_OptArg.parse options
+      chars = characters_for(options).freeze
+
+      charlen = chars.length
+
+      # `Array#sample` accepts random generator via optional-argument.
+      # But the feature/syntax makes my anxiety :(
+      length.times.map{chars.fetch(SecureRandom.random_number(charlen))}.join
+    end
+
+    private
+
+    # @param options [GENERATE_OptArg]
+    # @return [Array<String>]
+    def characters_for(options)
+      chars = []
+      chars.concat(DOWNCASES) unless options.avoid_downcases
+      chars.concat(UPPERCASES) unless options.avoid_uppercases
+      chars.concat(NUMBERS) unless options.avoid_numbers
+      chars.concat(SYMBOLS) unless options.avoid_symbols
+      chars.push(WHITESPACE) unless options.avoid_whitespace
+
+      unless chars.length >= 2
+        raise ArgumentError, "using character-list is too short: #{chars.inspect}"
+      end
+
+      chars
+    end
+
+  end
+
+end

data/lib/password_generator/version.rb

@@ -0,0 +1,5 @@
+# coding: us-ascii
+
+module PasswordGenerator
+  VERSION = '0.0.1'.freeze
+end

data/lib/passwordgenerator.rb

@@ -0,0 +1,3 @@
+# coding: us-ascii
+
+require_relative 'password_generator'

data/password_generator.gemspec

@@ -0,0 +1,31 @@
+require './lib/password_generator/version'
+
+Gem::Specification.new do |gem|
+  # specific
+
+  gem.description   = %q{A generator for daily passwords}
+
+  gem.summary       = gem.description.dup
+  gem.homepage      = 'http://kachick.github.com/ruby-password_generator/'
+  gem.license       = 'MIT'
+  gem.name          = 'password_generator'
+  gem.version       = PasswordGenerator::VERSION.dup
+
+  gem.required_ruby_version = '>= 1.9.3'
+
+  gem.add_runtime_dependency 'optionalargument', '~> 0.1'
+
+  gem.add_development_dependency 'yard', '>= 0.8.6.1', '< 0.9'
+  gem.add_development_dependency 'rspec', '>= 2.13', '< 3'
+  gem.add_development_dependency 'rake', '>= 10', '< 20'
+  gem.add_development_dependency 'bundler', '>= 1.3.5', '< 2'
+
+  # common
+
+  gem.authors       = ['Kenichi Kamiya']
+  gem.email         = ['kachick1+ruby@gmail.com']
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+end

data/spec/password_generator_spec.rb

@@ -0,0 +1,98 @@
+# coding: utf-8
+
+require_relative 'spec_helper'
+
+describe PasswordGenerator do
+  describe '.generate' do
+    context "with length argument" do
+      it "raises an ArgumentError when the length is lesser equal 0" do
+        expect{PasswordGenerator.generate(0)}.to raise_error(ArgumentError)
+        expect{PasswordGenerator.generate(-8)}.to raise_error(ArgumentError)
+      end
+
+      it "returns a String" do
+        expect(PasswordGenerator.generate(1)).to be_an_instance_of(String)
+      end
+
+      context "the returned String" do
+        it "'s length equal as the first argument" do
+          expect(PasswordGenerator.generate(1).length).to eq(1)
+          expect(PasswordGenerator.generate(8).length).to eq(8)
+          expect(PasswordGenerator.generate(256).length).to eq(256)
+        end
+
+        it "is not frozen" do
+          expect(PasswordGenerator.generate(1).frozen?).to be_false
+        end
+      end
+
+      context "without options" do
+        it "builded mixed characters without whitespace" do
+          ret = PasswordGenerator.generate(512)
+          expect(ret).to match(/[a-z]/)
+          expect(ret).to match(/[A-Z]/)
+          expect(ret).to match(/\d/)
+          expect(ret).to match(/[^a-zA-Z0-9 ]/)
+          expect(ret).not_to match(/ /)
+        end
+      end
+
+      context "with options" do
+        it "builded only downcases if enabled only downcases" do
+          expect(PasswordGenerator.generate(512, avoid_downcases: false,
+                                                 avoid_uppercases: true,
+                                                 avoid_numbers: true,
+                                                 avoid_symbols: true,
+                                                 avoid_whitespace: true                                  
+            )).
+          to match(/\A[a-z]{512}\z/)
+        end
+
+        it "builded only uppercases if enabled only uppercases" do
+          expect(PasswordGenerator.generate(512, avoid_downcases: true,
+                                                 avoid_uppercases: false,
+                                                 avoid_numbers: true,
+                                                 avoid_symbols: true,
+                                                 avoid_whitespace: true                                  
+            )).
+          to match(/\A[A-Z]{512}\z/)
+        end
+
+        it "builded only numbers if enabled only numbers" do
+          expect(PasswordGenerator.generate(512, avoid_downcases: true,
+                                                 avoid_uppercases: true,
+                                                 avoid_numbers: false,
+                                                 avoid_symbols: true,
+                                                 avoid_whitespace: true                                
+            )).
+          to match(/\A\d{512}\z/)
+        end
+
+        it "builded only symbols if enabled only symbols" do
+          expect(PasswordGenerator.generate(512, avoid_downcases: true,
+                                                 avoid_uppercases: true,
+                                                 avoid_numbers: true,
+                                                 avoid_symbols: false,
+                                                 avoid_whitespace: true                                  
+            )).
+          to match(/\A[^a-zA-Z0-9 ]{512}\z/)
+        end
+
+        it "builded mixed characters with whitespace if disabled avoiding whitespace" do
+          ret = PasswordGenerator.generate(512, avoid_whitespace: false)
+          expect(ret).to match(/[a-z]/)
+          expect(ret).to match(/[A-Z]/)
+          expect(ret).to match(/\d/)
+          expect(ret).to match(/[^a-zA-Z0-9]/)
+          expect(ret).to match(/ /)
+        end
+      end
+    end
+
+    context "without arguments" do
+      it "raises an ArgumentError" do
+        expect{PasswordGenerator.generate}.to raise_error(ArgumentError)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+# coding: us-ascii
+
+require 'rspec'
+
+require_relative '../lib/password_generator'

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: password_generator
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Kenichi Kamiya
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: optionalargument
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.6.1
+    - - <
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.6.1
+    - - <
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.13'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.13'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '10'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '10'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '20'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2'
+description: A generator for daily passwords
+email:
+- kachick1+ruby@gmail.com
+executables:
+- password_generator
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- .yardopts
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- bin/password_generator
+- examples/README.rb
+- lib/password_generator.rb
+- lib/password_generator/version.rb
+- lib/passwordgenerator.rb
+- password_generator.gemspec
+- spec/password_generator_spec.rb
+- spec/spec_helper.rb
+homepage: http://kachick.github.com/ruby-password_generator/
+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: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: A generator for daily passwords
+test_files:
+- spec/password_generator_spec.rb
+- spec/spec_helper.rb
+has_rdoc: