ocassionally 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 854c08962e0c26c0efdd2b5a29e2aff3c2ab9331
+  data.tar.gz: 916d3534505324151ea0948a7f824b9f493f4c9b
+SHA512:
+  metadata.gz: 98f07df61b9f475f153feba83db595501730efbc115ef02210497e4c7a48f7129b036134ca0fa52ecf3fd6d58421db286e09bb7c156ba329ae8f1ab27277dae6
+  data.tar.gz: 9ac5287c44faa1cf9ad8f99ed259797c858e0d16c9d269118b02c294277583e124129de96304b6efb1656f8e9b9b1ec3989b492f9236c679174e76ab5764eb80

data/.gitignore

@@ -0,0 +1,19 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+
+.irbrc
+.rvmrc
+.ruby-version
+.envrc

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1 @@
+You want it; its yours.

data/README.md

@@ -0,0 +1,89 @@
+# ocassionally
+
+ocassionally it works; and, ocassionally it doesn't.  Why should
+your program work the same way every time?  That is boring.
+Add some spice to your code.  Make debugging it harder.
+Model real-world things with fuzzy conditionals.
+
+Conditional blocks of the 'if' and 'unless' are so black-and-white.
+Add some color to your code with ocassionally.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ocassionally'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ocassionally
+
+## Usage
+
+```ruby
+require 'ocassionally'
+include Ocassionally
+
+# Default: default is 25% of the time test the conditional
+ocassionally(some_conditional) do
+  # interesting things
+end
+
+# Check the conditional 75% of the time
+ocassionally(75, some_conditional) do
+  # surprising things
+end
+
+# Is some_conditional too expensive to execute all the time?
+# Only execute it ocassionally.
+ocassionally(25, "some_conditional") do
+  # unexpected things
+end
+
+ocassionally("sleep(5)") { puts "Sorry I was sleeping.  What do you want?" }
+
+```
+
+The order of the two parameters does not matter.  The default for
+the rate is 25% the default for the conditional is true.  So that
+means you can also do this:
+
+```ruby
+ocassionally do
+  # weird things a quarter of the time
+end
+
+ocassionally(95) do
+  # weird things most of the time
+end
+```
+
+If you get tired of ocassionally doing things.  Try
+doing them #sometimes, #seldom, #often, #very_often, #every_time or #never.
+
+If you don't like the simplistic #__probability_function(rate)
+then over-ride it with your own.  Its Ruby.  Its your
+play ground.
+
+## Take a look at this other gem
+
+I originally called this library maybe; but, that got co-opted by
+folks who can't handle nil.  Then I called it sometimes; but, someone else
+already had that gem name which does something similar.  Take a look
+at this one:
+
+https://github.com/sudara/sometimes
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/ocassionally/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/ocassionally.rb

@@ -0,0 +1,61 @@
+module Ocassionally
+
+  def __probability_function(rate)
+    rand(100) < rate
+  end
+
+  def __get_rate_and_condition(args, default_rate, default_condition)
+    rate      = default_rate
+    condition = default_condition
+    args.each do |arg|
+      rate      = arg if [Fixnum, Float].include? arg.class
+      condition = arg if [String, TrueClass, FalseClass, NilClass].include? arg.class
+    end
+    if Float == rate.class
+      rate = (rate < 1) ? (rate * 100).to_i : rate.to_i
+    end
+    return rate, condition
+  end
+
+  def __ocassionally(rate, condition, block=nil)
+    if __probability_function(rate) && ( String == condition.class ? eval(condition) : condition )
+      block.call unless block.nil?
+    end
+  end
+
+  def sometimes(*args, &block)
+    rate, condition = __get_rate_and_condition(args, 50, true)
+    __ocassionally(rate, condition, block)
+  end
+
+  def ocassionally(*args, &block)
+    rate, condition = __get_rate_and_condition(args, 25, true)
+    __ocassionally(rate, condition, block)
+  end
+
+  def seldom(*args, &block)
+    rate, condition = __get_rate_and_condition(args, 5, true)
+    __ocassionally(rate, condition, block)
+  end
+
+  def often(*args, &block)
+    rate, condition = __get_rate_and_condition(args, 75, true)
+    __ocassionally(rate, condition, block)
+  end
+
+  def very_often(*args, &block)
+    rate, condition = __get_rate_and_condition(args, 95, true)
+    __ocassionally(rate, condition, block)
+  end
+
+  def every_time(*args, &block)
+    # defered contionals are ignored
+    yield if block_given?
+  end
+
+  def never(*args, &block)
+    # noop; but, there may be a side-effect if your conditional changes state
+  end
+
+end
+

data/lib/ocassionally/version.rb

@@ -0,0 +1,3 @@
+module Ocassionally
+  VERSION = "1.0.0"
+end

data/ocassionally.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ocassionally/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ocassionally"
+  spec.version       = Ocassionally::VERSION
+  spec.authors       = ["Dewayne VanHoozer"]
+  spec.email         = ["dvanhoozer@gmail.com"]
+  spec.summary       = %q{Ocassionally it works; and, ocassionally it doesn't}
+  spec.description   = %q{Probabilistic conditionals for fuzziness.}
+  spec.homepage      = "http://github.com/MadBomber/ocassionally"
+  spec.license       = "You want it, its yours"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: ocassionally
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Dewayne VanHoozer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Probabilistic conditionals for fuzziness.
+email:
+- dvanhoozer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/ocassionally.rb
+- lib/ocassionally/version.rb
+- ocassionally.gemspec
+homepage: http://github.com/MadBomber/ocassionally
+licenses:
+- You want it, its yours
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.3.0
+signing_key: 
+specification_version: 4
+summary: Ocassionally it works; and, ocassionally it doesn't
+test_files: []