functional-light-service 0.2.4

data/spec/lib/deterministic/currify_spec.rb

@@ -0,0 +1,88 @@
+require 'spec_helper'
+require 'pry'
+
+module FunctionalLightService
+  module Currify
+    module ClassMethods
+      def currify(*names)
+        names.each do |name|
+          unbound_method = instance_method(name)
+
+          define_method(name) do |*args|
+            curried_method = unbound_method.bind(self).to_proc.curry
+            curried_method[*args]
+          end
+        end
+      end
+    end
+
+    def self.included(curried)
+      curried.extend ClassMethods
+    end
+  end
+end
+
+class Object
+  class Proc
+    def self.compose(f, g)
+      ->(*args) { f[g[*args]] }
+    end
+
+    # rubocop:disable Naming/BinaryOperatorParameterName
+    # Compose left to right
+    def |(g)
+      Proc.compose(g, self)
+    end
+
+    # Compose right to left
+    def *(g)
+      Proc.compose(self, g)
+    end
+    # rubocop:enable Naming/BinaryOperatorParameterName
+  end
+end
+
+class Booking
+  include FunctionalLightService::Currify
+  include FunctionalLightService::Prelude::Result
+
+  def initialize(deps)
+    @deps = deps
+  end
+
+  def build(id, format)
+    validate(id) | req | find | render(format)
+
+    validate(id) | request(id) | find
+  end
+
+  def validate(id)
+    Success(id)
+  end
+
+  def req(a, id)
+    Success(:id => id + a)
+  end
+
+  def find(req)
+    Success(:found => req)
+  end
+
+  def render(format, req)
+    Success("rendered in #{format}: #{req[:found]}")
+  end
+
+  currify :find, :render, :req
+end
+
+describe "Pref" do
+  include FunctionalLightService::Prelude::Result
+
+  it "does something" do
+    b = Booking.new(1)
+    actual = b.validate(1) >> b.req(2) >> b.find >> b.render(:html)
+
+    expected = FunctionalLightService::Result::Success.new("rendered in html: {:id=>3}")
+    expect(actual).to eq expected
+  end
+end

data/spec/lib/deterministic/monad_axioms.rb

@@ -0,0 +1,44 @@
+shared_examples 'a Monad' do
+  describe 'axioms' do
+    it '1st monadic law: left-identity' do
+      f = ->(value) { monad.new(value + 1) }
+      expect(
+        monad.new(1).bind do |value|
+          f.call(value)
+        end
+      ).to eq f.call(1)
+    end
+
+    it '2nd monadic law: right-identy - new and bind do not change the value' do
+      expect(
+        monad.new(1).bind do |value|
+          monad.new(value)
+        end
+      ).to eq monad.new(1)
+    end
+
+    it '3rd monadic law: associativity' do
+      f = ->(value) { monad.new(value + 1)   }
+      g = ->(value) { monad.new(value + 100) }
+
+      id1 = monad.new(1).bind { |a| f.call(a) }.bind { |b| g.call(b) }
+
+      id2 = monad.new(1).bind do |a|
+        f.call(a).bind do |b|
+          g.call(b)
+        end
+      end
+
+      expect(id1).to eq id2
+    end
+
+    it '#bind must return a monad' do
+      expect(monad.new(1).bind { |v| monad.new(v) }).to eq monad.new(1)
+      expect { monad.new(1).bind {} }.to raise_error(FunctionalLightService::Monad::NotMonadError)
+    end
+
+    it '#new must return a monad' do
+      expect(monad.new(1)).to be_a monad
+    end
+  end
+end

data/spec/lib/deterministic/monad_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+require_relative 'monad_axioms'
+
+describe FunctionalLightService::Monad do
+  class Identity
+    include FunctionalLightService::Monad
+  end
+
+  let(:monad) { Identity }
+  it_behaves_like 'a Monad' do
+    # let(:monad) { monad }
+  end
+
+  specify { expect(Identity.new(1).inspect).to eq 'Identity(1)' }
+  specify { expect(Identity.new(1).to_s).to eq '1' }
+  specify { expect(Identity.new(nil).inspect).to eq 'Identity(nil)' }
+  specify { expect(Identity.new(nil).to_s).to eq '' }
+  specify { expect(Identity.new([1, 2]).fmap(&:to_s)).to eq Identity.new("[1, 2]") }
+  specify { expect(Identity.new(1).fmap { |v| v + 2 }).to eq Identity.new(3) }
+  specify { expect(Identity.new('foo').fmap(&:upcase)).to eq Identity.new('FOO') }
+
+  context '#bind' do
+    it "raises an error if the passed function does not return a monad of the same class" do
+      expect { Identity.new(1).bind {} }.to \
+        raise_error(FunctionalLightService::Monad::NotMonadError)
+    end
+    specify { expect(Identity.new(1).bind { |value| Identity.new(value) }).to eq Identity.new(1) }
+
+    it "passes the monad class, this is ruby-fu?!" do
+      Identity.new(1)
+              .bind do |v|
+        expect(monad).to eq Identity
+        monad.new(v)
+      end
+    end
+
+    specify do
+      expect(
+        monad.new(1).bind { |value| monad.new(value + 1) }
+      ).to eq Identity.new(2)
+    end
+  end
+  specify { expect(Identity.new(Identity.new(1))).to eq Identity.new(1) }
+end
+

data/spec/lib/deterministic/null_spec.rb

@@ -0,0 +1,58 @@
+require "spec_helper"
+
+describe Null do
+  it "Null is a Singleton" do
+    expect(Null.instance).to be_a Null
+    expect { Null.new }.to raise_error(NoMethodError, "private method `new' called for Null:Class")
+  end
+
+  it "explicit conversions" do
+    expect(Null.to_s).to eq 'Null'
+    expect(Null.inspect).to eq 'Null'
+  end
+
+  it "answer if Null is null" do
+    expect(Null.null?).to eq true
+  end
+
+  it "answer if Null is some" do
+    expect(Null.some?).to eq false
+  end
+
+  it "compares to Null" do
+    # rubocop:disable Style/CaseEquality
+    expect(Null === Null.instance).to be_truthy
+    expect(Null.instance === Null).to be_truthy
+    expect(Null.instance).to eq Null
+    expect(Null).to eq Null.instance
+    expect(1).not_to be Null
+    expect(1).not_to be Null.instance
+    expect(Null.instance).not_to be 1
+    expect(Null).not_to be 1
+    expect(Null.instance).not_to be_nil
+    expect(Null).not_to be_nil
+    # rubocop:enable Style/CaseEquality
+  end
+
+  it "implicit conversions" do
+    null = Null.instance
+    expect(null.to_str).to eq ""
+    expect(null.to_ary).to eq []
+    expect("" + null).to eq ""
+
+    a, b, c = null
+    expect(a).to be_nil
+    expect(b).to be_nil
+    expect(c).to be_nil
+  end
+
+  it "mimicks other classes and returns Null for their public methods" do
+    class UnderMimickTest
+      def test; end
+    end
+
+    mimick = Null.mimic(UnderMimickTest)
+    expect(mimick.test).to be_null
+    expect { mimick.i_dont_exist }.to raise_error(NoMethodError)
+  end
+end

data/spec/lib/deterministic/option_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+# rubocop:disable Style/MixinUsage
+include FunctionalLightService::Prelude::Option
+# rubocop:enable Style/MixinUsage
+
+describe FunctionalLightService::Option do
+  specify { expect(described_class::Some.new(0)).to be_a described_class::Some }
+  specify { expect(described_class::Some.new(0)).to be_a described_class }
+  specify { expect(described_class::Some.new(0)).to eq Some(0) }
+
+  specify { expect(described_class::None.new).to eq described_class::None.new }
+  specify { expect(described_class::None.new).to be_a described_class::None }
+  specify { expect(described_class::None.new).to be_a described_class }
+  specify { expect(described_class::None.new).to eq None }
+
+  it "join" do
+    expect(Some(Some(1))).to eq Some(1)
+  end
+
+  it "fmap" do
+    expect(Some(1).fmap { |n| n + 1 }).to eq Some(2)
+    expect(None.fmap { |n| n + 1 }).to eq None
+  end
+
+  it "map" do
+    expect(Some(1).map { |n| Some(n + 1) }).to eq Some(2)
+    expect(Some(1).map { |_n| None }).to eq None
+    expect(None.map { |n| Some(n + 1) }).to eq None
+  end
+
+  it "some?" do
+    expect(Some(1).some?).to be_truthy
+    expect(None.some?).to be_falsey
+  end
+
+  it "none?" do
+    expect(None.none?).to be_truthy
+    expect(Some(1).none?).to be_falsey
+  end
+
+  it "value" do
+    expect(Some(1).value).to eq 1
+    expect { None.value }.to raise_error NoMethodError
+  end
+
+  it "value_or" do
+    expect(Some(1).value_or(2)).to eq 1
+    expect(None.value_or(0)).to eq 0
+  end
+
+  it "+" do
+    expect(Some([1]) + None).to eq Some([1])
+    expect(Some(1) + None + None).to eq Some(1)
+    expect(Some(1) + Some(1)).to eq Some(2)
+    expect(None + Some(1)).to eq Some(1)
+    expect(None + None + Some(1)).to eq Some(1)
+    expect(None + None + Some(1) + None).to eq Some(1)
+    expect(None + Some(:foo => 1)).to eq Some(:foo => 1)
+    expect(Some([1]) + Some([1])).to eq Some([1, 1])
+    expect { Some([1]) + Some(1) }.to raise_error TypeError
+  end
+
+  it "inspect" do
+    expect(Some(1).inspect).to eq "Some(1)"
+    expect(described_class::None.new.inspect).to eq "None"
+  end
+
+  it "to_s" do
+    expect(Some(1).to_s).to eq "1"
+    expect(described_class::None.new.to_s).to eq ""
+  end
+
+  it "match" do
+    # expect(
+    #   Some(0).match do
+    #     Some(where { s == 1 }) { |_s| 99 }
+    #     Some(where { s == 0 }) { |s| s + 1 }
+    #     None() {}
+    #   end
+    # ).to eq 1
+
+    expect(
+      Some(1).match do
+        None() { 0 }
+        Some() { |_s| 1 }
+      end
+    ).to eq 1
+
+    # expect(
+    #   Some(1).match do
+    #     None() { 0 }
+    #     Some(where { s.is_a? Integer }) { |_s| 1 }
+    #   end
+    # ).to eq 1
+
+    expect(
+      None.match do
+        None() { 0 }
+        Some() { 1 }
+      end
+    ).to eq 0
+  end
+
+  it "nil?" do
+    expect(described_class.some?(nil)).to eq None
+    expect(described_class.some?(1)).to be_some
+    expect(described_class.some?(1)).to eq Some(1)
+  end
+
+  it "any?" do
+    expect(described_class.any?(nil)).to be_none
+    expect(described_class.any?(None)).to be_none
+    expect(described_class.any?("")).to  be_none
+    expect(described_class.any?([])).to  be_none
+    expect(described_class.any?({})).to  be_none
+    expect(described_class.any?([1])).to eq Some([1])
+    expect(described_class.any?(:foo => 1)).to eq Some(:foo => 1)
+    expect(described_class.any?(1)).to eq Some(1)
+  end
+
+  it "try!" do
+    expect(described_class.try! { raise "error" }).to be_none
+  end
+end
+
+require_relative 'monad_axioms'
+
+describe FunctionalLightService::Option::Some do
+  it_behaves_like 'a Monad' do
+    let(:monad) { described_class }
+  end
+end

