added 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a35937cb5def349f87957a9051eda9b48e43232c
+  data.tar.gz: 8624cfe16cf21d2ee5ef2c6c05f33bfb349ce97e
+SHA512:
+  metadata.gz: 28d662efff045b68a7c1f06f897ad481bb4200dad1d47f42e0025e1c38cde46c18acccab844969e72b8e428aac8cd9dd1a168045f7d30e5ea2402094b5f49f36
+  data.tar.gz: 21b0364c4be97b695bb2e71dd00390a7341b592ee4a63c3139fd392c1c66a93944592ff71ccf9bd5984e9c686a52d1c0b8246adf92a60cdd03d373162ffae221

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+
+script: bundle exec ruby spec/*
+
+rvm:
+- 2.2.1
+- 2.2.0
+- 2.1.5
+- 2.1.4
+- 2.1.3
+- 2.1.2
+- 2.1.1
+- 2.1.0
+- 2.0.0
+- rbx-2
+- jruby-9.0.0.0.pre1
+
+env:
+- JRUBY_OPTS="--2.0 -X+O"

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+## CHANGELOG
+
+### 1.0.0
+
+* Release
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/MIT-LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2015 Jan Lelis
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,90 @@
+# Added Hook for Ruby [![[version]](https://badge.fury.io/rb/added.svg)](http://badge.fury.io/rb/added)  [![[travis]](https://travis-ci.org/janlelis/added.png)](https://travis-ci.org/janlelis/added)
+
+Module#added: A unified module hook to run code on all instances when adding the module.
+
+
+## Warning
+
+This is experimental stuff, using new/advanced language features. You should exactly know what you do, if you want to use it in production.
+
+Besides this, I am really curious if you like the approach this gem is taking!
+
+
+## Description
+
+Ruby allows you to run hooks, when an module is inserted into another object:
+
+* Module#extended
+* Module#included
+* Module#prepended
+
+This gem unifies all these hooks into a single `Module#added` one, which will be fired for *all* instances that the module has been added to. An example use case might be that you want to set some instance variable for all instances that include the module. There are three different occassions a hook is fired:
+
+* An object extends itself with the module -> The added hook will run for this object
+* A class has included/prepended the module -> The added hook will run on newly initialized objects of this class
+* A class has included/prepended the module -> The added hook will run on all existing instances of this class
+
+
+## Setup
+
+Add to your `Gemfile`
+
+```ruby
+gem 'added'
+```
+
+
+## Usage
+
+```ruby
+module MyStateSetter
+  def self.added(instance)
+    instance.instance_variable_set(:@my, "state")
+  end
+end
+
+# Extending
+object = Object.new
+object.extend(MyStateSetter)
+object.instance_variable_get(:@my) # => "state"
+
+# Including (new instances)
+klass = Class.new
+klass.include(MyStateSetter)
+object = klass.new
+object.instance_variable_get(:@my) # => "state"
+
+# Including (existing instances)
+klass = Class.new
+object = klass.new
+klass.include(MyStateSetter)
+object.instance_variable_get(:@my) # => "state"
+
+# Prepending (new instances)
+klass = Class.new
+klass.prepend(MyStateSetter)
+object = klass.new
+object.instance_variable_get(:@my) # => "state"
+
+# Including (existing instances)
+klass = Class.new
+object = klass.new
+klass.prepend(MyStateSetter)
+object.instance_variable_get(:@my) # => "state"
+
+```
+
+
+## JRuby Notes
+
+This gem requires a Module#prepend implementation and must have the ObjectSpace available. As JRuby user this means you will need to run JRuby 9000 with the -X+O option to use this gem.
+
+
+# Also See
+
+* [ActiveSupport::Concern](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/concern.rb)
+
+
+## MIT License
+
+Copyright (C) 2015 by [Jan Lelis](http://janlelis.com). 

data/added.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path('../lib/added/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name          = "added"
+  gem.version       = Added::VERSION
+  gem.summary       = 'Added hook.'
+  gem.description   = 'Module#added: A unified module hook to run code on all instances when adding the module.'
+  gem.license       = "MIT"
+  gem.authors       = ["Jan Lelis"]
+  gem.email         = "mail@janlelis.de"
+  gem.homepage      = "https://github.com/janlelis/added"
+
+  gem.files         = Dir['{**/}{.*,*}'].select { |path| File.file?(path) }
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.required_ruby_version = '~> 2.0'
+end

data/lib/added.rb

@@ -0,0 +1,3 @@
+require_relative 'added/version'
+require_relative 'added/implementation'
+require_relative 'added/core_ext'

data/lib/added/core_ext.rb

@@ -0,0 +1,3 @@
+class Module
+  prepend Added
+end

data/lib/added/implementation.rb

@@ -0,0 +1,24 @@
+module Added
+  def extended(instance)
+    super
+    added(instance) if respond_to? :added
+  end
+
+  def included(klass)
+    super
+    if respond_to? :added
+      mod = self
+      klass.prepend(Module.new do
+        define_method(:initialize){ |*args, &block|
+          super(*args, &block)
+          mod.added(self)
+        }
+      end)
+      ObjectSpace.each_object(klass){ |instance|
+        added(instance)
+      }
+    end
+  end
+
+  alias prepended included
+end

data/lib/added/version.rb

@@ -0,0 +1,3 @@
+module Added
+  VERSION = "1.0.0"
+end

data/spec/added_spec.rb

@@ -0,0 +1,97 @@
+require_relative '../lib/added'
+require 'minitest/autorun'
+
+describe Added do
+  let :object do
+    Object.new
+  end
+
+  let :klass do
+    Class.new
+  end
+
+  let :mod do
+    Module.new do
+      def self.added(instance)
+        instance.instance_variable_set(:@my, "state")
+      end
+    end
+  end
+
+ describe 'Extending' do
+   it 'works' do
+     object.extend(mod)
+
+     assert_equal "state", object.instance_variable_get(:@my)
+   end
+ end
+
+ describe 'Including (new instances)' do
+   it 'works' do
+     klass.send :include, mod
+     object = klass.new
+
+     assert_equal "state", object.instance_variable_get(:@my)
+   end
+ end
+
+ describe 'Including (existing instances)' do
+   it 'works' do
+     object = klass.new
+     klass.send :include, mod
+
+     assert_equal "state", object.instance_variable_get(:@my)
+   end
+ end
+
+ describe 'Prepending (new instances)' do
+   it 'works' do
+     klass.send :prepend, mod
+     object = klass.new
+
+     assert_equal "state", object.instance_variable_get(:@my)
+   end
+ end
+
+ describe 'Prepending (existing instances)' do
+   it 'works' do
+     object = klass.new
+     klass.send :prepend, mod
+
+     assert_equal "state", object.instance_variable_get(:@my)
+   end
+ end
+
+ describe 'More' do
+   it 'respects initializers before inclusion' do
+     klass.send :define_method, :initialize do |*args|
+       @my2 = args[0]
+     end
+     klass.include(mod)
+     object = klass.new("state2")
+
+     assert_equal "state", object.instance_variable_get(:@my)
+     assert_equal "state2", object.instance_variable_get(:@my2)
+   end
+
+   it 'respects initializers after inclusion' do
+     klass.include(mod)
+     klass.send :define_method, :initialize do |*args|
+       @my2 = args[0]
+     end
+     object = klass.new("state2")
+
+     assert_equal "state", object.instance_variable_get(:@my)
+     assert_equal "state2", object.instance_variable_get(:@my2)
+   end
+
+   it 'works with sub-classed classes' do
+     sub_klass = Class.new(klass)
+     klass.include(mod)
+     object = sub_klass.new
+
+     assert_equal "state", object.instance_variable_get(:@my)
+   end
+ end
+end
+

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: added
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jan Lelis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-15 00:00:00.000000000 Z
+dependencies: []
+description: 'Module#added: A unified module hook to run code on all instances when
+  adding the module.'
+email: mail@janlelis.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE.txt
+- README.md
+- added.gemspec
+- lib/added.rb
+- lib/added/.implementation.rb.swp
+- lib/added/core_ext.rb
+- lib/added/implementation.rb
+- lib/added/version.rb
+- spec/added_spec.rb
+homepage: https://github.com/janlelis/added
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.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: Added hook.
+test_files:
+- spec/added_spec.rb
+has_rdoc: