inheritable_accessors 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8d2efb20dc919b54c78e3c2bec2b2d4a50c14606
-  data.tar.gz: ed4f8a39aee354cd65a3d3d4e2e20e7bdca79871
+  metadata.gz: 887a141cf629f263b1d5d359f1b6af90cc4babc3
+  data.tar.gz: 59d0fbd8c834134eef28fbe8dc351175cb8c9d4d
 SHA512:
-  metadata.gz: 59e264c5d8bcdcc8e6031ef4f4fdb193517bd94baeeefef5f99102ed0d1fb15e7c2c4edb3a239e941adb91f46fb8c5e4c59c9a1c4fd6c4542bca294570ec6b73
-  data.tar.gz: 5e7a73237ebc94c62073b9ead680008c4edceacf00cf7eb36678d61bd2327d75e57c15d9cc14c556d98c3e816d72453c14d6378b3293a64eac2c3f2b1696f631
+  metadata.gz: ab916ece20a1de9df4a889deb1ef26a85a9fb968abdc8b3d7fc92005783da5e023f565367b1506c529017ecfd0b77fa69ffc2448cc2888eec837f87d2b067b75
+  data.tar.gz: 12a193b47d6aae6d9c26c6de548685b260469057f20e083d26c576ff696c3833c5ab2e18f7e165f03d9ff9d63451335768619fff6bf52829dc6af0860e22aa6e

data/.rspec

@@ -1,2 +1,2 @@
---format documentation
+--format progress
 --color

data/.travis.yml

@@ -1,3 +1,8 @@
 language: ruby
+bundler_args: --without development
+before_install: gem install bundler --version=1.8.2
 rvm:
+  - 2.0.0
   - 2.1.0
+notifications:
+  email: false

data/Gemfile

@@ -1,4 +1,19 @@
 source 'https://rubygems.org'
 
+group :development do
+  gem "byebug"
+end
+
+group :development, :test do
+  gem "bundler",              "~> 1.8"
+  gem "rake",                 "~> 10.0"
+end
+
+group :test do
+  gem "rspec",                "~> 3.2"
+end
+
+
+
 # Specify your gem's dependencies in inheritable-accessors.gemspec
 gemspec

data/README.md

@@ -1,15 +1,76 @@
-# InheritableAccessors
+# InheritableAccessors [![Build Status](https://travis-ci.org/blakechambers/inheritable-accessors.svg)](https://travis-ci.org/blakechambers/inheritable-accessors)
 
-Easily and consistently inherit attributes and configurations.  This is particularly designed to work well with Rspec, which creates new inherited classes during each context.  More examples of usage coming soon.
+Easily and consistently inherit attributes and configurations.  This is particularly designed to work well with Rspec, which creates new inherited classes during each context.
 
-## Planned features
+## Usage
+
+Inheritable accessors comes with 3 inheritable components that can be used:
+an iheritable hash, set, and option accessor.
+
+### InheritableHashAccessor
+
+```ruby
+class Parent
+  include InheritableAccessors::InheritableHashAccessor
+
+  inheritable_hash_accessor :options
+
+  options[:a] = 1
+end
+
+class Child < Parent
+  options[:b] = 2
+end
+
+item = Child.new
+
+# deleted items do not affect parent items
+item.delete(:a)
+item.options[:c] = 3
+
+Parent.options.to_hash
+#=> {a: 1})
+Child.options.to_hash
+#=> {a: 1, b: 1})
+item.options.to_hash
+#=> {b: 2, c: 3})
+```
+
+### InheritableOptionAccessor
 
-- inheritable\_hash
-  - [x] support addition
-  - [ ] support delete/clear/reject
-- inheritable\_set
-  - [x] support addition
-  - [ ] support deletion
+```ruby
+class MyRequest
+  include InheritableAccessors::InheritableHashAccessor
+  include InheritableAccessors::InheritableOptionAccessor
+
+  inheritable_hash_accessor   :request_opts
+  inheritable_option_accessor :path, :action, :params, for: :request_opts
+
+  # passing an argument to the accessor will "set" that value.
+  action "GET"
+
+  action # => "GET"
+
+  # passing a block will use the value of the block, but *only* when it is
+  # called.  Block values will be memoized after the first run.
+  path { secret_path }
+
+  protected
+
+  def secret_path
+    "/secret_path"
+  end
+
+end
+
+
+request = MyRequest.new
+request.path # => "/secret_path"
+request.path "/other_path"
+request.path # => "/other_path"
+
+
+```
 
 ## Installation
 

data/inheritable_accessors.gemspec

@@ -9,10 +9,6 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Blake Chambers"]
   spec.email         = ["chambb1@gmail.com"]
 
-  # if spec.respond_to?(:metadata)
-  #   spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com' to prevent pushes to rubygems.org, or delete to allow pushes to any server."
-  # end
-
   spec.summary       = %q{inheritable accessors}
   spec.description   = %q{inheritable accessors}
   spec.homepage      = "http://github.com/blakechambers/inheritable_accessors"