data/spec/lib/deterministic/result/failure_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+require_relative '../monad_axioms'
+require_relative 'result_shared'
+
+describe FunctionalLightService::Result::Failure do
+  include FunctionalLightService::Prelude::Result
+
+  it_behaves_like 'a Monad' do
+    let(:monad) { described_class }
+  end
+
+  subject { described_class.new(1) }
+
+  specify { expect(subject).to be_an_instance_of described_class }
+  specify { expect(subject).to be_failure }
+  specify { expect(subject).not_to be_success }
+  specify { expect(subject.success?).to be_falsey }
+  specify { expect(subject.failure?).to be_truthy }
+
+  specify { expect(subject).to be_an_instance_of described_class }
+  specify { expect(subject).to eq(described_class.new(1)) }
+  specify { expect(subject.fmap { |v| v + 1 }).to eq Failure(2) }
+  specify { expect(subject.map { |v| Success(v + 1) }).to eq Failure(1) }
+  specify { expect(subject.map_err { |v| Success(v + 1) }).to eq Success(2) }
+  specify do
+    expect(subject.pipe { |v| raise RuntimeError unless v == Failure(1) }).to eq Failure(1)
+  end
+
+  specify { expect(subject.or(Success(2))).to eq Success(2) }
+  specify { expect(subject.or(Failure(2))).to eq Failure(2) }
+  specify { expect(subject.or_else { Success(2) }).to eq Success(2) }
+  specify { expect(subject.or_else { Failure(2) }).to eq Failure(2) }
+
+  specify { expect(subject.and(Success(2))).to eq Failure(1) }
+  specify { expect(subject.and_then { Success(2) }).to eq Failure(1) }
+
+  it_behaves_like 'Result' do
+    let(:result) { described_class }
+  end
+
+  it "#or" do
+    expect(Success(1).or(Failure(2))).to eq Success(1)
+    expect(Failure(1).or(Success(2))).to eq Success(2)
+    expect { Failure(1).or(2) }.to raise_error(FunctionalLightService::Monad::NotMonadError)
+  end
+
+  it "#or_else" do
+    expect(Success(1).or_else { Failure(2) }).to eq Success(1)
+    expect(Failure(1).or_else { |v| Success(v + 1) }).to eq Success(2)
+    expect { Failure(1).or_else { 2 } }.to raise_error(FunctionalLightService::Monad::NotMonadError)
+  end
+
+  it "#and" do
+    expect(Success(1).and(Success(2))).to eq Success(2)
+    expect(Failure(1).and(Success(2))).to eq Failure(1)
+    expect { Success(1).and(2) }.to raise_error(FunctionalLightService::Monad::NotMonadError)
+  end
+
+  it "#and_then" do
+    expect(Success(1).and_then { Success(2) }).to eq Success(2)
+    expect(Failure(1).and_then { Success(2) }).to eq Failure(1)
+    expect { Success(1).and_then { 2 } }.to \
+      raise_error(FunctionalLightService::Monad::NotMonadError)
+  end
+end

data/spec/lib/deterministic/result/result_map_spec.rb

@@ -0,0 +1,154 @@
+require 'spec_helper'
+
+describe FunctionalLightService::Result do
+  include FunctionalLightService::Prelude::Result
+
+  context ">> (map)" do
+    specify { expect(Success(0).map { |n| Success(n + 1) }).to eq Success(1) }
+    specify { expect(Failure(0).map { |n| Success(n + 1) }).to eq Failure(0) }
+
+    it "Failure stops execution" do
+      class ChainUnderTest
+        include FunctionalLightService::Prelude::Result
+        alias :m :method
+
+        def call
+          init >>
+            m(:validate) >>
+            m(:send) >>
+            m(:parse)
+        end
+
+        def init
+          Success(:step => 1)
+        end
+
+        def validate(i)
+          i[:step] = i[:step] + 1
+          Success(i)
+        end
+
+        def send(i)
+          i[:step] = i[:step] + 1
+          Failure("Error @ #{i.fetch(:step)}")
+        end
+
+        def parse(i)
+          i[:step] = i[:step] + 1
+          Success(i)
+        end
+      end
+
+      test = ChainUnderTest.new
+
+      expect(test.call).to eq Failure("Error @ 3")
+    end
+
+    it "expects an Result" do
+      def returns_non_result(_i)
+        2
+      end
+
+      expect { Success(1) >> method(:returns_non_result) }.to \
+        raise_error(FunctionalLightService::Monad::NotMonadError)
+    end
+
+    it "works with a block" do
+      expect(
+        Success(1).map { |i| Success(i + 1) }
+      ).to eq Success(2)
+    end
+
+    it "works with a lambda" do
+      expect(
+        Success(1) >> ->(i) { Success(i + 1) }
+      ).to eq Success(2)
+    end
+
+    it "does not catch exceptions" do
+      expect do
+        Success(1) >> ->(_i) { raise "error" }
+      end.to raise_error(RuntimeError)
+    end
+  end
+
+  context "using self as the context for success" do
+    class SelfContextUnderTest
+      include FunctionalLightService::Prelude::Result
+
+      def call
+        @step = 0
+        Success(self)
+          .map(&:validate)
+          .map(&:build)
+          .map(&:send)
+      end
+
+      def validate
+        @step = 1
+        Success(self)
+      end
+
+      def build
+        @step = 2
+        Success(self)
+      end
+
+      def send
+        @step = 3
+        Success(self)
+      end
+
+      def inspect
+        "Step #{@step}"
+      end
+
+      # # def self.procify(*meths)
+      # #   meths.each do |m|
+      # #     new_m = "__#{m}__procified".to_sym
+      # #     alias new_m m
+      # #     define_method new_m do |ctx|
+      # #       method(m)
+      # #     end
+      # #   end
+      # # end
+
+      # procify :send
+    end
+
+    it "works" do
+      test = SelfContextUnderTest.new.call
+      expect(test).to be_a described_class::Success
+      expect(test.inspect).to eq "Success(Step 3)"
+    end
+  end
+
+  context "<< (pipe)" do
+    it "ignores the output of pipe" do
+      acc = "ctx: "
+      log = ->(ctx) { acc += ctx.inspect }
+
+      actual = Success(1).pipe(log).map { Success(2) }
+      expect(actual).to eq Success(2)
+      expect(acc).to eq "ctx: Success(1)"
+    end
+
+    it "works with <<" do
+      log = ->(n) { n.value + 1 }
+      foo = ->(n) { Success(n + 1) }
+
+      Success(1) << log >> foo
+    end
+  end
+
+  context ">= (try)" do
+    it "try (>=) catches errors and wraps them as Failure" do
+      def error(ctx)
+        raise "error #{ctx}"
+      end
+
+      actual = Success(1) >= method(:error)
+      expect(actual.inspect).to eq "Failure(#<RuntimeError: error 1>)"
+    end
+  end
+end

