either-monad 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f42a1d3e60ecd54825b268c689ee48be2de686f5
+  data.tar.gz: 080abd900338fb3b82b37dcd9b03869f96be3cdb
+SHA512:
+  metadata.gz: 19963b9a3f84aed941a21e54fc0ec7e428008da8fc6bb45ef948120f1e4180bee50732760478084f3a30fff8b84e176eda608ca6a4437eefb1c9e05e45335c63
+  data.tar.gz: e59f50faab6fb6cb91a2dc2866062452b0933e43b597bd49ee02667abad01a68724823074d57aaaa05a4994111ed1e9d9b454c41d2627921a02c2e6ef6c723ee

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Denis Redozubov
+
+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,21 @@
+Either
+======
+
+Dead simple error context framework aka Either monad. Goal of this gem is to
+provide solid ground to control flow without exceptions and allow simple and
+expressive chaining failure context.
+
+Installation
+------------
+
+in terminal
+
+``` terminal
+$ gem install either-monad
+```
+
+or in **Gemfile**
+
+``` ruby
+gem 'either-monad'
+```

data/Rakefile

@@ -0,0 +1,29 @@
+$LOAD_PATH << File.expand_path('./lib')
+require "rotary"
+
+task :build do
+  system "gem build either-monad.gemspec"
+end
+
+task :release => :build do
+  system "gem push either-monad-#{Either::VERSION}"
+end
+
+task :console do
+  require 'pry'
+  require 'either-monad'
+  ARGV.clear
+  Pry.start
+end
+task :c => :console
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << "lib"
+  t.libs << "spec"
+  t.test_files = FileList['spec/**/*_spec.rb']
+  t.verbose = true
+end
+task :spec => :test
+task :default => :test

data/lib/either.rb

@@ -0,0 +1,50 @@
+# Do not instantiate this class EVER
+class Either
+  attr_accessor :value
+
+  def initialize(value)
+    @value = value
+  end
+
+  def self.[](value)
+    new(value)
+  end
+
+  def success?
+    !failure?
+  end
+
+  def failure?
+    !success?
+  end
+
+  # This is haskell's >>= operator (pronounced "bind")
+  # Basically, it's:
+  # (>>=) :: forall a b. m a -> (a -> m b) -> m b
+  # see https://hackage.haskell.org/package/base-4.2.0.1/docs/Prelude.html#9
+  # for more details
+  def bind(f)
+    success? ? f.call(value) : self
+  end
+
+  # Applies function f to unwrapped value of self.
+  # It's type is:
+  # either :: (a -> c) -> (b -> c) -> Either a b -> c
+  # for further details see
+  # https://hackage.haskell.org/package/base-4.2.0.1/docs/src/Data-Either.html#either
+  #
+  # Hopefully keyword arguments will improve readability
+  def either(failure:, success:)
+    failure? ? failure.call(value) : success.call(value)
+  end
+end
+
+class Failure < Either
+  define_method :failure?, -> { true }
+end
+
+class Success < Either
+  define_method :success?, -> { true }
+end
+
+require 'either/version'

data/lib/either/version.rb

@@ -0,0 +1,4 @@
+module Either
+  VERSION = '0.0.1'
+end
+

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: either-monad
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Denis Redozubov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.2.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.12.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.12.6
+description: |2
+    Simple Either monad implementation. Great way to chain actions that may result in error and keep their context, both successful and erroneous.
+email: denis.redozubov@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/either.rb
+- lib/either/version.rb
+homepage: http://github.com/dredozubov/either-monad
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Dead simple error context framework aka Either monad.
+test_files: []
+has_rdoc: false