railway-rb 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8698c98d0e081c760f0c652d7875bf1ad9050f36989de032187156e68c6c6a90
+  data.tar.gz: 79a12dd5fd91fb69afb56e10f737939659ea2a5937f3abc83debc8c9d5cc380c
+SHA512:
+  metadata.gz: 859724aff46f8909025681cb3a48eb01b5f7543c5ec00ec736ac6aa07ed4709fe732e205e869a0e837bb828dbebf4c3e4aece4d0433b348f934cbe9328a41dd1
+  data.tar.gz: 6b2dd0ca7b4e48e692dd324958905818b53e22879dbbbea39ed6ebff8c0f9178af38af8dc06dffae239c9180541e284f887de28d5778933f2a3c6ad61073bbe2

data/lib/railway.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+# Include this module to enable Railway syntactic expression.
+# Example:
+#
+# class Lorem
+#   include Railway
+#
+#   def greeting(person)
+#     with { person }.as var(:pax).when { pax.is_a? String }
+#       .then { "Hello, #{pax}" }.as var(:message) do
+#       pp message
+#     end.run
+#   end
+# end
+#
+module Railway
+  def var(sym, setter: nil)
+    block = BuildingBlock.new(name: sym, setter_name: setter)
+    Builder.new(block)
+  end
+
+  def with(&assign_block)
+    block = BuildingBlock.new(assign_block: assign_block)
+    Builder.new(block, self)
+  end
+
+  BuildingBlock = Struct.new(
+    :name, :setter_name, :assign_block, :guard_block, :extra_blocks,
+    keyword_init: true
+  )
+
+  # This class is used to combine and execute building block properly
+  #
+  class Builder
+    attr_reader :blocks
+
+    def initialize(starting_block, ctx = nil)
+      @blocks = [starting_block]
+      @context = ctx
+    end
+
+    def when(&block)
+      blocks.first.guard_block = block
+      self
+    end
+
+    def then(&block)
+      blocks.last.extra_blocks = [*blocks.last.extra_blocks, next_assign_block] if next_assign_block
+
+      @next_assign_block = block
+      self
+    end
+
+    def as(next_builder, &block) # rubocop:disable Metrics/MethodLength
+      if block
+        @accept_block = block
+        assign_block = blocks.first.assign_block
+        @blocks = next_builder.blocks.clone
+        blocks.first.assign_block = assign_block
+      else
+        next_blocks = next_builder.blocks.clone
+        next_blocks.first.assign_block = next_assign_block
+        @blocks += next_blocks
+        @next_assign_block = nil
+      end
+      self
+    end
+
+    def otherwise(&block)
+      @reject_block = block if block
+      self
+    end
+
+    def run
+      @result = Struct.new(*blocks.map(&:name)).new
+
+      blocks.each do |block|
+        apply_block(block)
+        return reject(block) unless continue_block?(block)
+
+        [*block.extra_blocks].each { |b| instance_exec(&b) }
+      end
+
+      instance_exec(&accept_block)
+    end
+
+    private
+
+    attr_reader :context, :next_assign_block, :result, :accept_block, :reject_block
+
+    def apply_block(block)
+      sym = block.name
+      result[sym] = instance_exec(&block.assign_block)
+      return if !context || !block.setter_name
+
+      context.instance_variable_set("@#{block.setter_name}".to_sym, result[sym])
+    end
+
+    def continue_block?(block)
+      !block.guard_block || instance_exec(&block.guard_block)
+    end
+
+    def reject(block)
+      sym = block.name
+      reject_block && instance_exec(sym, result[sym], &reject_block)
+    end
+
+    def method_missing(a_method, *args, &block)
+      return result[a_method] if result&.members&.include?(a_method)
+
+      return context.send(a_method, *args, &block) if context.respond_to?(a_method, true)
+
+      super(a_method, *args, &block)
+    end
+
+    def respond_to_missing?(a_method, *)
+      result&.members&.include?(a_method) || context.respond_to?(a_method)
+    end
+  end
+end

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: railway-rb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Hoan Nguyen
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-12-25 00:00:00.000000000 Z
+dependencies: []
+description: A functional approach to error handling. Inspired by Elixir `with` statement.
+email: hoan006@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/railway.rb
+homepage: http://github.com/hoan006
+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.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key:
+specification_version: 4
+summary: Railway-Oriented Programming!
+test_files: []