linkingpaths-alea 0.0.2

data/HISTORY

@@ -0,0 +1,4 @@
+== 0.0.1 2008-09-17
+
+* 1 major enhancement:
+  * Initial release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Linking Paths
+
+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/Manifest.txt

@@ -0,0 +1,19 @@
+HISTORY
+LICENSE
+Manifest.txt
+POSTINSTALL
+README.markdown
+Rakefile
+config/hoe.rb
+config/requirements.rb
+lib/alea.rb
+lib/alea/kernel.rb
+lib/alea/numeric.rb
+lib/alea/percentage.rb
+lib/alea/range.rb
+lib/alea/version.rb
+test/test_helper.rb
+test/test_kernel.rb
+test/test_numeric.rb
+test/test_percentage.rb
+test/test_range.rb

data/POSTINSTALL

@@ -0,0 +1,3 @@
+
+For more information on alea, see http://github.com/linkingpaths/alea
+

data/README.markdown

@@ -0,0 +1,71 @@
+alea
+============
+alea is a tiny gem that aim to bring some aleatory behavior to ruby Kernel.
+
+> Alea - Greek soldier (From Wikipedia, the free encyclopedia):
+"Alea was a Greek soldier who reputedly [invented the dicing game](http://books.google.co.uk/books?id=7rEkOX8NmM0C&pg=RA1-PA61&lpg=RA1-PA61&dq=disis+occidens+adam&source=web&ots=0MbgJ4ioAf&sig=Gu5-vxetefyJJeB8wTuGPzzFZQo&hl=en&sa=X&oi=book_result&resnum=1&ct=result#PRA1-PA60,M1) ['Tabula'](http://en.wikipedia.org/wiki/Tabula).This is the origin of the name aléatoire, meaning random.
+
+Install
+-------
+
+´sudo gem install linkingpaths-alea´
+
+The junk 
+--------
+<pre>
+require 'alea'
+
+# Add between 10 and 25 friends to a user
+@user.add_friends rand_within(10..25)
+
+# 75% chances of this happens
+frequently do
+  update_profile(@user) 
+end
+
+# 65% chances of this happens
+probably do
+  @group.activate!
+end
+
+# 20% chances of this happens
+rarely do
+  generate_404
+end
+
+# 5% chances of this happens
+almost_never do
+    grant_admin_privileges(@user)
+end
+
+# 95% chances of this happens
+almost_always do
+  post_incorrect_data_for_captcha
+end
+
+# 50% chances of true 
+@group.moderated = maybe
+
+# Calculate rounded percents 
+send_mail_to 20.percent.of(the_community)
+
+
+</pre> 
+
+PS: I will probably give the option of set custom % via Alea::PROBABLY, Alea::RARELY etc. soon.
+
+Credits
+-------
+
+This code is based and inspired on some chunks of code appeared on the always entertaining, brilliant and funny [project.ioni.st](http://project.ioni.st/) tumblelog.
+
+More
+-------
+
+[http://github.com/linkingpaths/alea](http://github.com/linkingpaths/alea)
+
+[http://github.com/linkingpaths/alea/wikis](http://github.com/linkingpaths/alea/wikis)
+
+
+Copyright (c) 2008 Linking Paths, released under the MIT license
+

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/config/hoe.rb

@@ -0,0 +1,39 @@
+require 'alea/version'
+
+AUTHOR = 'Linking Paths'  # can also be an array of Authors
+EMAIL = "aitor@linkingpaths.com"
+DESCRIPTION = "alea is a tiny gem that aim to bring some aleatory behavior to ruby Kernel."
+GEM_NAME = 'alea' 
+HOMEPATH = "http://github.com/linkingpaths/alea"
+EXTRA_DEPENDENCIES = []
+
+REV = nil
+# UNCOMMENT IF REQUIRED:
+# REV = YAML.load(`svn info`)['Revision']
+VERS = Alea::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'alea documentation',
+    "--opname", "index.html",
+    "--line-numbers",
+    "--main", "README",
+    "--inline-source"]
+
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.developer(AUTHOR, EMAIL)
+  p.description = DESCRIPTION
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+
+  # == Optional
+  p.changes = p.paragraphs_of("HISTORY", 0..1).join("\n\n")
+  #p.extra_deps = EXTRA_DEPENDENCIES
+
+    #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  end
+
+CHANGES = $hoe.paragraphs_of('HISTORY', 0..1).join("\\n\\n")
+$hoe.spec.post_install_message = File.open(File.dirname(__FILE__) + "/../POSTINSTALL").read rescue ""

data/config/requirements.rb

@@ -0,0 +1,15 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe ].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))

data/lib/alea.rb

@@ -0,0 +1,4 @@
+require 'alea/percentage'
+require 'alea/kernel'
+require 'alea/numeric'
+require 'alea/range'

data/lib/alea/kernel.rb

@@ -0,0 +1,40 @@
+module Kernel
+
+  def rand_within(range)
+    rand(range.max - range.min) + range.min
+  end
+
+  def maybe(percent = 50.percent, &block)
+    chances_of_this_happens 50.percent, &block
+  end
+
+  def frequently(&block)
+    chances_of_this_happens 75.percent, &block
+  end
+
+  def probably(&block)
+    chances_of_this_happens 65.percent, &block
+  end
+
+  def rarely(&block)
+    chances_of_this_happens 20.percent, &block
+  end
+
+  def almost_never(&block)
+    chances_of_this_happens 5.percent, &block
+  end
+
+  def almost_always(&block)
+    chances_of_this_happens 95.percent, &block
+  end
+
+  def chances_of_this_happens(percent = 50.percent, &block)
+    if block_given?
+      percent.chance.of &block
+    else
+      percent.chance.happens?
+    end
+    
+  end
+  
+end

data/lib/alea/numeric.rb

@@ -0,0 +1,7 @@
+class Numeric
+
+  def percent
+    Percentage.new(self)
+  end
+
+end

data/lib/alea/percentage.rb

@@ -0,0 +1,30 @@
+class Percentage
+  attr_reader :amount
+  def initialize(amount)
+    @amount = amount
+  end
+
+  def chance
+    Chance.new(self)
+  end
+
+  def of(number, rounded=true)
+    p = number * amount / 100.0
+    rounded ? p.round : p
+  end
+
+  class Chance
+    attr_reader :odds, :happens
+    alias :happens? :happens
+    
+    def initialize(percent)
+      @odds    = percent.amount
+      @happens = @odds > Kernel.rand(100)
+    end
+    
+    def of(&block)
+      yield if happens?
+    end
+  end
+
+end

data/lib/alea/range.rb

@@ -0,0 +1,7 @@
+class Range
+
+  def percent
+    Percentage.new(rand_within(self))
+  end
+
+end

data/lib/alea/version.rb

@@ -0,0 +1,9 @@
+module Alea
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 2
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/alea'

data/test/test_kernel.rb

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestKernel < Test::Unit::TestCase
+
+  def test_rand_within
+    100_000.times{
+      lottery = rand_within(10..20)
+      assert lottery >=10 && lottery <= 20
+    }
+  end
+
+end

data/test/test_numeric.rb

@@ -0,0 +1,14 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestNumeric < Test::Unit::TestCase
+
+  def test_regular_percent
+    assert_equal 10, 10.percent.of(100)
+  end
+  def test_rounded_percent
+    assert_equal 10, 10.percent.of(99)
+  end
+  def test_not_rounded_percent
+    assert_equal 9.9, 10.percent.of(99, false)  
+  end
+end

data/test/test_percentage.rb

@@ -0,0 +1,13 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestPercentage < Test::Unit::TestCase
+
+  def test_amount
+    assert_equal 10, 10.percent.amount
+    assert_equal 10.5, 10.5.percent.amount
+  end
+  def test_odds
+    assert_equal 10, 10.percent.chance.odds
+  end
+
+end

data/test/test_range.rb

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestRange < Test::Unit::TestCase
+
+  def test_regular_percent
+    estimation = (5..10).percent.of(100)
+    assert estimation >= 5 && estimation <= 10
+  end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: linkingpaths-alea
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Linking Paths
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-04 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: alea is a tiny gem that aim to bring some aleatory behavior to ruby Kernel.
+email: 
+- aitor@linkingpaths.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- Manifest.txt
+files: 
+- HISTORY
+- LICENSE
+- Manifest.txt
+- POSTINSTALL
+- README.markdown
+- Rakefile
+- config/hoe.rb
+- config/requirements.rb
+- lib/alea.rb
+- lib/alea/kernel.rb
+- lib/alea/numeric.rb
+- lib/alea/percentage.rb
+- lib/alea/range.rb
+- lib/alea/version.rb
+- test/test_helper.rb
+- test/test_kernel.rb
+- test/test_numeric.rb
+- test/test_percentage.rb
+- test/test_range.rb
+has_rdoc: true
+homepage: http://github.com/linkingpaths/alea
+post_install_message: |+
+  
+  For more information on alea, see http://github.com/linkingpaths/alea
+  
+rdoc_options: 
+- --main
+- README.txt
+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: alea
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: alea is a tiny gem that aim to bring some aleatory behavior to ruby Kernel.
+test_files: 
+- test/test_helper.rb
+- test/test_kernel.rb
+- test/test_numeric.rb
+- test/test_percentage.rb
+- test/test_range.rb