@@ -23,9 +19,5 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "activesupport", ">= 3.2.0"
-
-  spec.add_development_dependency "bundler", "~> 1.8"
-  spec.add_development_dependency "rake",    "~> 10.0"
-  spec.add_development_dependency "rspec",   "~> 3.0"
+  spec.add_runtime_dependency "activesupport", ">= 3.2.0"
 end

data/lib/inheritable_accessors.rb

@@ -4,6 +4,7 @@ require "inheritable_accessors/inheritable_hash"
 require "inheritable_accessors/inheritable_hash_accessor"
 require "inheritable_accessors/inheritable_set"
 require "inheritable_accessors/inheritable_set_accessor"
+require "inheritable_accessors/inheritable_option_accessor"
 
 module InheritableAccessors
   extend ActiveSupport::Concern

data/lib/inheritable_accessors/inheritable_hash.rb

@@ -1,15 +1,21 @@
 require 'forwardable'
+require 'set'
 
 module InheritableAccessors
   class InheritableHash
     attr_accessor :__local_values__
     attr_reader   :__parent__
+    attr_reader   :__deleted_keys__
     extend Forwardable
 
     WRITE_METHODS = %w{
       []= initialize merge! store
     }
 
+    DELETE_METHODS = %w{
+      delete
+    }
+
     READ_METHODS = %w{
       == [] each each_pair each_value empty? eql? fetch flatten
       has_key? has_value? hash include? index inspect invert key key? keys
@@ -22,11 +28,21 @@ module InheritableAccessors
     def initialize(prototype=nil)
       @__local_values__ = Hash.new
       @__parent__ = prototype
+      @__deleted_keys__ = prototype ? prototype.__deleted_keys__.dup : Set.new
+    end
+
+    def delete(key)
+      @__deleted_keys__.merge [key]
+      __local_values__.delete(key)
     end
 
     def to_hash
       if !!__parent__
-        __parent__.to_hash.merge(__local_values__)
+        hash = __parent__.to_hash
+        hash.delete_if do |key, _|
+          __deleted_keys__.include?(key)
+        end
+        hash.merge(__local_values__)
       else
         __local_values__.clone
       end
@@ -38,4 +54,4 @@ module InheritableAccessors
 
     alias :initialize_copy :inherit_copy
   end
-end
+end

data/lib/inheritable_accessors/inheritable_option_accessor.rb

@@ -0,0 +1,58 @@
+module InheritableAccessors
+  module InheritableOptionAccessor
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+      def inheritable_option_accessor(*names)
+        options = names.pop if names.last.kind_of?(Hash)
+
+        opts_location = options[:for].to_s
+        unless respond_to?(opts_location) && send(opts_location).kind_of?(InheritableAccessors::InheritableHash)
+          raise ArgumentError, 'requires for: to be kind of InheritableHashAccessor'
+        end
+
+        names.each do |name|
+          name = name.to_s
+
+          module_eval <<-METHUD, __FILE__, __LINE__
+            def #{name}(new_val=nil, &block)
+              InheritableAccessors::InheritableOptionAccessor.__inheritable_option(self, #{opts_location}, :#{name}, new_val, &block)
+            end
+
+            def self.#{name}(new_val=nil, &block)
+              InheritableAccessors::InheritableOptionAccessor.__inheritable_option(self, #{opts_location}, :#{name}, new_val, &block)
+            end
+          METHUD
+        end
+
+      end
+
+    end
+
+    class LetOption
+      attr_reader :block
+
+      def initialize(block)
+        @block = block
+        @memoized = {}
+      end
+
+      def with_context(context)
+        @memoized[context] ||= begin
+          context.instance_exec(&block)
+        end
+      end
+    end
+
+    def self.__inheritable_option(context, options_hash, name, value, &block)
+      if value
+        options_hash[name] = value
+      elsif block_given?
+        options_hash[name] = InheritableOptionAccessor::LetOption.new(block)
+      else
+        options_hash[name].instance_of?(InheritableOptionAccessor::LetOption) ? options_hash[name].with_context(context) : options_hash[name]
+      end
+    end
+
+  end
+end

data/lib/inheritable_accessors/version.rb

@@ -1,3 +1,3 @@
 module InheritableAccessors
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inheritable_accessors
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Blake Chambers
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-03-15 00:00:00.000000000 Z
+date: 2015-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -17,55 +17,13 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.0
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.0
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 description: inheritable accessors
 email:
 - chambb1@gmail.com
@@ -87,6 +45,7 @@ files:
 - lib/inheritable_accessors.rb
 - lib/inheritable_accessors/inheritable_hash.rb
 - lib/inheritable_accessors/inheritable_hash_accessor.rb
+- lib/inheritable_accessors/inheritable_option_accessor.rb
 - lib/inheritable_accessors/inheritable_set.rb
 - lib/inheritable_accessors/inheritable_set_accessor.rb
 - lib/inheritable_accessors/version.rb
@@ -110,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.4.3
 signing_key: 
 specification_version: 4
 summary: inheritable accessors