kungfuig 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7209ee253dbd083df7df4be1c0596cf3be0b45eb
-  data.tar.gz: 9cb680779c32389e770bceb047b4440c5e39c423
+  metadata.gz: d30ca22dee6e6cde7f9f34d17995ff7b27f6b37c
+  data.tar.gz: a0b476f59450a277e1ad55f2927240a5689e978a
 SHA512:
-  metadata.gz: 37ce51cdf63d82c08b78305427e23b1c6721533e5486bc7416ab9d9f3cf774b5fabf74af09c35b3385f0371a4c5c818c35e07b7f3c180e7c825d4411f93f3846
-  data.tar.gz: 654e3a115be6951f928a4e56441668eaad7b3f49f224dd3ee5f463a4eb2b5fbfb1c8098c5bb48daeb783c8a5e18132caa16b53b645a6467c872d63a635b5b08e
+  metadata.gz: f3a3077967091d00545cce2ccdbff1a76360f51150939374c2e5b402191b0beee12133af44ee5f8debb00390878225b4ac031c7ba964cec776173ae978fb998f
+  data.tar.gz: 058f353934143317f307ea99626480ff2f50558880ae25fb4eea2d69ccaaf77a1bf706b02af365cd5078dc714ded18ad0af7b31fd566b4551d806c990fca1a3e

data/.rubocop.yml

@@ -1,5 +1,10 @@
 inherit_from: .rubocop_todo.yml
 
+Style/AsciiIdentifiers:
+  Exclude:
+    - 'lib/**/*'
+    - 'spec/**/*'
+
 Style/AsciiComments:
   Exclude:
     - 'lib/**/*'
@@ -8,3 +13,8 @@ Style/AsciiComments:
 Style/RaiseArgs:
   Exclude:
     - 'lib/**/*'
+
+Style/SpecialGlobalVars:
+  Exclude:
+    - 'lib/**/*'
+    - 'spec/**/*'

data/kungfuig.gemspec

@@ -22,6 +22,7 @@ Gem::Specification.new do |spec|
   # spec.metadata['allowed_push_host'] = 'http://mygemserver.com' if spec.respond_to?(:metadata)
 
   spec.add_dependency 'hashie', '~> 3'
+  spec.add_dependency 'sidekiq', '~> 3.5', '>= 3.5.2'
 
   spec.add_development_dependency 'bundler', '~> 1.7'
   spec.add_development_dependency 'rake', '~> 10.0'
@@ -30,4 +31,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rspec', '~> 2.12'
   spec.add_development_dependency 'cucumber', '~> 1.3'
   spec.add_development_dependency 'yard', '~> 0'
+
+  spec.add_development_dependency 'rspec-sidekiq', '~> 1'
 end

data/lib/kungfuig.rb

@@ -1,11 +1,52 @@
-require 'kungfuig/version'
 require 'yaml'
 require 'hashie'
 
+require 'kungfuig/version'
+require 'kungfuig/aspector'
+
 module Kungfuig
   ASPECT_PREFIX = '♻_'.freeze
   MX = Mutex.new
 
+  # rubocop:disable Style/VariableName
+  # rubocop:disable Style/MethodName
+  def ✍(receiver, method, result, *args)
+    require 'logger'
+    @✍ ||= Kernel.const_defined?('Rails') && Rails.logger || Logger.new($stdout)
+    message = receiver.is_a?(String) ? "#{receiver} | #{method}" : "#{receiver.class}##{method}"
+    "#{message} called with «#{args.inspect}» and returned «#{result || 'nothing (was it before aspect?)'}»".tap do |m|
+      @✍.debug m
+    end
+  end
+  module_function :✍
+  # rubocop:enable Style/MethodName
+  # rubocop:enable Style/VariableName
+
+  # rubocop:disable Metrics/CyclomaticComplexity
+  # rubocop:disable Metrics/MethodLength
+  def load_stuff hos
+    case hos
+    when NilClass then Hashie::Mash.new # aka skip
+    when Hash then Hashie::Mash.new(hos)
+    when String
+      begin
+        File.exist?(hos) ? Hashie::Mash.load(hos) : Hashie::Mash.new(YAML.load(hos)).tap do |opts|
+          fail ArgumentError.new "#{__callee__} expects valid YAML configuration file or YAML string." unless opts.is_a?(Hash)
+        end
+      rescue ArgumentError
+        fail ArgumentError.new "#{__callee__} expects valid YAML configuration file. [#{hos}] contains invalid syntax."
+      rescue Psych::SyntaxError
+        fail ArgumentError.new "#{__callee__} expects valid YAML configuration string. Got:\n#{hos}"
+      end
+    when ->(h) { h.respond_to?(:to_hash) } then Hashie::Mash.new(h.to_hash)
+    else
+      fail ArgumentError.new "#{__callee__} accepts either String or Hash as parameter."
+    end
+  end
+  # rubocop:enable Metrics/MethodLength
+  # rubocop:enable Metrics/CyclomaticComplexity
+  module_function :load_stuff
+
   module InstanceMethods
     # Configures everything by hash or yaml from string or file. Whether code block
     #   is passed, it is processed with @options instance.
@@ -64,34 +105,12 @@ module Kungfuig
       !option(*keys).nil?
     end
 
-    # rubocop:disable Metrics/AbcSize
-    # rubocop:disable Metrics/CyclomaticComplexity
-    # rubocop:disable Metrics/MethodLength
     # @param hos [Hash|String] the new values taken from hash,
     #   mash or string (when string, should be either valid YAML file name or
     #   string with valid YAML)
     def merge_hash_or_string! hos
-      options.deep_merge! case hos
-                          when NilClass then Hashie::Mash.new # aka skip
-                          when Hash then Hashie::Mash.new(hos)
-                          when String
-                            begin
-                              File.exist?(hos) ? Hashie::Mash.load(hos) : Hashie::Mash.new(YAML.load(hos)).tap do |opts|
-                                fail ArgumentError.new "#{__callee__} expects valid YAML configuration file or YAML string." unless opts.is_a?(Hash)
-                              end
-                            rescue ArgumentError
-                              fail ArgumentError.new "#{__callee__} expects valid YAML configuration file. [#{hos}] contains invalid syntax."
-                            rescue Psych::SyntaxError
-                              fail ArgumentError.new "#{__callee__} expects valid YAML configuration string. Got:\n#{hos}"
-                            end
-                          when ->(h) { h.respond_to?(:to_hash) } then Hashie::Mash.new(h.to_hash)
-                          else
-                            fail ArgumentError.new "#{__callee__} accepts either String or Hash as parameter."
-                          end
+      options.deep_merge! Kungfuig.load_stuff hos
     end
-    # rubocop:enable Metrics/MethodLength
-    # rubocop:enable Metrics/CyclomaticComplexity
-    # rubocop:enable Metrics/AbcSize
     private :merge_hash_or_string!
   end
 
@@ -126,15 +145,15 @@ module Kungfuig
 
       unless instance_methods.include?(:"#{ASPECT_PREFIX}#{meth}")
         class_eval <<-CODE
-          alias_method :#{ASPECT_PREFIX}#{meth}, :#{meth}
+          alias_method :'#{ASPECT_PREFIX}#{meth}', :'#{meth}'
           def #{meth}(*args, &cb)
-            ps = self.class.aspects(:#{meth}).merge((class << self; self; end).aspects(:#{meth})) { |_, c, ec| c | ec }
+            ps = self.class.aspects(:'#{meth}').merge((class << self; self; end).aspects(:'#{meth}')) { |_, c, ec| c | ec }
             ps[:before].each do |p|
-              p.call(*args) # TODO: make prependers able to change args!!!
+              p.call(self, :'#{meth}', nil, *args) # FIXME: allow argument modification!!!
             end
-            send(:#{ASPECT_PREFIX}#{meth}, *args, &cb).tap do |result|
+            send(:'#{ASPECT_PREFIX}#{meth}', *args, &cb).tap do |result|
               ps[:after].each do |p|
-                p.call result, *args
+                p.call(self, :'#{meth}', result, *args)
               end
             end
           end

data/lib/kungfuig/aspector.rb

@@ -1,5 +1,3 @@
-require_relative '../kungfuig'
-
 module Kungfuig
   # Generic helper for massive attaching aspects
   module Aspector
@@ -10,26 +8,45 @@ module Kungfuig
           v = [*v].map(&:to_sym)
           case
           when v.empty? then []
-          when v.include?(:'*') then klazz.instance_methods(false)
+          when v.include?('*'), v.include?(:'*') then klazz.instance_methods(false)
           else klazz.instance_methods & v
           end
         end.reduce(&:-)
       end
+
+      def remap_hash_for_easy_iteration hash
+        hash = hash.each_with_object(Hashie::Mash.new) do |(k, v), memo|
+          v.each { |m, c| memo.public_send("#{m}!")[k] = c }
+        end unless (hash.keys - %w(before after exclude)).empty?
+        hash.each_with_object({}) do |(k, v), memo|
+          v.each { |m, h| ((memo[h] ||= {})[k.to_sym] ||= []) << m }
+        end
+      end
+
+      def proc_instance string
+        m, k = string.split('#').reverse
+        (k ? Kernel.const_get(k).method(m) : method(m)).to_proc
+      end
     end
 
     def attach(to, before: nil, after: nil, exclude: nil)
-      raise ArgumentError, "Trying to attach nothing to #{klazz}. I need a block!" unless block_given?
-
-      klazz = to.is_a?(Class) ? to : class << to; self; end # attach to klazz’s eigenclass if object given
+      klazz = case to
+              when String then Kernel.const_get(to) # we are ready to get a class name
+              when Class then to                    # got a class! wow, somebody has the documentation read
+              else class << to; self; end           # attach to klazz’s eigenclass if object given
+              end
 
+      raise ArgumentError, "Trying to attach nothing to #{klazz}##{to}. I need a block!" unless block_given?
       klazz.send(:include, Kungfuig::Aspector) unless klazz.ancestors.include? Kungfuig::Aspector
       cb = Proc.new
 
       H.new.value_to_method_list(klazz, before, exclude).each do |m|
+        # FIXME: log methods that failed to be wrapped more accurately? # Kungfuig.✍(klazz, m, e.inspect)
         klazz.aspect(m, false, &cb)
       end unless before.nil?
 
       H.new.value_to_method_list(klazz, after, exclude).each do |m|
+        # FIXME: log methods that failed to be wrapped more accurately? # Kungfuig.✍(klazz, m, e.inspect)
         klazz.aspect(m, true, &cb)
       end unless after.nil?
 
@@ -37,6 +54,31 @@ module Kungfuig
     end
     module_function :attach
 
+    # 'Test':
+    #   after:
+    #     'yo': 'YoCalledAsyncHandler#process'
+    #     'yo1' : 'YoCalledAsyncHandler#process'
+    #   before:
+    #     'yo': 'YoCalledAsyncHandler#process'
+    def bulk(hos)
+      Kungfuig.load_stuff(hos).map do |klazz, hash|
+        next if hash.empty?
+        [klazz, H.new.remap_hash_for_easy_iteration(hash).map do |handler, methods|
+          begin
+            attach(klazz, **methods, &H.new.proc_instance(handler))
+          rescue => e
+            raise ArgumentError, [
+              "Bad input to Kungfuig::Aspector##{__callee__}.",
+              "Args: #{methods.inspect}",
+              "Original exception: “#{e.message}”.",
+              e.backtrace.unshift("Backtrace:").join("#{$/}⮩  ")
+            ].join($/.to_s)
+          end
+        end]
+      end.compact.to_h
+    end
+    module_function :bulk
+
     private_constant :H
   end
 end

data/lib/kungfuig/jobber.rb

@@ -0,0 +1,41 @@
+require_relative './aspector'
+require 'rubygems/exceptions'
+
+begin
+  require 'sidekiq'
+  raise LoadError.new unless Kernel.const_defined?('Sidekiq')
+rescue LoadError
+  raise(Gem::DependencyError, "Sidekiq id required to use this functionality!")
+end
+
+module Kungfuig
+  # Generic helper for massive attaching aspects
+  class Jobber
+    class << self
+      # 'Test':
+      #   '*': 'YoJob'
+      def bulk(hos)
+        @hash = Kungfuig.load_stuff hos
+        Kungfuig::Aspector.bulk(
+          @hash.map do |klazz, hash|
+            [klazz, { after: hash.map { |k, _| [k, 'Kungfuig::Jobber#bottleneck'] }.to_h }]
+          end.to_h
+        )
+      end
+
+      def bottleneck(receiver, method, result, *args)
+        respond_to = ->(m, r) { r.respond_to? m.to_sym }
+        r = case receiver
+            when respond_to.curry[:to_hash] then receiver.to_hash
+            when respond_to.curry[:to_h] then receiver.to_h
+            else receiver
+            end
+
+        Kernel.const_get(@hash[receiver.class.name][method])
+              .perform_async(r, method, result, *args)
+      rescue => e
+        Kungfuig.✍("Fail [#{e.message}] while #{receiver}", method, result, *args)
+      end
+    end
+  end
+end

data/lib/kungfuig/version.rb

@@ -1,3 +1,3 @@
 module Kungfuig
-  VERSION = "0.4.2"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kungfuig
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.0
 platform: ruby
 authors:
 - Kantox LTD
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-23 00:00:00.000000000 Z
+date: 2016-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -24,6 +24,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
+- !ruby/object:Gem::Dependency
+  name: sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +128,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
 description: Config with goodnesses.
 email:
 - aleksei.matiushkin@kantox.com
@@ -126,6 +160,7 @@ files:
 - kungfuig.gemspec
 - lib/kungfuig.rb
 - lib/kungfuig/aspector.rb
+- lib/kungfuig/jobber.rb
 - lib/kungfuig/version.rb
 homepage: http://kantox.com
 licenses: