concern 0.2.1

data/Rakefile.rb

@@ -0,0 +1,19 @@
+task :default => :spec
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new {|t| t.spec_opts = ['--color']}
+
+begin
+  require 'jeweler'
+  project_name = 'concern'
+  Jeweler::Tasks.new do |gem|
+    gem.name = project_name
+    gem.description = gem.summary = "Seperation of concerns without meta-madness and namespace pollution"
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/Readme.md

@@ -0,0 +1,74 @@
+Seperation of concerns with clean namespaces.  
+
+Normal includes and extensions pollute the namespace and share private/protected.  
+With concern, everything stays in the Concern, can access the concerned and keep namespaced+private.
+
+Install
+=======
+ - As Rails plugin: `rails plugin install git://github.com/grosser/concern.git `
+ - As gem: ` gem install concern `
+
+Usage
+=====
+Simple:
+    # a.rb
+    require 'concern'
+    class A
+      concern 'a/acl'
+
+      def admin? ...
+    end
+
+    # a/acl.rb
+    # can access concerned methods like `admin?`
+    class A::ACL < Concern
+      def can_access?(vault)
+        admin? and secret
+      end
+
+      private
+
+      def secrect ...
+    end
+
+    A.new.acl.can_access?(BankAccount)
+
+Let no outsider know, and use delegate:
+
+    class A
+      class Messages
+        def write ...
+        def read ...
+      end
+
+      concern 'a/acl', :delegate => true # delegate all public methods
+      concern 'a/messages', :delegate => [:write]
+    end
+
+    A.new.can_access?(BankAccount) # no more `.acl` needed
+    A.new.write
+    A.new.messages.read
+
+Adding to the concerned, e.g. validations/associations/scopes etc.
+    class User < ActiveRecord::Base
+      concern 'user/validator', :delegate => true
+    end
+
+    # user/validator.rb
+    class User::Validator < Concern
+      def self.included(concerned)
+        concerned.class_eval do
+          validates_presence_of :name, :if => :name_seems_legit?
+        end
+      end
+
+      def name_seems_legit? ..
+    end
+
+More examples can be found in [spec/examples](http://github.com/grosser/concern/tree/master/spec/examples)
+
+Author
+======
+[Michael Grosser](http://grosser.it)  
+grosser.michael@gmail.com  
+Hereby placed under public domain, do what you want, just do not hold me accountable...

data/VERSION

@@ -0,0 +1 @@
+0.2.1

data/concern.gemspec

@@ -0,0 +1,63 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile.rb, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{concern}
+  s.version = "0.2.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2010-10-19}
+  s.description = %q{Seperation of concerns without meta-madness and namespace pollution}
+  s.email = %q{grosser.michael@gmail.com}
+  s.files = [
+    "Rakefile.rb",
+     "Readme.md",
+     "VERSION",
+     "concern.gemspec",
+     "init.rb",
+     "lib/concern.rb",
+     "spec/concern_spec.rb",
+     "spec/examples/a/b.rb",
+     "spec/examples/a/bc_def_gh.rb",
+     "spec/examples/adding.rb",
+     "spec/examples/complex_inline.rb",
+     "spec/examples/complex_require.rb",
+     "spec/examples/delegate.rb",
+     "spec/examples/inline.rb",
+     "spec/examples/load.rb",
+     "spec/examples/parent_warning.rb",
+     "spec/examples/picky_delegate.rb"
+  ]
+  s.homepage = %q{http://github.com/grosser/concern}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Seperation of concerns without meta-madness and namespace pollution}
+  s.test_files = [
+    "spec/concern_spec.rb",
+     "spec/examples/picky_delegate.rb",
+     "spec/examples/complex_inline.rb",
+     "spec/examples/parent_warning.rb",
+     "spec/examples/adding.rb",
+     "spec/examples/complex_require.rb",
+     "spec/examples/load.rb",
+     "spec/examples/a/b.rb",
+     "spec/examples/a/bc_def_gh.rb",
+     "spec/examples/delegate.rb",
+     "spec/examples/inline.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/init.rb

@@ -0,0 +1,2 @@
+#only needed wen used as Rails plugin
+require 'concern'

data/lib/concern.rb

@@ -0,0 +1,59 @@
+class Concern
+  VERSION = File.read(File.join(File.dirname(__FILE__), '..', 'VERSION'))
+
+  attr_accessor :concerned
+
+  def self.classify(lib)
+    lib.split('/').map{|part| part.gsub(/(?:^|_)(.)/){ $1.upcase } }.join('::')
+  end
+end
+
+class Object
+  def self.concern(lib, options={})
+    # load delegate
+    lib = lib.to_s
+    klass = Concern.classify(lib)
+    begin
+      klass = eval(klass)
+    rescue
+      require lib
+      klass = eval(klass)
+    end
+
+    unless klass.instance_methods.map{|x|x.to_s}.include?('concerned=')
+      raise "A concern must always extend Concern"
+    end
+
+    # make accessor
+    accessor = lib.split('/').last.to_sym
+    eval <<-EOF
+      def #{accessor}
+        return @#{accessor} if @#{accessor}
+        @#{accessor} = #{klass}.new
+        @#{accessor}.concerned = self
+        @#{accessor}
+      end
+    EOF
+
+    # call included
+    base = eval(name) #self.class is always Class, but name is class that called concern
+    klass.included(base) if klass.respond_to? :included
+
+    # delegate methods
+    if options[:delegate]
+      methods = if options[:delegate].is_a?(Array)
+        options[:delegate]
+      else
+        klass.public_instance_methods(false)
+      end
+
+      methods.each do |method|
+        eval <<-EOF
+          def #{method}(*args)
+            #{accessor}.#{method}(*args)
+          end
+        EOF
+      end
+    end
+  end
+end

data/spec/concern_spec.rb

@@ -0,0 +1,33 @@
+describe "Concern" do
+  it "loads a simple file" do
+    `ruby spec/examples/load.rb`.should == "hello"
+  end
+
+  it "requires a complex file" do
+    `ruby spec/examples/complex_require.rb`.should == "SUCCESS"
+  end
+
+  it "can use already present class" do
+    `ruby spec/examples/inline.rb`.should == "inline"
+  end
+
+  it "can use complex present class" do
+    `ruby spec/examples/complex_inline.rb`.should == "SUCCESS"
+  end
+
+  it "can delegate" do
+    `ruby spec/examples/delegate.rb`.should == "hello"
+  end
+
+  it "can delegate some" do
+    `ruby spec/examples/picky_delegate.rb`.should == "hello"
+  end
+
+  it "add to parent" do
+    `ruby spec/examples/adding.rb`.should == "yepworld"
+  end
+
+  it "warns when parent is not Concern" do
+    `ruby spec/examples/parent_warning.rb`.should == "SUCCESS"
+  end
+end

data/spec/examples/a/b.rb

@@ -0,0 +1,9 @@
+class A::B < Concern
+  def test
+    'hello'
+  end
+
+  def test2
+    'ohoh'
+  end
+end

data/spec/examples/a/bc_def_gh.rb

@@ -0,0 +1,5 @@
+class A::BcDefGh < Concern
+  def test
+    'SUCCESS'
+  end
+end

data/spec/examples/adding.rb

@@ -0,0 +1,29 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+
+class A
+  class B < Concern
+    def initialize
+      super
+      @hello = 'world'
+    end
+
+    def hello
+      @hello
+    end
+
+    def self.included(base)
+      base.class_eval do
+        test
+      end
+    end
+  end
+
+  def self.test
+    print "yep"
+  end
+
+  concern 'a/b'
+end
+
+print A.new.b.hello

data/spec/examples/complex_inline.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+
+class A
+  module Bc
+    class DefGh < Concern
+      def test
+        'SUCCESS'
+      end
+    end
+  end
+  concern 'a/bc/def_gh', :delegate=>true
+end
+
+print A.new.test

data/spec/examples/complex_require.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+
+class A
+  concern 'a/bc_def_gh', :delegate=>true
+end
+
+print A.new.test

data/spec/examples/delegate.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+
+class A
+  def xxx
+    'xxx'
+  end
+  concern 'a/b', :delegate=>true
+end
+
+raise if A.new.send(:xxx) != 'xxx'
+print A.new.test

data/spec/examples/inline.rb

@@ -0,0 +1,13 @@
+$LOAD_PATH << 'lib'
+require 'concern'
+
+class A
+  class B < Concern
+    def test
+      'inline'
+    end
+  end
+  concern 'a/b'
+end
+
+print A.new.b.test

data/spec/examples/load.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+
+class A
+  concern 'a/b'
+end
+
+print A.new.b.test

data/spec/examples/parent_warning.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+
+class A
+  class B # < Concern
+  end
+
+  begin
+    concern 'a/b'
+    print 'FAIL'
+  rescue
+    raise unless $!.to_s =~ /extend Concern/
+    print 'SUCCESS'
+  end
+end

data/spec/examples/picky_delegate.rb

@@ -0,0 +1,14 @@
+$LOAD_PATH << 'lib' << 'spec/examples'
+require 'concern'
+class A
+  concern 'a/b', :delegate=>[:test]
+end
+
+ok = begin
+  A.new.test2
+  false
+rescue
+  true
+end
+raise unless ok
+print A.new.test

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: concern
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-19 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Seperation of concerns without meta-madness and namespace pollution
+email: grosser.michael@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile.rb
+- Readme.md
+- VERSION
+- concern.gemspec
+- init.rb
+- lib/concern.rb
+- spec/concern_spec.rb
+- spec/examples/a/b.rb
+- spec/examples/a/bc_def_gh.rb
+- spec/examples/adding.rb
+- spec/examples/complex_inline.rb
+- spec/examples/complex_require.rb
+- spec/examples/delegate.rb
+- spec/examples/inline.rb
+- spec/examples/load.rb
+- spec/examples/parent_warning.rb
+- spec/examples/picky_delegate.rb
+has_rdoc: true
+homepage: http://github.com/grosser/concern
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Seperation of concerns without meta-madness and namespace pollution
+test_files: 
+- spec/concern_spec.rb
+- spec/examples/picky_delegate.rb
+- spec/examples/complex_inline.rb
+- spec/examples/parent_warning.rb
+- spec/examples/adding.rb
+- spec/examples/complex_require.rb
+- spec/examples/load.rb
+- spec/examples/a/b.rb
+- spec/examples/a/bc_def_gh.rb
+- spec/examples/delegate.rb
+- spec/examples/inline.rb