kinda-core 0.0.4 → 0.0.5

data/README.rdoc

@@ -1,6 +1,3 @@
-Author:: Manuel Vila (mailto:mvila@3base.com)
-License:: Don't know yet
-
 = Core
 
 Basic helpers used by other kinda projects.
@@ -11,4 +8,4 @@ Basic helpers used by other kinda projects.
 
 == Usage
 
-Still very alpha so documentation will come later.
+Still very alpha, documentation will come later.

data/Rakefile

@@ -0,0 +1,20 @@
+require "rake/testtask"
+
+begin
+  require "hanna/rdoctask"
+rescue LoadError
+  require "rake/rdoctask"
+end
+
+task :default => [:test]
+
+Rake::TestTask.new do |t|
+  t.test_files = Dir["test/*_test.rb"]
+end
+
+Rake::RDocTask.new do |t|
+  t.title = "Core Documentation"
+  t.main = "README.rdoc"
+  t.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+  t.rdoc_dir = "doc"
+end

data/lib/core.rb

@@ -1,8 +1,10 @@
 require File.join(File.dirname(__FILE__), 'core', 'module')
+require File.join(File.dirname(__FILE__), 'core', 'object')
 ruby_files = Dir.glob(File.join(File.dirname(__FILE__), 'core', '*.rb'))
 ruby_files.each { |file| require file }
 
-module Kinda
+module Kinda #:nodoc:
+  # Basic helpers used by other kinda projects
   module Core
     include Accessor
     include Forwardable

data/lib/core/accessor.rb

@@ -1,14 +1,8 @@
-module Kinda
-  module Core
+module Kinda #:nodoc:
+  module Core #:nodoc:
+    # Improves the Ruby buit-in accessor methods
     module Accessor
-      module ClassMethods
-        # attr_reader(:name, :age, :size)
-        # attr_reader(:name => :@name) is the default behaviour but you can use:
-        # attr_reader (:name => @the_name) to use a different instance variable
-        # attr_reader(:name => :first_name) or even an another attribute.
-        # But more interesting, you can delegate to another object:
-        # attr_reader(:name => [:father, :name])
-        # attr_reader(:name => [:mother, :husband, :name])
+      ClassMethods = inheritable_extend do
         def __attr_reader__(*attributes, with_filter, &block)
           attributes.each do |attribute|
             if attribute.is_a?(Hash)
@@ -17,7 +11,7 @@ module Kinda
               source = "@#{attribute}"
             end
             proc = if with_filter || !block
-              ::Proc.new do |*args|
+              Proc.new do |*args|
                 return send("#{attribute}=", *args) unless args.empty?
                 value = if source[0] == '@'
                    instance_variable_get(source)
@@ -31,10 +25,19 @@ module Kinda
             else
               block
             end
-            to_class.send(:define_method, attribute, &proc)
+            send(:define_method, attribute, &proc)
           end
         end
+        
+        private :__attr_reader__
 
+        # attr_reader(:name, :age, :size)
+        # attr_reader(:name => :@name) is the default behaviour but you can use:
+        # attr_reader (:name => @the_name) to use a different instance variable
+        # attr_reader(:name => :first_name) or even an another attribute.
+        # More interesting, you can delegate to another object:
+        # attr_reader(:name => [:father, :name])
+        # attr_reader(:name => [:mother, :husband, :name])
         def attr_reader(*attributes, &block)
           __attr_reader__(*attributes, false, &block)
         end
@@ -51,7 +54,7 @@ module Kinda
               target = "@#{attribute}"
             end
             proc = if with_filter || !block
-              ::Proc.new do |value|
+              Proc.new do |value|
                 value = instance_exec(value, &block) if block
                 if target[0] == '@'
                   instance_variable_set(target, value)
@@ -64,9 +67,11 @@ module Kinda
             else
               block
             end
-            to_class.send(:define_method, "#{attribute}=", &proc)
+            send(:define_method, "#{attribute}=", &proc)
           end
         end
+        
+        private :__attr_writer__
 
         def attr_writer(*attributes, &block)
           __attr_writer__(*attributes, false, &block)
@@ -103,8 +108,7 @@ module Kinda
         end
       end
 
-      include ClassMethods
-      inheritable_extension ClassMethods
+      delegate_to_class ClassMethods.public_instance_methods
     end
   end
 end

data/lib/core/forwardable.rb

@@ -3,7 +3,7 @@ require 'forwardable'
 module Kinda
   module Core
     module Forwardable
-      module ClassMethods
+      ClassMethods = inheritable_extend do
         include ::Forwardable
 
         # Add a nice way to specify a different method for the accessor:
@@ -19,7 +19,7 @@ module Kinda
             end
           end
         end
-
+        
         alias_method :delegate, :instance_delegate
 
         # Create both reader and writer delegate
@@ -79,8 +79,7 @@ module Kinda
         end
       end
 
-      include ClassMethods
-      inheritable_extension ClassMethods
+      delegate_to_class ClassMethods.public_instance_methods
     end
   end
 end

data/lib/core/functor.rb

@@ -1,7 +1,7 @@
-# Thomas Sawyer's Functor Class slightly modified for Ruby 1.9
-# http://facets.rubyforge.org/apidoc/api/core/classes/Functor.html
 module Kinda
   module Core
+    # Thomas Sawyer's Functor Class slightly modified for Ruby 1.9
+    # http://facets.rubyforge.org/apidoc/api/core/classes/Functor.html
     class Functor < BasicObject
       def initialize(&proc)
         @proc = proc

data/lib/core/hash.rb

@@ -1,6 +1,6 @@
 module Kinda
   module Core
-    module Hash
+    module HashExtension
     	def delete_value(value)
     	  delete_if { |k, v| v == value }
     	end
@@ -8,6 +8,6 @@ module Kinda
   end
 end
 
-class Hash
-  include Kinda::Core::Hash
+class Hash #:nodoc:
+  include Kinda::Core::HashExtension
 end

data/lib/core/module.rb

@@ -1,8 +1,8 @@
 module Kinda
   module Core
-    module Module
+    module ModuleExtension
       def self.included(klass)
-        klass.alias_method_chain :append_features, :module_extensions
+        klass.alias_method_chain :append_features, :inheritable_extensions
       end
 
       def alias_method_chain(target, feature)
@@ -37,22 +37,34 @@ module Kinda
         singleton_class.ancestors.take_while { |mod| !mod.is_a?(Class) }
       end
 
-      def inheritable_extension(*mods)
-        (@inheritable_extensions ||= []).unshift(mods.reverse).flatten!.uniq!
+      def inheritable_extend(*mods, &block)
+        if block
+          mod = Module.new
+          mod.extend extensions
+          mod.module_eval(&block)
+          mods << mod
+        end
+        extend *mods
+        (@inheritable_extensions ||= []).unshift(*mods.reverse).uniq!
+        mod
       end
 
-      def append_features_with_module_extensions(target)
-        append_features_without_module_extensions(target)
+      def append_features_with_inheritable_extensions(target)
+        append_features_without_inheritable_extensions(target)
         if @inheritable_extensions
           target.extend *@inheritable_extensions
-          target.inheritable_extension *@inheritable_extensions.reverse
+          target.inheritable_extend *@inheritable_extensions.reverse
         end
       end
 
-      def delegate_to_class(source, target=source)
-        define_method(source) do |*args, &block|
-          singleton_class_eval do
-            send(target, *args, &block)
+      # delegate_to_class :singleton_method_added => :method_added
+      # delegate_to_class [:attr_reader, :attr_writer]
+      # delegate_to_class ClassMethods.instance_methods
+      def delegate_to_class(*sources)
+        sources, target = sources.first.first if sources.first.is_a?(Hash)
+        [*sources].flatten.each do |source|
+          define_method(source) do |*args, &block|
+            singleton_class_send(target || source, *args, &block)
           end
         end
       end
@@ -75,7 +87,7 @@ module Kinda
   end
 end
 
-class Module
-  include Kinda::Core::Module
+class Module #:nodoc:
+  include Kinda::Core::ModuleExtension
 end
 

data/lib/core/object.rb

@@ -1,6 +1,6 @@
 module Kinda
   module Core
-    module Object
+    module ObjectExtension
       def self.included(klass)
         klass.alias_method_chain :extend, :flexible_arguments
       end
@@ -17,6 +17,10 @@ module Kinda
         singleton_class.class_eval(&block)
       end
 
+      def singleton_class_send(method_name, *args, &block)
+        singleton_class_eval { send(method_name, *args, &block) }
+      end
+
       def to_class
         kind_of?(Module) ? self : singleton_class
       end
@@ -58,6 +62,6 @@ module Kinda
   end
 end
 
-class Object
-  include Kinda::Core::Object
+class Object #:nodoc:
+  include Kinda::Core::ObjectExtension
 end

data/lib/core/proc.rb

@@ -1,6 +1,6 @@
 module Kinda
   module Core
-    module Proc
+    module ProcExtension
       def call_with_this(this, *args, &block)
         binding_self = binding.eval('self')
         binding_self.push_this(this)
@@ -12,6 +12,6 @@ module Kinda
   end
 end
 
-class Proc
-  include Kinda::Core::Proc
+class Proc #:nodoc:
+  include Kinda::Core::ProcExtension
 end

data/lib/core/this.rb

@@ -57,6 +57,6 @@ module Kinda
   end
 end
 
-class Object
+class Object #:nodoc:
   include Kinda::Core::This
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: kinda-core
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors: 
 - Manuel Vila
@@ -22,7 +22,9 @@ extensions: []
 extra_rdoc_files: 
 - README.rdoc
 files: 
+- Rakefile
 - lib/core.rb
+- lib/kinda-core.rb
 - lib/core/accessor.rb
 - lib/core/forwardable.rb
 - lib/core/functor.rb
@@ -32,10 +34,10 @@ files:
 - lib/core/object.rb
 - lib/core/proc.rb
 - lib/core/this.rb
-- lib/kinda-core.rb
 - README.rdoc
 has_rdoc: true
 homepage: http://github.com/kinda/core
+licenses: 
 post_install_message: 
 rdoc_options: []
 
@@ -56,7 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: kinda-core
-rubygems_version: 1.2.0
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 2
 summary: Basic helpers used by other kinda projects