symbiont-ruby 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2df520b8812cc17063343dec89c82fd4ef94feb5
-  data.tar.gz: 3ef7f4309989802c211aa91f234547c69ecc654a
+SHA256:
+  metadata.gz: e48d7a484f586f984a1ddd7bda0bd93680fd4419109eee75de349d0015709b62
+  data.tar.gz: 61fa02170bf32d34d2044f4a9275f0b5e9f0738dc77dddb2651f80016e9dc24d
 SHA512:
-  metadata.gz: 9c752120deaf778e7cf356b79beec8f2b471de4c3356993bd476239c25c23e7e1dbb540c5c2e39c37627aa6958c0306f209a97176ec038bc07767e9f5d01a708
-  data.tar.gz: 03f7fb48f8b91acd2e37260c4b6cfde7e18b4c2125ab4c2f2db56577c281f33bb4fc77a325ede3edb4a1a3e312afa37f85c4a69fb204b1d89cd96e763853e7b3
+  metadata.gz: 46dc861c18751412b0da582ed8bb105d9d91926d81bdd2ed357317b800a3171fc8279c65bfb4387d998ec51568fe595efcfce5c7ccc07072950647d95089146b
+  data.tar.gz: 8d09fa861bb32b16ce06e66d62b967d0b970d7f69410c1fba8eb83df6f496bb2bdfd75c886188b614b1a7537ecf263c632a1233ce5901f18daebf8aaf5bb66cd

data/.travis.yml

@@ -1,9 +1,9 @@
 language: ruby
 rvm:
-- 2.2.9
-- 2.3.6
-- 2.4.3
-- 2.5.0
+- 2.2.10
+- 2.3.7
+- 2.4.4
+- 2.5.1
 - ruby-head
 
 sudo: false

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.3.0] 2018-06-15
+### Added
+- `Symbiont::Isolator` - proc object isolation layer for delayed invocations;
+
 ## [0.2.0] 2018-04-22
 ### Added
 - Logo ^_^ (special thanks to **Viktoria Karaulova**)

data/README.md

@@ -55,6 +55,7 @@ require 'symbiont'
     - [Mixing a module with default delegation direction](#mixing-a-module-with-default-delegation-direction)
     - [Mixing a module with certain delegation direction](#mixing-a-module-with-certain-delegation-direction)
   - [Multiple inner contexts](#multiple-inner-contexts)
+  - [Isolator - proc object isolation layer for delayed invocations](#isolator---proc-object-isolation-layer-for-delayed-invocations)
 
 # Problems and motivaiton
 
@@ -390,6 +391,34 @@ Symbiont::Executor.public_method(:data, object_a, object_b, &closure).call # =>
 Symbiont::Executor.public_method(:info, object_a, object_b, &closure).call # => "object_info"
 ```
 
+## Isolator - proc object isolation layer for delayed invocations
+
+`Symbiont::Isolator` is a special object that wraps your proc object from any place and provides
+an ability to invoke this proc object lazily inside an any series of contexts.
+All `Symbiont::Executor` features are supported (by the way, `Symbiont::Executor`
+uses `Symbiont::Isolator` under the hood).
+
+```ruby
+# Usage:
+
+# with default direction (Symbiont::IOK)
+isolator = Symbiont::Isolator.new { call_any_method }
+
+# with custom direction
+isolator = Symbiont::Isolator.new(default_direction: Symbiont::KIO) { call_any_method }
+
+# invocation
+isolator.evaluate(object_a, object_b) # use default direction defined on instantiation
+isolator.evaluate(object_a, object_b, direction: Symbiont::KOI) # use custom direction
+# same for #.evaluate_private
+
+# getting a method object
+isolator.public_method(:call_any_method, object_a, object_b) # use default direction defined on instantiation
+isolator.public_method(:call_any_method, object_a, object_b, direction: Symbiont::KIO) # use custom direction
+isolator.private_method(...)
+# same for #.private_method
+```
+
 # Contributing
 
 - Fork it ( https://github.com/0exp/symbiont-ruby/fork )

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
 require 'bundler/setup'
-require 'symbiont/ruby'
+require 'symbiont'
 
 require 'pry'
 Pry.start

data/lib/symbiont.rb

@@ -9,6 +9,7 @@ module Symbiont
   require_relative 'symbiont/trigger'
   require_relative 'symbiont/public_trigger'
   require_relative 'symbiont/private_trigger'
+  require_relative 'symbiont/isolator'
   require_relative 'symbiont/executor'
   require_relative 'symbiont/context'
 

data/lib/symbiont/executor.rb

@@ -32,7 +32,8 @@ module Symbiont
       # @api public
       # @since 0.1.0
       def evaluate(*required_contexts, context_direction: Trigger::IOK, &closure)
-        public_trigger(*required_contexts, context_direction: context_direction, &closure).__evaluate__
+        Isolator.new(default_direction: context_direction, &closure)
+                .evaluate(*required_contexts)
       end
 
       # Starts execution of a proc object in the context of the passed object with the selected
@@ -59,63 +60,8 @@ module Symbiont
       # @api public
       # @since 0.1.0
       def evaluate_private(*required_contexts, context_direction: Trigger::IOK, &closure)
-        private_trigger(*required_contexts, context_direction: context_direction, &closure).__evaluate__
-      end
-
-      # Factory method that instantiates a public trigger with the desired execution context,
-      # the direction of method dispatching and the closure that needs to be performed.
-      #
-      # @param required_contexts [Array<Object>]
-      #   A set of objects that should be used as the main context series for method resolving
-      #   algorithm.
-      # @param context_direction [Array<Symbol>]
-      #   An array of symbols that represents the direction of contexts. Possible values:
-      #
-      #     - Symbiont::IOK
-      #     - Symbiont::OIK
-      #     - Symbiont::OKI
-      #     - Symbiont::IKO
-      #     - Symbiont::KOI
-      #     - Symbiont::KIO
-      # @param closure [Proc]
-      #   Proc object that will be evaluated in many contexts: initial, outer and kernel.
-      # @return [Symbiont::PublicTrigger]
-      #
-      # @see Symbiont::PublicTrigger
-      # @see Symbiont::Trigger
-      #
-      # @api public
-      # @since 0.1.0
-      def public_trigger(*required_contexts, context_direction: Trigger::IOK, &closure)
-        PublicTrigger.new(*required_contexts, context_direction: context_direction, &closure)
-      end
-
-      # Factory method that instantiates a private trigger with the desired execution context,
-      # the direction of method dispatching and the closure that needs to be performed.
-      #
-      # @param required_contexts [Array<Object>]
-      #   A set of objects that should be used as the main context series for method resolving
-      #   algorithm.
-      # @param context_direction [Array<Symbol>]
-      #   An array of symbols that represents the direction of contexts. Possible values:
-      #
-      #     - Symbiont::IOK
-      #     - Symbiont::OIK
-      #     - Symbiont::OKI
-      #     - Symbiont::IKO
-      #     - Symbiont::KOI
-      #     - Symbiont::KIO
-      # @param closure [Proc]
-      #   Proc object that will be evaluated in many contexts: initial, outer and kernel.
-      # @return [Symbiont::PrivateTrigger]
-      #
-      # @see Symbiont::PrivateTrigger
-      # @see Symbiont::Trigger
-      #
-      # @api public
-      # @since 0.1.0
-      def private_trigger(*required_contexts, context_direction: Trigger::IOK, &closure)
-        PrivateTrigger.new(*required_contexts, context_direction: context_direction, &closure)
+        Isolator.new(default_direction: context_direction, &closure)
+                .evaluate_private(*required_contexts)
       end
 
       # Gets the method object taken from the context that can respond to it.
@@ -142,7 +88,8 @@ module Symbiont
       # @api public
       # @since 0.1.0
       def public_method(method_name, *required_contexts, context_direction: Trigger::IOK, &closure)
-        public_trigger(*required_contexts, context_direction: context_direction, &closure).method(method_name)
+        Isolator.new(default_direction: context_direction, &closure)
+                .public_method(method_name, *required_contexts)
       end
 
       # Gets the method object taken from the context that can respond to it.
@@ -169,7 +116,8 @@ module Symbiont
       # @api public
       # @since 0.1.0
       def private_method(method_name, *required_contexts, context_direction: Trigger::IOK, &closure)
-        private_trigger(*required_contexts, context_direction: context_direction, &closure).method(method_name)
+        Isolator.new(default_direction: context_direction, &closure)
+                .private_method(method_name, *required_contexts)
       end
     end
   end

data/lib/symbiont/isolator.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+module Symbiont
+  # Special object that wraps your proc object from any place and provides
+  # an ability to invoke this proc object lazily inside an any series of contexts.
+  #
+  # @api public
+  # @since 0.3.0
+  class Isolator
+    # Is raised when closure is not provided.
+    #
+    # @see #initialize
+    #
+    # @api public
+    # @since 0.3.0
+    UnprovidedClosureAttributeError = Class.new(ArgumentError)
+
+    # Proc object that will be evaluated in many contexts: initial, outer and kernel.
+    # Will be used as an outer-context for the method resolution.
+    #
+    # @return [Proc]
+    #
+    # @api public
+    # @since 0.3.0
+    attr_reader :closure
+
+    # An array of symbols that represents the direction of contexts. Used by default.
+    #
+    # @return [Array<Symbol>]
+    #
+    # @api public
+    # @since 0.3.0
+    attr_reader :default_direction
+
+    # Instantiates isolator object with corresponding default direction and closure.
+    #
+    # @option default_direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts which is used as default
+    #   context direction. Symbiont::Trigger::IOK is chosen by default.
+    # @param closure [Proc]
+    #   Proc object that will be evaluated in many contexts: initial, outer and kernel.
+    #   Will be used as an outer-context for the method resolution.
+    #
+    # @api public
+    # @since 0.3.0
+    def initialize(default_direction: Trigger::IOK, &closure)
+      raise UnprovidedClosureAttributeError, 'You should provide a closure' unless block_given?
+
+      @default_direction = default_direction
+      @closure = closure
+    end
+
+    # Starts execution of a proc object in the context of the passed object with the selected
+    # direction of method dispatching. Delegates execution to a public trigger.
+    #
+    # @param required_contexts [Array<Object>]
+    #   A set of objects that should be used as the main context series for method resolving
+    #   algorithm.
+    # @param direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts.
+    # @return [void]
+    #
+    # @see Symbiont::Trigger#__evaluate__
+    # @see Symbiont::PublicTrigger
+    #
+    # @api public
+    # @since 0.3.0
+    def evaluate(*required_contexts, direction: default_direction)
+      public_trigger(*required_contexts, direction: direction).__evaluate__
+    end
+
+    # Starts execution of a proc object in the context of the passed object with the selected
+    # direction of method dispatching. Delegates execution to a private trigger.
+    #
+    # @param required_contexts [Array<Object>]
+    #   A set of objects that should be used as the main context series for method resolving
+    #   algorithm.
+    # @param direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts.
+    # @return [void]
+    #
+    # @see Symbiont::Trigger#__evaluate__
+    # @see Symbiont::PrivateTrigger
+    #
+    # @api public
+    # @since 0.3.0
+    def evaluate_private(*required_contexts, direction: default_direction)
+      private_trigger(*required_contexts, direction: direction).__evaluate__
+    end
+
+    # Gets the method object taken from the context that can respond to it.
+    # Considers only public methods.
+    #
+    # @param method_name [Symbol,String] A name of required method.
+    # @param required_contexts [Array<Object>]
+    #   A set of objects that should be used as the main context series for method resolving
+    #   algorithm.
+    # @param direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts.
+    # @return [Method]
+    #
+    # @see Symbiont::PublicTrigger
+    # @see Symbiont::Trigger#method
+    #
+    # @api public
+    # @since 0.3.0
+    def public_method(method_name, *required_contexts, direction: default_direction)
+      public_trigger(*required_contexts, direction: direction).method(method_name)
+    end
+
+    # Gets the method object taken from the context that can respond to it.
+    # Considers private methods and public methods.
+    #
+    # @param method_name [Symbol,String] A name of required method.
+    # @param required_contexts [Array<Object>]
+    #   A set of objects that should be used as the main context series for method resolving
+    #   algorithm.
+    # @param direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts.
+    # @return [Method]
+    #
+    # @see Symbiont::PrivateTrigger
+    # @see Symbiont::Trigger#method
+    #
+    # @api public
+    # @since 0.3.0
+    def private_method(method_name, *required_contexts, direction: default_direction)
+      private_trigger(*required_contexts, direction: direction).method(method_name)
+    end
+
+    private
+
+    # Factory method that instantiates a public trigger with the desired execution context,
+    # the direction of method dispatching and the closure that needs to be performed.
+    #
+    # @param required_contexts [Array<Object>]
+    #   A set of objects that should be used as the main context series for method resolving
+    #   algorithm.
+    # @param direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts. Possible values:
+    #
+    #     - Symbiont::IOK
+    #     - Symbiont::OIK
+    #     - Symbiont::OKI
+    #     - Symbiont::IKO
+    #     - Symbiont::KOI
+    #     - Symbiont::KIO
+    # @return [Symbiont::PublicTrigger]
+    #
+    # @see Symbiont::PublicTrigger
+    # @see Symbiont::Trigger
+    #
+    # @api private
+    # @since 0.3.0
+    def public_trigger(*required_contexts, direction: default_direction)
+      PublicTrigger.new(*required_contexts, context_direction: direction, &closure)
+    end
+
+    # Factory method that instantiates a private trigger with the desired execution context,
+    # the direction of method dispatching and the closure that needs to be performed.
+    #
+    # @param required_contexts [Array<Object>]
+    #   A set of objects that should be used as the main context series for method resolving
+    #   algorithm.
+    # @param direction [Array<Symbol>]
+    #   An array of symbols that represents the direction of contexts. Possible values:
+    #
+    #     - Symbiont::IOK
+    #     - Symbiont::OIK
+    #     - Symbiont::OKI
+    #     - Symbiont::IKO
+    #     - Symbiont::KOI
+    #     - Symbiont::KIO
+    # @return [Symbiont::PrivateTrigger]
+    #
+    # @see Symbiont::PrivateTrigger
+    # @see Symbiont::Trigger
+    #
+    # @api private
+    # @since 0.3.0
+    def private_trigger(*required_contexts, direction: default_direction)
+      PrivateTrigger.new(*required_contexts, context_direction: direction, &closure)
+    end
+  end
+end

data/lib/symbiont/trigger.rb

@@ -153,9 +153,11 @@ class Symbiont::Trigger < BasicObject
   # @api private
   # @since 0.1.0
   def initialize(*initial_contexts, context_direction: IOK, &closure)
+    # :nocov:
     unless ::Kernel.block_given?
       ::Kernel.raise(UnprovidedClosureAttributeError, 'block attribute should be provided')
     end
+    # :nocov:
 
     # rubocop:disable Layout/SpaceAroundKeyword
     unless(context_direction == IOK || context_direction == OIK || context_direction == OKI ||
@@ -230,7 +232,7 @@ class Symbiont::Trigger < BasicObject
   #
   # @api private
   # @since 0.1.0
-  def method_missing(method_name, *arguments, &block) # rubocop:disable Style/MethodMissing
+  def method_missing(method_name, *arguments, &block) # rubocop:disable Style/MethodMissingSuper
     __actual_context__(method_name).send(method_name, *arguments, &block)
   end
 

data/lib/symbiont/version.rb

@@ -5,5 +5,5 @@ module Symbiont
   #
   # @api public
   # @since 0.1.0
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/symbiont-ruby.gemspec

@@ -29,8 +29,8 @@ Gem::Specification.new do |spec|
   end
 
   spec.add_development_dependency 'rspec',          '~> 3.7'
-  spec.add_development_dependency 'rubocop',        '~> 0.53'
-  spec.add_development_dependency 'rubocop-rspec',  '~> 1.24'
+  spec.add_development_dependency 'rubocop',        '~> 0.57'
+  spec.add_development_dependency 'rubocop-rspec',  '~> 1.26'
   spec.add_development_dependency 'simplecov',      '~> 0.15'
   spec.add_development_dependency 'simplecov-json', '~> 0.2'
   spec.add_development_dependency 'coveralls',      '~> 0.7'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: symbiont-ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-03-21 00:00:00.000000000 Z
+date: 2018-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -30,28 +30,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.53'
+        version: '0.57'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.53'
+        version: '0.57'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.24'
+        version: '1.26'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.24'
+        version: '1.26'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -161,7 +161,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
-- ".hound.yml"
 - ".rspec"
 - ".rubocop.yml"
 - ".travis.yml"
@@ -176,6 +175,7 @@ files:
 - lib/symbiont.rb
 - lib/symbiont/context.rb
 - lib/symbiont/executor.rb
+- lib/symbiont/isolator.rb
 - lib/symbiont/private_trigger.rb
 - lib/symbiont/public_trigger.rb
 - lib/symbiont/trigger.rb
@@ -235,7 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Evaluate proc-objects in many contexts simultaneously

data/.hound.yml

@@ -1,2 +0,0 @@
-ruby:
-  config_file: .rubocop.yml