data/spec/lib/deterministic/result/result_shared.rb

@@ -0,0 +1,24 @@
+shared_examples 'Result' do
+  let(:result_name) { described_class.name.split("::")[-1] }
+  specify { expect(subject.value).to eq 1 }
+  specify { expect(result.new(subject)).to eq result.new(1) }
+
+  it "#fmap" do
+    expect(result.new(1).fmap { |e| e + 1 }).to eq result.new(2)
+  end
+
+  it "#bind" do
+    expect(result.new(1).bind { |v| result.new(v + 1) }).to eq result.new(2)
+  end
+
+  it "#to_s" do
+    expect(result.new(1).to_s).to eq "1"
+    expect(result.new(:a => 1).to_s).to eq "{:a=>1}"
+  end
+
+  it "#inspect" do
+    expect(result.new(1).inspect).to eq "#{result_name}(1)"
+    expect(result.new(:a => 1).inspect).to eq "#{result_name}({:a=>1})"
+  end
+end
+

data/spec/lib/deterministic/result/success_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+require_relative '../monad_axioms'
+require_relative 'result_shared'
+
+describe FunctionalLightService::Result::Success do
+  include FunctionalLightService::Prelude::Result
+
+  it_behaves_like 'a Monad' do
+    let(:monad) { described_class }
+  end
+
+  subject { described_class.new(1) }
+
+  specify { expect(subject).to be_an_instance_of described_class }
+  specify { expect(subject).to be_success }
+  specify { expect(subject).not_to be_failure }
+  specify { expect(subject.success?).to be_truthy }
+  specify { expect(subject.failure?).to be_falsey }
+
+  specify { expect(subject).to be_an_instance_of described_class }
+  specify { expect(subject).to eq(described_class.new(1)) }
+  specify { expect(subject.fmap { |v| v + 1 }).to eq Success(2) }
+  specify { expect(subject.map { |v| Failure(v + 1) }).to eq Failure(2) }
+  specify { expect(subject.map_err { |v| Failure(v + 1) }).to eq Success(1) }
+
+  specify do
+    expect(subject.pipe { |r| raise RuntimeError unless r == Success(1) }).to eq Success(1)
+  end
+
+  specify { expect(subject.or(Success(2))).to eq Success(1) }
+  specify { expect(subject.or_else { Success(2) }).to eq Success(1) }
+
+  specify { expect(subject.and(Success(2))).to eq Success(2) }
+  specify { expect(subject.and(Failure(2))).to eq Failure(2) }
+  specify { expect(subject.and_then { Success(2) }).to eq Success(2) }
+  specify { expect(subject.and_then { Failure(2) }).to eq Failure(2) }
+
+  it_behaves_like 'Result' do
+    let(:result) { described_class }
+  end
+end