jace 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 358835f18e54f117ab1043133ddf2374a5da2cc96ff7ce9c67032adad17abdeb
-  data.tar.gz: ba47115126440c6f78833e3c32444c08bd603eef3dacb74523475a96f1a10f6c
+  metadata.gz: e48246a546ecbb574464b1e411d4d72c30369eda539c121309d02c9f6d47978e
+  data.tar.gz: 42b96e64f9a04f1e4b0d6eb3430044890ea18b48648bde0c9189be07867c2630
 SHA512:
-  metadata.gz: 3f1dedd86ee3e4a1171b6f09b95874bf70e5e2761d989b4d6f72fd916164977994f271ea311ea82858a0e7544c19874683de5c8311b606d50cc58e69fbb8a08a
-  data.tar.gz: 98b468f58c0a46d3c7c1b73df95eb64c856c00f0ed314c5935828ac9024223d328bf0f572620c6921ffc88ee4d8f8f9a3513791e3d2f52804385a9716da1daf0
+  metadata.gz: 70c38cdaaa607c953d94ce21ad5acead8692e33a383d01d2cb5301fa7ace4dfb7e48c9cd4ec5179c1f1a008277379107374d48931dd604ba9589398ac4973312
+  data.tar.gz: 70785d17966a037cabf6f8f092b23df4215b129265de4fd57f141511bd926596ff1fd9e31340db464d6d0a7e95ba283ff7ef12c3fd4b6fbd0fa5e7006f30fb6f

data/.circleci/config.yml

@@ -2,7 +2,7 @@ version: 2
 jobs:
   build:
     docker:
-      - image: darthjee/circleci_ruby_gems:0.5.0
+      - image: darthjee/circleci_ruby_gems:0.5.2
         environment:
           PROJECT: jace
     steps:

data/.rubocop.yml

@@ -36,6 +36,14 @@ RSpec/NestedGroups:
   Exclude:
     - 'spec/integration/yard/**/*.rb'
 
+RSpec/InstanceVariable:
+  Exclude:
+    - 'spec/lib/jace/executer_spec.rb'
+
+Naming/MemoizedInstanceVariableName:
+  Exclude:
+    - 'spec/support/models/person.rb'
+
 Style/HashEachMethods:
   Enabled: true
 

data/README.md

@@ -11,7 +11,7 @@ Sinclair
 
 Yard Documentation
 -------------------
-[https://www.rubydoc.info/gems/jace/0.0.1](https://www.rubydoc.info/gems/jace/0.0.1)
+[https://www.rubydoc.info/gems/jace/0.0.2](https://www.rubydoc.info/gems/jace/0.0.2)
 
 Installation
 ---------------

data/config/check_specs.yml

@@ -1 +1,2 @@
-ignore: []
+ignore:
+  - lib/jace/version.rb

data/config/yardstick.yml

@@ -1,4 +1,4 @@
-threshold: 100
+threshold: 90
 require_exact_threshold: false
 rules:
   ApiTag::Presence:

data/jace.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |gem|
   gem.authors               = ['DarthJee']
   gem.email                 = ['darthjee@gmail.com']
   gem.homepage              = 'https://github.com/darthjee/jace'
-  gem.description           = ''
+  gem.description           = 'Gem focused on events for meta-programing'
   gem.summary               = gem.description
   gem.required_ruby_version = '>= 2.5.0'
 

data/lib/jace/executer.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Jace
+  # @api private
+  # @author Dartjee
+  #
+  # Class responsible for executing a given block and triggering event
+  #
+  # The event trigger has phase before and after so all methods
+  # are called before block execution and after, before returning the result
+  class Executer
+    # Calls the execution
+    #
+    # @param before [Symbol,Proc,Array] all the methods / proc
+    #   to be executed before block call
+    # @param after [Symbol,Proc,Array] all the methods / proc
+    #   to be executed after block call
+    # @param context [Object] Object where the procs / methods
+    #   will be called on
+    # @block [Proc] bloc to be performed between befores and afters
+    #
+    # @return [Object] result of block call
+    def self.call(before: [], after: [], context:, &block)
+      new(before, after, context, &block).call
+    end
+
+    # calls the execution
+    #
+    # @see .call
+    #
+    # @return (see .call)
+    def call
+      execute_actions(before)
+      result = block.call
+      execute_actions(after)
+
+      result
+    end
+
+    private
+
+    # @private
+    #
+    # @param (see .call)
+    def initialize(before, after, context, &block)
+      @before = [before].flatten.compact
+      @after = [after].flatten.compact
+      @context = context
+      @block = block
+    end
+
+    attr_reader :before, :after, :context, :block
+
+    # @private
+    #
+    # Perform actions from list
+    #
+    # @list [Array<Symbol,Proc>] methods and procs to
+    #   be executed
+    #
+    # Execute each proc and call method in the list
+    # within the given context
+    #
+    # @return [Array<Proc>]
+    def execute_actions(list)
+      actions(list).each do |action|
+        context.instance_eval(&action)
+      end
+    end
+
+    # @private
+    #
+    # Transforms the input object into a Proc
+    #
+    # @param list [Symbol,Proc] method or proc to be transformed
+    #
+    # @return [Proc]
+    def actions(list)
+      list.map do |entry|
+        if entry.is_a?(Proc)
+          proc(&entry)
+        else
+          proc { send(entry) }
+        end
+      end
+    end
+  end
+end

data/lib/jace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
-class Jace
-  VERSION = '0.0.1'
+module Jace
+  VERSION = '0.0.2'
 end

data/lib/jace.rb

@@ -2,6 +2,7 @@
 
 # @api public
 # @author darthjee
-class Jace
-  autoload :VERSION, 'jace/version'
+module Jace
+  autoload :VERSION,  'jace/version'
+  autoload :Executer, 'jace/executer'
 end

data/spec/lib/jace/executer_spec.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Jace::Executer do
+  let(:person) { Person.new }
+
+  describe '.call' do
+    context 'without before or after' do
+      let(:result) do
+        described_class.call(context: person) { 10 }
+      end
+
+      it 'returns re result of block call' do
+        expect(result).to eq(10)
+      end
+
+      it 'executes in current context ignoring given context' do
+        expect(described_class.call(context: person) { self })
+          .to eq(self)
+      end
+    end
+
+    context 'with before option' do
+      context 'with symbol' do
+        let(:result) do
+          described_class.call(before: :init_age, context: person) do
+            person.age
+          end
+        end
+
+        it 'returns result after running before code' do
+          expect(result).to eq(1)
+        end
+
+        it 'changes state of context object' do
+          expect { result }.to change(person, :age)
+            .from(nil).to(1)
+        end
+      end
+
+      context 'with block' do
+        let(:block) { proc { @age = 10 } }
+
+        let(:result) do
+          described_class.call(before: block, context: person) { person.age }
+        end
+
+        it 'returns result after running before code' do
+          expect(result).to eq(10)
+        end
+
+        it 'changes state of context object' do
+          expect { result }.to change(person, :age)
+            .from(nil).to(10)
+        end
+      end
+
+      context 'with array' do
+        let(:block)  { proc { @brothers = @age ? 2 : 10 } }
+        let(:before) { [:init_age, block] }
+
+        let(:result) do
+          described_class.call(before: before, context: person) do
+            person.age + person.brothers
+          end
+        end
+
+        it 'returns result after running all before code' do
+          expect(result).to eq(3)
+        end
+
+        it 'changes state of context object by block call' do
+          expect { result }.to change(person, :brothers)
+            .from(0).to(2)
+        end
+
+        it 'changes state of context object by method call' do
+          expect { result }.to change(person, :age)
+            .from(nil).to(1)
+        end
+      end
+    end
+
+    context 'with after option' do
+      context 'with symbol' do
+        let(:result) do
+          described_class.call(after: :init_age, context: person) { person.age }
+        end
+
+        it 'returns result before running after code' do
+          expect(result).to be_nil
+        end
+
+        it 'changes state of context object' do
+          expect { result }.to change(person, :age)
+            .from(nil).to(1)
+        end
+      end
+
+      context 'with block' do
+        let(:block) { proc { @age = 10 } }
+
+        let(:result) do
+          described_class.call(after: block, context: person) { person.age }
+        end
+
+        it 'returns result before running after code' do
+          expect(result).to be_nil
+        end
+
+        it 'changes state of context object' do
+          expect { result }.to change(person, :age)
+            .from(nil).to(10)
+        end
+      end
+
+      context 'with array' do
+        let(:block) { proc { @brothers = @age ? 2 : 10 } }
+        let(:after) { [:init_age, block] }
+
+        let(:result) do
+          described_class.call(after: after, context: person) do
+            person.age.to_i + person.brothers
+          end
+        end
+
+        it 'returns result before running all after code' do
+          expect(result).to eq(0)
+        end
+
+        it 'changes state of context object by block call' do
+          expect { result }.to change(person, :brothers)
+            .from(0).to(2)
+        end
+
+        it 'changes state of context object by method call' do
+          expect { result }.to change(person, :age)
+            .from(nil).to(1)
+        end
+      end
+    end
+  end
+end

data/spec/support/models/person.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class Person
+  attr_accessor :age
+
+  def brothers
+    @brothers ||= 0
+  end
+
+  private
+
+  def init_age
+    @age ||= 1
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jace
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - DarthJee
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-11 00:00:00.000000000 Z
+date: 2020-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -234,7 +234,7 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 0.9.9
-description: ''
+description: Gem focused on events for meta-programing
 email:
 - darthjee@gmail.com
 executables: []
@@ -257,13 +257,16 @@ files:
 - config/yardstick.yml
 - docker-compose.yml
 - jace.gemspec
+- jace.jpg
 - lib/jace.rb
+- lib/jace/executer.rb
 - lib/jace/version.rb
 - spec/integration/readme/.keep
 - spec/integration/yard/.keep
+- spec/lib/jace/executer_spec.rb
 - spec/spec_helper.rb
-- spec/support/fixture_helpers.rb
 - spec/support/models/.keep
+- spec/support/models/person.rb
 - spec/support/shared_examples/.keep
 homepage: https://github.com/darthjee/jace
 licenses: []
@@ -287,5 +290,5 @@ rubyforge_project:
 rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
-summary: ''
+summary: Gem focused on events for meta-programing
 test_files: []

data/spec/support/fixture_helpers.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_support'
-
-module FixtureHelpers
-  def load_fixture_file(filename)
-    File.read(['./spec/', 'fixtures', filename].join('/'))
-  end
-
-  def load_json_fixture_file(filename)
-    cached_json_fixture_file(filename)
-  end
-
-  private
-
-  def cached_json_fixture_file(filename)
-    ActiveSupport::JSON.decode(load_fixture_file(filename))
-  end
-end
-
-RSpec.configuration.include FixtureHelpers