tekido 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a868ae3a97922903960421ce5ed892b5f5197f9a
+  data.tar.gz: 2371363b3ce8527d43572221895736b8fca5c0de
+SHA512:
+  metadata.gz: e0fc9f67ef847f1248de07755fcf23ed196fbf4d2da917db5f64e6bf1f90610c8c8a4ea2732b165679effeeb579b88bd768fb67f2065bbf39f009846acd1f082
+  data.tar.gz: 5be19c39b74a86710c10ea207ea8130a4610165633a79727fabbeb37463fb55c3366fe901e5ac9af48df3eba644c4a0ca11b89941d25214feb5af88ed7dcf5a3

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 pinzolo
+
+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,188 @@
+# Tekido
+
+[![Build Status](https://secure.travis-ci.org/pinzolo/tekido.png)](http://travis-ci.org/pinzolo/tekido)
+[![Coverage Status](https://coveralls.io/repos/pinzolo/tekido/badge.png)](https://coveralls.io/r/pinzolo/tekido)
+
+`Tekido` is a module that generates various random value.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'tekido'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tekido
+
+## Usage
+
+`Tekido` has below methods. (All methods are dependent on `Kernel.rand`)
+
+### .yes?
+
+It returns random boolean.
+
+```ruby
+# true: 50%, false: 50%
+Tekido.yes?
+
+# true: 80%, false: 20%
+Tekido.yes?(80)
+```
+
+### .percent
+
+It retuens random percentage (0..100). It behaves the same as `rand(0..100)`.
+
+### .percent_as
+
+It returns random percentage. Can select return value type.
+
+```ruby
+# returns integer (Tekido.percent behaves it, too)
+Tekido.percent_as(:integer)
+
+# returns float
+Tekido.percent_as(:float)
+
+# returns integer that is multiple of 5 (ex. 10, 35)
+Tekido.percent_as(:mo5)
+
+# returns integer that is multiple of 10 (ex. 10, 70)
+Tekido.percent_as(:deca)
+Tekido.percent_as(:mo10)
+```
+
+### .integer
+
+It always returns random value as integer.
+
+```ruby
+# returns integer (0 <= value <= 1073741823)
+Tekido.integer
+
+# returns integer that not over argument
+Tekido.integer(9999)
+
+# returns integer that is included in argument
+Tekido.integer(1..1234)
+```
+
+### .float
+
+It always returns random value as float. The different with `rand` is return value type only.
+
+```ruby
+# returns float (0 <= value < 1)
+Tekido.float
+
+# returns float that not over argument
+Tekido.float(777.77)
+
+# returns float that is included in argument
+Tekido.float(1..1234)
+Tekido.float(1.1..1234.5)
+```
+
+### .list
+
+It returns Array instance that is filled by given sample values and ratio.
+
+```ruby
+# returns Array instance that contains 'one': 25%, 'two': 25%, 'three': 25%, 'four': 25%
+Tekido.list(10000, %w(one two three four))
+
+# returns Array instance that contains 'one': 11.1%, 'two': 22.2%, 'three': 33.3%, 'four': 33.4%
+Tekido.list(10000, 'one' => 11.1, 'two' => 22.2, 'three' => 33.3, 'four' => 33.4)
+
+# returns Array instance that contains 'one': 10%, 'two': 20%, 'three': 30%, nil: 40% (rests)
+Tekido.list(10000, 'one' => 10, 'two' => 20, 'three' => 30)
+```
+
+### .date
+
+It returns random Date instance.
+
+```ruby
+# returns Date (0001-01-01 <= value <= 9999-12-31)
+Tekido.date
+
+# returns Date (2010-01-01 <= value <= 2010-12-31)
+Tekido.date(2010)
+
+# returns Date (1999-01-01 <= value <= 2007-12-31)
+Tekido.date(1999..2007)
+
+# returns Date (1999-02-21 <= value <= 2003-10-07)
+Tekido.date(Date.new(1999, 2, 21)..Date.new(2003, 10, 7))
+```
+
+### .birthday
+
+It returns random birthday as Date instance.
+
+```ruby
+# returns Date as birthday satisfying that current age is more than 0 and less than 100
+Tekido.birthday
+
+# returns Date as birthday satisfying that current age is given argument
+Tekido.birthday(28)
+
+# returns Date as birthday satisfying that current age is within given argument
+Tekido.birthday(21..25)
+```
+
+### .string
+
+It returns random String instance.
+
+```ruby
+# returns String instance that is costructed by upper characters, lower characters and numeric characters, and size is within 1..255.
+Tekido.string
+
+# returns String instance that is costructed by lower characters and numeric characters, and size is 10.
+# components option accepts :upper or :lower or :number or combination of these.
+Tekido.string(size: 10, components: [:upper, :number])
+
+# returns String instance that is costructed by given characters (ex. x39yyz177x) , and size is within 8..16.
+# chars option overrides components option
+Tekido.string(size: 8..16, chars: %w(1 3 5 7 9 x y z))
+```
+
+### email
+
+It returns random email address.
+
+```ruby
+# returns email address that has example domain. (ex. eamh0aga@example.com)
+Tekido.email
+
+# returns email address that has given domain. (ex. oiuade@foobar.com)
+Tekido.email('foobar.com')
+
+# returns email address that has same domain as given email address. (ex. dkauy3akhf@baz.com)
+Tekido.email("foo.bar@baz.com")
+
+# .email accepts multiple domains or base email addresses.
+Tekido.email('test@foo.com', 'bar.com', '@baz.com')
+```
+
+
+## Supported ruby versions
+
+* 1.9.3
+* 2.0.0
+* 2.1.0
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+
+task :default => [:spec]
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec) do |spec|
+    spec.pattern = 'spec/**/*_spec.rb'
+    spec.rspec_opts = ['-cfs']
+  end
+rescue LoadError => e
+end

data/USAGE_ja.md

@@ -0,0 +1,153 @@
+# Tekido
+
+`Tekido` とはさまざまなランダム値を出力するモジュールです。
+
+`Tekido` は以下のメソッドを持っています。(全て `Kernel.rand` に依存しています)
+
+### .yes?
+
+ランダムな真偽値を返します。
+
+```ruby
+# true: 50%, false: 50%
+Tekido.yes?
+
+# true: 80%, false: 20%
+Tekido.yes?(80)
+```
+
+### .percent
+
+ランダムで 0 から 100 までの百分率（数値）を返します。`rand(0..100)` と同じ動きをします。
+
+### .percent_as
+
+ランダムで 0 から 100 までの百分率（数値）を返します。戻り値の型などを指定できます。
+
+```ruby
+# 整数で返します。
+Tekido.percent_as(:integer)
+
+# 小数で返します。
+Tekido.percent_as(:float)
+
+# 5の倍数の整数を返します。
+Tekido.percent_as(:mo5)
+
+# 10の倍数の整数を返します。
+Tekido.percent_as(:deca)
+Tekido.percent_as(:mo10)
+```
+
+### .integer
+
+ランダムな整数を返します。
+
+```ruby
+# 0 から 1073741823 までの範囲にある整数を返します。
+Tekido.integer
+
+# 指定の上限を超えない 0 以上の整数を返します。
+Tekido.integer(9999)
+
+# 指定の範囲内にある整数を返します。
+Tekido.integer(1..1234)
+```
+
+### .float
+
+ランダムな小数を返します。
+
+```ruby
+# 0 以上 1 未満の小数を返します。
+Tekido.float
+
+# 指定の上限を超えない 0 以上の小数を返します。
+Tekido.float(777.77)
+
+# 指定の範囲内にある少数を返します。
+Tekido.float(1..1234)
+Tekido.float(1.1..1234.5)
+```
+
+### .list
+
+指定の値と割合でランダムに値を埋めた配列を返します。
+
+```ruby
+# 等割合で埋めた配列を返します。('one': 25%, 'two': 25%, 'three': 25%, 'four': 25%)
+Tekido.list(10000, %w(one two three four))
+
+# 指定の配分で埋めた配列を返します。
+Tekido.list(10000, 'one' => 11.1, 'two' => 22.2, 'three' => 33.3, 'four' => 33.4)
+
+# 足りない部分は nil で埋められます。('one': 10%, 'two': 20%, 'three': 30%, nil: 40% (rests))
+Tekido.list(10000, 'one' => 10, 'two' => 20, 'three' => 30)
+```
+
+### .date
+
+ランダムな日付を返します。
+
+```ruby
+# 0001-01-01 から 9999-12-31 までの日付を返します。
+Tekido.date
+
+# 指定の年に所属する日付を返します。
+Tekido.date(2010)
+
+# 指定された範囲に所属する年の日付を返します。
+Tekido.date(1999..2007)
+
+# 指定された範囲に所属する日付を返します。
+Tekido.date(Date.new(1999, 2, 21)..Date.new(2003, 10, 7))
+```
+
+### .birthday
+
+誕生日として使用できるランダムな日付を返します。
+
+```ruby
+# 現時点で 0 歳から 100 歳までの年齢となる日付を返します。
+Tekido.birthday
+
+# 指定された年齢となるランダムな誕生日を返します。
+Tekido.birthday(28)
+
+# 指定された範囲に含まれる年齢となるランダムな誕生日を返します。
+Tekido.birthday(21..25)
+```
+
+### .string
+
+ランダムな文字列を返します。
+It returns random String instance.
+
+```ruby
+# 1 文字以上、255 文字以内の、大文字・小文字・数字からなるランダムな文字列を返します。
+Tekido.string
+
+# 長さが 10 で、大文字と数字からなるランダムな文字列を返します。
+Tekido.string(size: 10, components: [:upper, :number])
+
+# 長さが 8 文字以上、16文字以内の、:chars で指定された文字だけで構成されたランダムな文字列を返します。
+Tekido.string(size: 8..16, chars: %w(1 3 5 7 9 x y z))
+```
+
+### email
+
+ランダムなメールアドレスを返します。
+
+```ruby
+# テスト用ドメインのランダムなメールアドレスを返します。
+Tekido.email
+
+# ドメインを指定したランダムなメールアドレスを返します。
+Tekido.email('foobar.com')
+
+# メールアドレス形式でドメインを指定できます。
+Tekido.email('foo.bar@baz.com')
+
+# ドメイン指定は複数可能です。（形式は混在できます）
+Tekido.email('test@foo.com', 'bar.com', '@baz.com')
+```

data/lib/tekido.rb

@@ -0,0 +1,7 @@
+# coding: utf-8
+require "tekido/version"
+require "tekido/methods"
+
+module Tekido
+  include Methods
+end

data/lib/tekido/methods.rb

@@ -0,0 +1,15 @@
+# coding: utf-8
+require "tekido/methods/percentage"
+require "tekido/methods/boolean"
+require "tekido/methods/numeric"
+require "tekido/methods/array"
+require "tekido/methods/date"
+require "tekido/methods/string"
+
+module Tekido
+  module Methods
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+  end
+end

data/lib/tekido/methods/array.rb

@@ -0,0 +1,48 @@
+# coding: utf-8
+module Tekido
+  module Methods
+    module ClassMethods
+      def list(size, value_defs)
+        range_and_values = range_and_values_from(value_defs)
+
+        Array.new(size) do |i|
+          per = percent_as(:float)
+          match = range_and_values.find { |item| item.first.include?(per) }
+          match ? match.last : nil
+        end
+      end
+
+      private
+      def range_and_values_from(value_defs)
+        if value_defs.is_a?(Array)
+          range_and_values_from_array(value_defs)
+        elsif value_defs.is_a?(Hash)
+          range_and_values_from_value_ratios(value_defs)
+        else
+          []
+        end
+      end
+      def range_and_values_from_array(values)
+        [].tap do |array|
+          values.each do |value|
+            min = array.empty? ? 0.0 : array.last.first.max
+            max = min + (100.0 / values.size)
+            array << [(min..max), value]
+          end
+        end
+      end
+
+      def range_and_values_from_value_ratios(value_ratios)
+        [].tap do |array|
+          value_ratios.each do |value, ratio|
+            min = array.empty? ? 0.0 : array.last.first.max
+            max = min + ratio.to_f
+            array << [(min..max), value]
+          end
+        end
+      end
+    end
+  end
+end
+
+