ragot 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c216474c3222f72271de2c6018be7b6b2332ca07
+  data.tar.gz: 6a429decec07ff3889b96d80769a14a90c23c1e0
+SHA512:
+  metadata.gz: 7ce756577cd34a40b6be973a80323043c79be8cf57b7869d191385a59213bc63e1beb6ec3b0d670d074dfa2d14a0c6b1bb197c32430fbaa769ccd725c73c0d18
+  data.tar.gz: 7bbe3ff6aeed846184820acf7ebca8c8da956b422224ea200189ea3caa981a05562e132629f5464cd3b0823999012936376cb887e05ff09bb09db0fd8bc28489

data/lib/ragot/version.rb

@@ -0,0 +1,3 @@
+module Ragot
+  VERSION = "0.1.0"
+end

data/lib/ragot.rb

@@ -0,0 +1,121 @@
+module Ragot
+
+  def self.included(klass)
+    klass.extend RagotInside
+  end
+
+  def env
+    @env ||= 'development'
+  end
+
+  def env=(env)
+    @env = env.to_s
+  end
+
+  def about(klass, *_, &block)
+    Declaration.for(klass).send (_.empty? ? :instance_exec : :ragot), *_, &block
+  end
+
+  module_function :about, :env, :env=
+
+  module RagotInside
+
+    def self.extended(klass)
+      unless klass.respond_to?(:after, true) || klass.respond_to?(:before, true)
+        klass.singleton_class.send :alias_method, :before, :declare_ragot
+        klass.singleton_class.send :alias_method, :after, :declare_ragot
+      end
+    end
+
+    def singleton_method_added(meth)
+      if method(meth).owner != Ragot::RagotInside && %i|before after|.include?(meth)
+        singleton_class.send :remove_method, (%i|before after| - [meth]).first
+      end
+    end
+
+    def method_added(meth)
+      Declaration.for(self).trigger meth
+    end
+
+    def declare_ragot(meth,  options={}, &block)
+      hook = __callee__.to_s.split('_').last.to_sym
+      Declaration.for(self).ragot meth, options.merge(hook: hook), &block
+    end
+
+    alias_method :ragot_after, :declare_ragot
+    alias_method :ragot_before, :declare_ragot
+    private :declare_ragot
+
+  end
+
+  class Declaration
+
+    def self.for(klass)
+      (@collection ||= {})[klass] ||= new klass
+    end
+
+    def initialize(klass)
+      @klass, @ragots, @i = klass, {}, { klass => {}, klass.singleton_class => {} }
+    end
+
+    def trigger(meth)
+      @ragots[meth] && @ragots[meth].shift(@ragots[meth].size).each do |r|
+        __incept_ragot *r
+      end
+    end
+
+    def ragot(meth, options={}, &block)
+      __incept_ragot(meth.to_sym, block, options) ||
+        (@ragots[meth.to_sym] ||= []).push([meth.to_sym, block, options])
+    end
+
+    private
+
+    FAILSAFE = { 'demo' => true, 'production' => true }
+
+    def self.exec_hook(ragotee, failsafe, code, *result_and_params)
+      ragotee.instance_exec *result_and_params, &code
+    rescue => e
+      failsafe ? nil : raise(e)
+    end
+
+    def __incept_ragot(meth, blk, options)
+      o = { hook: :after, failsafe: FAILSAFE[Ragot.env], env: Ragot.env }.merge(options)
+      k = o[:class] ? @klass.singleton_class : @klass
+      @i[k][meth] ||= { before: [], after: [], stamp: [] }
+
+      return unless Array(o[:env]).map(&:to_s).include? Ragot.env
+      return unless (k.instance_methods + k.private_instance_methods).include? meth.to_sym
+
+      @i[k][meth][ :stamp ] << [ o[:failsafe], default_hook(meth, :before) ] if o[:stamp]
+      @i[k][meth][o[:hook]] << [ o[:failsafe], blk || default_hook(meth,  o[:hook]) ]
+      @i[k][meth][:alias] ||= redefine k, meth, @i[k][meth]
+    end
+
+    def redefine(klass, meth, i)
+      klass.send :alias_method, "__ragot_inception_#{meth}", meth
+      klass.send :define_method, meth, ->(*_, &b) {
+        (i[:stamp] + i[:before]).each { |exe| Declaration.exec_hook self, *exe, *_ }
+        r = send "__ragot_inception_#{meth}", *_, &b
+        i[:after].each { |exe| Declaration.exec_hook self, *exe, r, *_ }
+        r
+      }
+    end
+
+    MESSAGE = { before: "Entered %s, with params %s,%s at %s .%s",
+      after: "`%s` called, with params : %s. Got '%s' as result, at %s .%s"
+    }
+
+    DEFAULT_HOOK = ->(hook, meth, result, *_) {
+      def ragot_talk(*_); puts *_; end unless respond_to? :ragot_talk, true
+      time = [Time.now].tap { |t| t << t.first.to_f.to_s.split('.').last }
+      ragot_talk MESSAGE[hook] % [meth, _.to_s, result, *time]
+    }
+
+    def default_hook(meth, hook)
+      ->(*_) { instance_exec hook, meth, _.shift, *_, &DEFAULT_HOOK }
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: ragot
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- lacravate
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+description: A gem to tell on methods and what they do, behind their backs. A hack
+  to create hooks around methods.
+email:
+- lacravate@lacravate.fr
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ragot.rb
+- lib/ragot/version.rb
+homepage: https://github.com/lacravate/ragot
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: A hack to create hooks around methods.
+test_files: []