alakazam 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1652b38f86938a1de1195361d799813aaed014bb
+  data.tar.gz: a7c3aa7a6c456820fa68a613b04cb3b0dc236c8e
+SHA512:
+  metadata.gz: 82ec4cd082b655986ee20e685f55c6e41e36b84bf1659084a113798b279dba0c6efc1d21333fa66b2d5ae97a878f735e6572dc1a5dcf938ea1ac44e80338c45c
+  data.tar.gz: 17c4f35ea5299dddb41755828349eee3efca11356f08002cf72342be7ebd008893fb40bd287d492b0d84cc82cf1739b16be38a5b2f35490f84c9e650dc9389d1

data/lib/alakazam.rb

@@ -0,0 +1,11 @@
+#--
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#                    Version 2, December 2004
+#
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+#
+#  0. You just DO WHAT THE FUCK YOU WANT TO.
+#++
+require 'alakazam/alakazam'
+require 'alakazam/version'

data/lib/alakazam/alakazam.rb

@@ -0,0 +1,98 @@
+#--
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#                    Version 2, December 2004
+#
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+#
+#  0. You just DO WHAT THE FUCK YOU WANT TO.
+#++
+
+module Alakazam
+  def add_observer(observer, attributes: {}, when_change: true, methods: [] )
+    attributes = [attributes] unless attributes.is_a? Array
+    methods    = [methods   ] unless methods.is_a?    Array
+
+    attributes.each { |attribute|
+      next if not attribute[:var]
+      
+      self.class.send(:define_method, :"#{attribute[:var]}=") do |val|
+        fire!
+        notify_observers attribute[:notify]
+        instance_eval "@#{attribute[:var]} = #{val}"
+      end
+    }
+
+    if not has_observer? observer
+      @observers ||= {}
+      @observers[observer] = { when_change: when_change, methods: methods }
+    end
+  end
+    alias_method :is_observed_by, :add_observer
+    alias_method :attach,         :add_observer
+    alias_method :observe,        :add_observer
+
+
+  def delete_observer(observer)
+    (@observers || {}).delete observer
+  end
+    alias_method :remove_observer, :delete_observer
+    alias_method :detach,          :delete_observer
+    alias_method :disconnect,      :delete_observer
+
+  def has_observer?(observer)
+    (@observers || {}).include? observer
+  end
+    alias_method :is_observed_by?, :has_observer?
+
+  def count_observers
+    (@observers || {}).length
+  end
+    alias_method :how_many_observers?, :count_observers
+
+  def changed
+    @changed = !changed?
+  end
+    alias_method :change!, :changed
+    alias_method :fire!,   :changed
+
+  def changed=(state)
+    @changed = state
+  end
+    alias_method :fired=, :changed=
+
+  def changed?
+    !!@changed
+  end
+    alias_method :fired?, :changed?
+
+  def notify_observers(*things)
+    (@observers || {}).each { |observer, options|
+      if !options[:when_change] || changed?
+        if options[:methods].any?
+          options[:methods].each { |method|
+            if observer.respond_to? method
+              observer.send method, things
+            elsif observer.singleton_class.respond_to? method
+              observer.singleton_class.send method, things
+            elsif observer.respond_to? :"#{method}="
+              observer.send method, things
+            end
+          }
+        elsif observer.respond_to? :update
+          observer.update things
+        elsif observer.is_a? Proc
+          observer.call things
+        else
+          options[:methods].each { |method|
+            observer.send(method, things) if observer.respond_to? method
+          }
+        end
+      end
+    }
+
+    @changed = false
+  end
+    alias_method :notify, :notify_observers
+    alias_method :fire,   :notify_observers
+end

data/lib/alakazam/version.rb

@@ -0,0 +1,13 @@
+#--
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#                    Version 2, December 2004
+#
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+#
+#  0. You just DO WHAT THE FUCK YOU WANT TO.
+#++
+
+module Alakazam
+  VERSION = '0.1'
+end

data/tests/alakazam_spec.rb

@@ -0,0 +1,117 @@
+#! /usr/bin/env ruby
+#--
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#                    Version 2, December 2004
+#
+#            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+#   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+#
+#  0. You just DO WHAT THE FUCK YOU WANT TO.
+#++
+require 'alakazam'
+
+class Shiftry
+  include Alakazam
+  extend  Alakazam # required only to observe class methods
+  attr_accessor :lal
+
+  def lol
+    fire!
+    notify 'fired'
+  end
+
+  def lel
+    notify 'fired'
+  end
+
+  def self.lul
+    fire!
+    notify 'fired'
+  end
+end
+
+class Logger
+  def update(*things)
+    $i += 1
+  end
+
+  def self.on_fire(*things)
+    $i += 1
+  end
+end
+
+describe Alakazam do
+  before do
+    $i = 0
+  end
+
+  let(:counter) do
+    counter = $i
+  end
+
+  let(:logger) do
+    logger = ->(*things) { $i += 1 }
+  end
+
+  let(:shiftry) do
+    shiftry = Shiftry.new
+  end
+
+  after do
+    $i = 0
+  end
+
+  it 'invokes a Proc when notified by observed class' do
+    shiftry.is_observed_by logger
+
+    shiftry.lol
+    shiftry.lol
+
+    shiftry.lel
+    shiftry.lel
+
+    counter.should be 2
+  end
+
+  it 'invokes a Proc without explicit notify when notified by observed class' do
+    shiftry.is_observed_by logger, when_change: false
+
+    shiftry.lol
+    shiftry.lol
+
+    shiftry.lel
+    shiftry.lel
+
+    counter.should be 4
+  end
+
+  it 'invokes a Proc when notified by a class method of the observed class' do
+    Shiftry.is_observed_by logger
+
+    Shiftry.lul
+    Shiftry.lul
+
+    counter.should be 2
+  end
+
+  it 'invokes the logger\'s custom and default method when notified by observed class' do
+    shiftry.is_observed_by Logger.new, methods: [ :on_fire, :non_existing_method ]
+    shiftry.is_observed_by Logger.new
+
+    shiftry.lol
+
+    counter.should be 2
+  end
+
+  it 'invokes the logger\'s default method when a variable changes in the observed class' do
+    shiftry.is_observed_by Logger.new, attributes: { var: :lal, notify: 'fired' }
+
+    shiftry.lal = 3
+    shiftry.lal.should be 3
+
+    shiftry.lal = 4
+    shiftry.lal.should be 4
+
+    counter.should be 2
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: alakazam
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Giovanni Capuano
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Alakazam provides methods to observe all your things.
+email: webmaster@giovannicapuano.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/alakazam/alakazam.rb
+- lib/alakazam/version.rb
+- lib/alakazam.rb
+- tests/alakazam_spec.rb
+homepage: https://github.com/RoxasShadow
+licenses:
+- WTFPL
+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.0.3
+signing_key: 
+specification_version: 4
+summary: An observer with everything you need
+test_files:
+- tests/alakazam_spec.rb