singleton_attr 1.0.0

data/README.md

@@ -0,0 +1,44 @@
+# Singleton Attributes #
+
+http://rubygems.org/gems/singleton_attr
+
+# Summary #
+
+Adds methods to declare attribute accessor/reader/writer on singleton instance.
+
+# Description #
+
+Provides :singleton_attr_accessor, :singleton_attr_reader, :singleton_attr_writer, :module_attr_accessor, :module_attr_reader, :module_attr_writer, :class_attr_accessor, :class_attr_reader, :class_attr_writer.
+
+# Install #
+
+* sudo gem install singleton_attr
+
+# Usage #
+
+Just like :attr_accessor, :attr_reader, :attr_writer but instead of defining an instance method it defines a class/module method.
+
+# License #
+
+  (The MIT License)
+
+  Copyright (c) 2013 Ridiculous Power, Asher
+
+  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/lib/singleton_attr.rb

@@ -0,0 +1,110 @@
+
+###
+# Adds methods to declare attribute accessors/readers/writers on singletons. 
+#
+module ::SingletonAttr
+  
+  #############################
+  #  singleton_attr_accessor  #
+  #############################
+  
+  ###
+  # Define an attribute accessor on the singleton of instance for which method is called.
+  #
+  # @overload singleton_attr_accessor( name, ... )
+  #
+  #   @param [Symbol,String] name
+  #
+  #                          Name for reader method.
+  # 
+  # @return [Module,Class] Self.
+  #
+  def singleton_attr_accessor( *names )
+    
+    singleton_class.instance_eval { attr_accessor *names }
+    
+    return self
+    
+  end
+
+  ###########################
+  #  singleton_attr_reader  #
+  ###########################
+  
+  ###
+  # Define an attribute reader on the singleton of instance for which method is called.
+  #
+  # @overload singleton_attr_reader( name, ... )
+  #
+  #   @param [Symbol,String] name
+  #
+  #                          Name for reader method.
+  # 
+  # @return [Module,Class] Self.
+  #
+  def singleton_attr_reader( *names )
+
+    singleton_class.instance_eval { attr_reader *names }
+    
+    return self
+
+  end
+
+  ###########################
+  #  singleton_attr_writer  #
+  ###########################
+  
+  ###
+  # Define an attribute writer on the singleton of instance for which method is called.
+  #
+  # @overload singleton_attr_writer( name, ... )
+  #
+  #   @param [Symbol,String] name
+  #
+  #                          Name for reader method.
+  # 
+  # @return [Module,Class] Self.
+  #
+  def singleton_attr_writer( *names )
+
+    singleton_class.instance_eval { attr_writer *names }
+    
+    return self
+
+  end
+  
+end
+
+###
+# Add aliases to substitute module prefix for singleton prefix. 
+#
+module ::SingletonAttr::Module
+  
+  include ::SingletonAttr
+  
+  alias_method :module_attr_accessor, :singleton_attr_accessor
+  alias_method :module_attr_reader,   :singleton_attr_reader
+  alias_method :module_attr_writer,   :singleton_attr_writer
+  
+end
+
+###
+# Add aliases to substitute class prefix for singleton prefix. 
+#
+module ::SingletonAttr::Class
+
+  include ::SingletonAttr
+  
+  alias_method :class_attr_accessor, :singleton_attr_accessor
+  alias_method :class_attr_reader,   :singleton_attr_reader
+  alias_method :class_attr_writer,   :singleton_attr_writer
+
+end
+
+class ::Module
+  include ::SingletonAttr::Module
+end
+
+class ::Class
+  include ::SingletonAttr::Class
+end

data/spec/singleton_attr_spec.rb

@@ -0,0 +1,57 @@
+
+require_relative '../lib/singleton_attr.rb'
+
+describe ::SingletonAttr do
+  
+  shared_examples_for :singleton do
+    it '#singleton_attr_accessor declares attr_accessor on singleton' do
+      instance.singleton_attr_accessor :accessor
+      instance.accessor.should be nil
+      instance.accessor = :value
+      instance.accessor.should be :value
+    end
+    it '#singleton_attr_reader declares attr_reader on singleton' do
+      instance.singleton_attr_reader :reader
+      instance.reader.should be nil
+      instance.instance_variable_set( :@reader, :value )
+      instance.reader.should be :value
+      instance.respond_to?( :reader= ).should be false
+    end
+    it '#singleton_attr_writer declares attr_writer on singleton' do
+      instance.singleton_attr_writer :writer
+      instance.instance_variable_get( :@writer ).should be nil
+      instance.writer = :value
+      instance.instance_variable_get( :@writer ).should be :value
+      instance.respond_to?( :writer ).should be false
+    end
+  end
+
+  context 'Module' do
+    let( :instance ) { ::Module.new }
+    it_behaves_like :singleton
+    it 'aliases #singleton_attr_accessor to #module_attr_accessor' do
+      instance.method( :module_attr_accessor ).should == instance.method( :singleton_attr_accessor )
+    end
+    it 'aliases #singleton_attr_reader to #module_attr_reader' do
+      instance.method( :module_attr_reader ).should == instance.method( :singleton_attr_reader )
+    end
+    it 'aliases #singleton_attr_writer to #module_attr_writer' do
+      instance.method( :module_attr_writer ).should == instance.method( :singleton_attr_writer )
+    end
+  end
+
+  context 'Class' do
+    let( :instance ) { ::Class.new }
+    it_behaves_like :singleton
+    it 'aliases #singleton_attr_accessor to #class_attr_accessor' do
+      instance.method( :module_attr_accessor ).should == instance.method( :singleton_attr_accessor )
+    end
+    it 'aliases #singleton_attr_reader to #class_attr_reader' do
+      instance.method( :class_attr_reader ).should == instance.method( :singleton_attr_reader )
+    end
+    it 'aliases #singleton_attr_writer to #class_attr_writer' do
+      instance.method( :class_attr_writer ).should == instance.method( :singleton_attr_writer )
+    end
+  end
+  
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: singleton_attr
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Asher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-29 00:00:00.000000000 Z
+dependencies: []
+description: Provides :singleton_attr_accessor, :singleton_attr_reader, :singleton_attr_writer,
+  :module_attr_accessor, :module_attr_reader, :module_attr_writer, :class_attr_accessor,
+  :class_attr_reader, :class_attr_writer.
+email: asher@ridiculouspower.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/singleton_attr.rb
+- spec/singleton_attr_spec.rb
+- README.md
+homepage: http://rubygems.org/gems/singleton_attr
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: singleton_attr
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Adds methods to declare attribute accessor/reader/writer on singleton instance.
+test_files: []
+has_rdoc: