maybe2 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a084b6f8abf8b1fae7dba9732dad6f39c6256ce6
+  data.tar.gz: 8a06ad0660a4219be68730dbfa2a1c2410d55ad6
+SHA512:
+  metadata.gz: 914023b2e80af3952117ba0ad52d6a5672d247cdde79cb8910d9c33a21d49f309bc99fc5ff0523d75977e6107cb408cfd87d0478893f392a4757bec9b2d9bb98
+  data.tar.gz: b98f835236d21cd23df3cb1277cb546bf3b8caa33092df95594f0cd4ea3f796def802f0b2afa5579fa721569266e325dc0635398dc5ad69f64c2cd6b95153889

data/.gitignore

@@ -0,0 +1,10 @@
+*.gem
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format documentation
+--require spec_helper.rb

data/.travis.yml

@@ -0,0 +1,21 @@
+language: ruby
+
+rvm:
+  - 2.2.2
+  - 2.1.6
+  - 2.0.0
+  - 1.9.3
+  - jruby-19mode
+
+branches:
+  only:
+    - master
+
+notifications:
+  email:
+    on_success: change
+    on_failure: always
+
+before_install: "gem install bundler -v 1.10.5"
+install: "bundle --jobs 4"
+script: "bundle exec rspec"

data/.yardopts

@@ -0,0 +1,7 @@
+--protected
+--private
+--embed-mixins
+lib/**/*.rb
+-
+README.md
+LICENSE.txt

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Oldrich Vetesnik
+
+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,76 @@
+# Maybe2 [![Build Status](https://img.shields.io/travis/ollie/maybe2/master.svg)](https://travis-ci.org/ollie/maybe2) [![Code Climate](https://img.shields.io/codeclimate/github/ollie/maybe2.svg)](https://codeclimate.com/github/ollie/maybe2)
+
+Wrap a value into a Maybe monad (or Optional type). Since monads are chainable
+and every value is wrapped in one, things don't blow up with `NoMethodError`
+on `nil`s.
+
+Useful for retrieving something in deeply nested structures where `nil`s
+could be produced along the way.
+
+## Usage
+
+```ruby
+maybe = Maybe.new('Hello world').upcase.reverse
+maybe.class  # => Maybe
+maybe.unwrap # => 'Hello world'
+
+maybe = Maybe.new(nil).upcase.reverse
+maybe.class  # => Maybe
+maybe.unwrap # => nil
+
+maybe = Maybe.new('Hello world').make_nil.upcase.reverse
+maybe.class  # => Maybe
+maybe.unwrap # => nil
+```
+
+JSON example evaluation to a string:
+
+```ruby
+response = {
+  data: {
+    item: {
+      name: 'Hello!'
+    }
+  }
+}
+
+Maybe.new(good_response)[:data][:item][:name].upcase.unwrap # => 'HELLO!'
+```
+
+JSON example evaluating to nil:
+
+```ruby
+response = {
+  data: {}
+}
+
+Maybe.new(good_response)[:data][:item][:name].upcase.unwrap # => nil
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'maybe2'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install maybe2
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/ollie/maybe2.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,15 @@
+require 'bundler/gem_tasks'
+
+task default: :combo
+
+desc 'Run tests, rubocop and generate documentation'
+task :combo do
+  sh 'bundle exec rspec'
+  sh('bundle exec rubocop') {} # ignore status > 0
+  sh 'bundle exec yardoc'
+end
+
+desc 'Same as :combo but build a gem, too'
+task mega_combo: :combo do
+  sh 'gem build maybe2.gemspec'
+end

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'maybe2'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/maybe.rb

@@ -0,0 +1,113 @@
+require 'maybe/version'
+
+# Wrap a value into a Maybe monad (or Optional type). Since monads are chainable
+# and every value is wrapped in one, things don't blow up with +NoMethodError+
+# on +nil+s.
+#
+# Useful for retrieving something in deeply nested structures where +nil+s
+# could be produced along the way.
+#
+# @example Simple usage.
+#   maybe = Maybe.new('Hello world').upcase.reverse
+#   maybe.class  # => Maybe
+#   maybe.unwrap # => 'Hello world'
+#
+#   maybe = Maybe.new(nil).upcase.reverse
+#   maybe.class  # => Maybe
+#   maybe.unwrap # => nil
+#
+#   maybe = Maybe.new('Hello world').make_nil.upcase.reverse
+#   maybe.class  # => Maybe
+#   maybe.unwrap # => nil
+#
+# @example JSON example evaluation to a string.
+#   response = {
+#     data: {
+#       item: {
+#         name: 'Hello!'
+#       }
+#     }
+#   }
+#
+#   Maybe.new(good_response)[:data][:item][:name].upcase.unwrap # => 'HELLO!'
+#
+# @example JSON example evaluating to nil.
+#   response = {
+#     data: {}
+#   }
+#
+#   Maybe.new(good_response)[:data][:item][:name].upcase.unwrap # => nil
+class Maybe
+  # Wrap a value into a new +Maybe+.
+  #
+  # @param value [Object] Anything.
+  def initialize(value)
+    @value = value
+  end
+
+  # Return the wrapped value.
+  #
+  # @example
+  #   Maybe.new('Hello').unwrap        # => 'Hello'
+  #   Maybe.new('Hello').upcase.unwrap # => 'HELLO'
+  #   Maybe.new(nil).upcase.unwrap     # => nil
+  #
+  # @return [Object]
+  def unwrap
+    @value
+  end
+
+  # Chain another action and return a new value wrapped in a new +Maybe+ or
+  # the same +Maybe+ if the old value is a +nil+. Calls +chain+ under the hood.
+  #
+  # @see #chain
+  #
+  # @example
+  #   Maybe.new('Hello world').upcase.reverse
+  #
+  # @return [Maybe]
+  def method_missing(*args, &block)
+    chain do |value|
+      value.public_send(*args, &block)
+    end
+  end
+
+  # Also support +respond_to?+.
+  #
+  # @example
+  #   Maybe.new('Hello world').upcase.reverse.respond_to?(:size) # => true
+  #   Maybe.new(nil).upcase.reverse.respond_to?(:size)           # => false
+  #
+  # @return [Bool]
+  def respond_to_missing?(method_name, include_private = false)
+    super || @value.respond_to?(method_name, include_private)
+  end
+
+  # Chain another action and return a new value wrapped in a new +Maybe+ or
+  # the same +Maybe+ if the old value is a +nil+.
+  #
+  # @example
+  #   value = Maybe.new('Hello world')
+  #           .chain(&:upcase)
+  #           .chain(&:reverse)
+  #           .unwrap # => 'DLROW OLLEH'
+  #
+  #   value = Maybe.new('Hello world')
+  #           .chain { |_string| nil }
+  #           .chain(&:reverse)
+  #           .unwrap # => nil
+  #
+  # @yieldparam value [Object] Old value goes in the block.
+  # @yieldreturn      [Object] New value comes out of the block.
+  #
+  # @return [Maybe]
+  def chain
+    # Don't call the block if we are wrapping a nil (hint: that would cause
+    # a +NoMethodError+).
+    return self if @value.nil?
+
+    # Call the passed block to get the new value and wrap it again.
+    new_value = yield @value
+    self.class.new(new_value)
+  end
+end

data/lib/maybe/version.rb

@@ -0,0 +1,4 @@
+class Maybe
+  # Version number, happy now?
+  VERSION = '0.0.1'
+end

data/lib/maybe2.rb

@@ -0,0 +1,2 @@
+# I don't want the constants to be named Maybe2 but rather Maybe.
+require 'maybe'

data/maybe2.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'maybe/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'maybe2'
+  spec.version       = Maybe::VERSION
+  spec.authors       = ['Oldrich Vetesnik']
+  spec.email         = ['oldrich.vetesnik@gmail.com']
+
+  spec.summary       = 'Yet another Maybe monad implementation.'
+  spec.description   = 'Be able to chain method calls without raising ' \
+                       'a NoMethodError if there is a nil somewhere along ' \
+                       'the way.'
+  spec.homepage      = 'https://github.com/ollie/maybe2'
+  spec.license       = 'MIT'
+
+  # rubocop:disable Metrics/LineLength
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # System
+  spec.add_development_dependency 'bundler', '~> 1.10'
+
+  # Test
+  spec.add_development_dependency 'rspec',     '~> 3.3'
+  spec.add_development_dependency 'simplecov', '~> 0.10'
+
+  # Code style, debugging, docs
+  spec.add_development_dependency 'rubocop', '~> 0.32'
+  spec.add_development_dependency 'pry',     '~> 0.10'
+  spec.add_development_dependency 'yard',    '~> 0.8'
+  spec.add_development_dependency 'rake',    '~> 10.4'
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: maybe2
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Oldrich Vetesnik
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-07-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.32'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.32'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+description: Be able to chain method calls without raising a NoMethodError if there
+  is a nil somewhere along the way.
+email:
+- oldrich.vetesnik@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- ".yardopts"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/maybe.rb
+- lib/maybe/version.rb
+- lib/maybe2.rb
+- maybe2.gemspec
+homepage: https://github.com/ollie/maybe2
+licenses:
+- MIT
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Yet another Maybe monad implementation.
+test_files: []
+has_rdoc: