perhaps 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 785b69710c89095f9ac977bbe9e7e0acac527478
4
+ data.tar.gz: 1d6bf1fba4e5ef7e196d8f6b68cfd08ea58575df
5
+ SHA512:
6
+ metadata.gz: 8005000a1ee8e50f53fe7b9ba40f167a4d7d8961fbbfb07ea51a45d2621abb4bd38ac04dcec8eeeedaf4d4dad72ca9b0df69caacf8372ce0a25a0bb1a25f4311
7
+ data.tar.gz: 628490f1e2af3d70606f0675505a338b4ae7dd9642fe586533a52bb9b5324a27bed1c084883e7034145e9755c7273ea89290612f33e9860b2011e2532a4adf49
@@ -0,0 +1,17 @@
1
+ *.gem
2
+ *.rbc
3
+ .bundle
4
+ .config
5
+ .yardoc
6
+ Gemfile.lock
7
+ InstalledFiles
8
+ _yardoc
9
+ coverage
10
+ doc/
11
+ lib/bundler/man
12
+ pkg
13
+ rdoc
14
+ spec/reports
15
+ test/tmp
16
+ test/version_tmp
17
+ tmp
data/Gemfile ADDED
@@ -0,0 +1,4 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in perhaps.gemspec
4
+ gemspec
@@ -0,0 +1,22 @@
1
+ Copyright (c) 2013 Niels Buus
2
+
3
+ MIT License
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ "Software"), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,55 @@
1
+ # Perhaps
2
+
3
+ This a gem of a limited usefulness developed for the sole purpose of experimenting with Ruby's dynamic anarchy. It adds a global `perhaps` method (aliased as `maybe`), allowing you to write non-deterministic code easily.
4
+
5
+ ## Installation
6
+
7
+ Add this line to your application's Gemfile:
8
+
9
+ gem 'perhaps'
10
+
11
+ And then execute:
12
+
13
+ $ bundle
14
+
15
+ Or install it yourself as:
16
+
17
+ $ gem install perhaps
18
+
19
+ ## Usage
20
+
21
+ You can now replace traditional control structures with less predictable ones.
22
+
23
+ ```ruby
24
+ perhaps do
25
+ some_object.save
26
+ end
27
+ ```
28
+
29
+ or if it looks better to you
30
+
31
+ ```ruby
32
+ maybe do
33
+ something_else.save
34
+ end
35
+ ```
36
+
37
+ In both cases, the block has a 50% probability of executing.
38
+
39
+ If you want to alter that, you can add an argument
40
+
41
+ ```ruby
42
+ maybe(0.8) do
43
+ puts "This is pretty likely to happen"
44
+ end
45
+ ```
46
+
47
+ and your block will have an 80% probability of executing. Filling in additional arguments, non-numeric values or any numeric values outside the (0..1) range will trigger an ArgumentError.
48
+
49
+ ## Contributing
50
+
51
+ 1. Fork it
52
+ 2. Create your feature branch (`git checkout -b my-new-feature`)
53
+ 3. Commit your changes (`git commit -am 'Add some feature'`)
54
+ 4. Push to the branch (`git push origin my-new-feature`)
55
+ 5. Create new Pull Request
@@ -0,0 +1,11 @@
1
+ require "perhaps/version"
2
+
3
+ module Kernel
4
+ def perhaps(probability = 0.5)
5
+ raise ArgumentError unless probability.kind_of? Numeric
6
+ raise ArgumentError unless (0..1).include? probability
7
+ yield if probability > rand
8
+ end
9
+
10
+ alias_method :maybe, :perhaps
11
+ end
@@ -0,0 +1,5 @@
1
+ require "perhaps/version"
2
+
3
+ module
4
+
5
+ end
@@ -0,0 +1,3 @@
1
+ module Perhaps
2
+ VERSION = "1.0.0"
3
+ end
@@ -0,0 +1,23 @@
1
+ # coding: utf-8
2
+ lib = File.expand_path('../lib', __FILE__)
3
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
4
+ require 'perhaps/version'
5
+
6
+ Gem::Specification.new do |spec|
7
+ spec.name = "perhaps"
8
+ spec.version = Perhaps::VERSION
9
+ spec.authors = ["Niels Buus"]
10
+ spec.email = ["nielsbuus@gmail.com"]
11
+ spec.description = %q{Tired of if and else? Try maybe.}
12
+ spec.summary = %q{This gem extends the kernel with a maybe method to make your control flow out of control.}
13
+ spec.homepage = "https://github.com/nielsbuus/perhaps"
14
+ spec.license = "MIT"
15
+
16
+ spec.files = `git ls-files`.split($/)
17
+ spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
18
+ spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
19
+ spec.require_paths = ["lib"]
20
+
21
+ spec.add_development_dependency "bundler", "~> 1.3"
22
+ spec.add_development_dependency "rspec"
23
+ end
@@ -0,0 +1,53 @@
1
+ require 'perhaps'
2
+
3
+ describe Perhaps do
4
+
5
+ it 'should have perhaps defined' do
6
+ self.should respond_to :perhaps
7
+ end
8
+
9
+ it 'should have perhaps aliased as maybe' do
10
+ self.should respond_to :maybe
11
+ end
12
+
13
+ it 'should accept no parameters' do
14
+ self.should respond_to(:perhaps).with(0).arguments
15
+ end
16
+
17
+ it 'should accept one argument' do
18
+ self.should respond_to(:perhaps).with(1).argument
19
+ end
20
+
21
+ it 'should raise error for non-numeric arguments' do
22
+ expect {self.perhaps("you could") {"do"}}.to raise_error(ArgumentError)
23
+ end
24
+
25
+ it 'should raise error for numeric arguments outside 0..1 range' do
26
+ expect {self.perhaps(1.5) {"do"}}.to raise_error(ArgumentError)
27
+ end
28
+
29
+ it 'should most certainly run a block with maximum probability' do
30
+ subject = "case"
31
+ perhaps 1 do
32
+ subject.upcase!
33
+ end
34
+ subject.should eql 'CASE'
35
+ end
36
+
37
+ it 'should certainly not run a block with no probability' do
38
+ subject = "case"
39
+ perhaps 0 do
40
+ subject.upcase!
41
+ end
42
+ subject.should eql 'case'
43
+ end
44
+
45
+ it 'might run a block with default probability' do
46
+ subject = "case"
47
+ perhaps do
48
+ subject.upcase!
49
+ end
50
+ ["case", "CASE"].should include subject
51
+ end
52
+
53
+ end
metadata ADDED
@@ -0,0 +1,83 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: perhaps
3
+ version: !ruby/object:Gem::Version
4
+ version: 1.0.0
5
+ platform: ruby
6
+ authors:
7
+ - Niels Buus
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2013-07-04 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: bundler
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ~>
18
+ - !ruby/object:Gem::Version
19
+ version: '1.3'
20
+ type: :development
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ~>
25
+ - !ruby/object:Gem::Version
26
+ version: '1.3'
27
+ - !ruby/object:Gem::Dependency
28
+ name: rspec
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - '>='
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :development
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - '>='
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ description: Tired of if and else? Try maybe.
42
+ email:
43
+ - nielsbuus@gmail.com
44
+ executables: []
45
+ extensions: []
46
+ extra_rdoc_files: []
47
+ files:
48
+ - .gitignore
49
+ - Gemfile
50
+ - LICENSE.txt
51
+ - README.md
52
+ - lib/perhaps.rb
53
+ - lib/perhaps.rb.save
54
+ - lib/perhaps/version.rb
55
+ - perhaps.gemspec
56
+ - spec/perhaps_spec.rb
57
+ homepage: https://github.com/nielsbuus/perhaps
58
+ licenses:
59
+ - MIT
60
+ metadata: {}
61
+ post_install_message:
62
+ rdoc_options: []
63
+ require_paths:
64
+ - lib
65
+ required_ruby_version: !ruby/object:Gem::Requirement
66
+ requirements:
67
+ - - '>='
68
+ - !ruby/object:Gem::Version
69
+ version: '0'
70
+ required_rubygems_version: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - '>='
73
+ - !ruby/object:Gem::Version
74
+ version: '0'
75
+ requirements: []
76
+ rubyforge_project:
77
+ rubygems_version: 2.0.2
78
+ signing_key:
79
+ specification_version: 4
80
+ summary: This gem extends the kernel with a maybe method to make your control flow
81
+ out of control.
82
+ test_files:
83
+ - spec/perhaps_spec.rb