aduki 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.#*

data/.rspec

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

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in azuki.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 conanite
+
+MIT License
+
+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,80 @@
+# Aduki
+
+Aduki is an attribute setter inspired only a little bit by the "Bean" concept in Java. Here's the idea:
+
+    props = {
+      "name" => "Wilbur",
+      "size" => "3",
+      "gadgets[0].id"         => "FHB5S",
+      "gadgets[0].position.x" => "0.45",
+      "gadgets[0].position.y" => "0.97",
+      "gadgets[1].id"         => "SVE21",
+      "gadgets[1].position.x" => "0.31",
+      "gadgets[1].position.y" => "0.34",
+    }
+
+    model = Model.new props
+
+At this point, #model is an instance of Model with its #name, and #size properties initialized as you would expect, and its #gadgets is an array of length 2, with each object initialized as you would expect.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'aduki'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install aduki
+
+## Usage
+
+For a complete example, please see the spec. It's a single file.
+
+Here's an abbreviated version:
+
+    class Assembly
+      include Aduki::Initializer
+      attr_accessor :name, :colour, :size
+    end
+
+    class Machine
+      include Aduki::Initializer
+      attr_accessor :name, :weight, :speed, :builder, :team
+      attr_accessor :assemblies, :dimensions
+      aduki :assemblies => Assembly, :builder => MachineBuilder
+    end
+
+    class Model
+      include Aduki::Initializer
+
+      attr_accessor :name, :email, :item, :thing, :gadget
+      attr_accessor :machines, :contraptions, :countries
+      aduki :gadget => Gadget, :machines => Machine, :contraptions => Contraption
+    end
+
+
+Aduki::Initializer adds an #initialize instance method that knows how to read a hash of properties and apply them, much like ActiveRecord::Base,
+with one major difference: Aduki splits property names on "." and applies the hash recursively. Aduki also pays special attention to "[]" in property
+names, initializing an array of items instead of an item directly. Aduki uses the array index inside "[]" to distinguish elements, but not to order them.
+
+The #aduki class method allows you identify which types to initialise for each field. When a type is not specified for a field, aduki sets the given value directly.
+
+    aduki :gadget => Gadget, :machines => Machine, :contraptions => Contraption
+
+This line instructs aduki to initialise the #gadget field with a Gadget object. It also instructs aduki to initialize each element of the #machines
+array with a Machine object. Aduki decides to create an object or an array of objects depending on the attributes-hash contents, rather than on any
+metadata you may specify here.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/aduki.gemspec

@@ -0,0 +1,23 @@
+# -*- coding: utf-8; mode: ruby  -*-
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'aduki/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "aduki"
+  gem.version       = Aduki::VERSION
+  gem.authors       = ["Conan Dalton"]
+  gem.email         = ["conan@conandalton.net"]
+  gem.description   = %q{recursive attribute setting for ruby objects}
+  gem.summary       = %q{set object attributes recursively from an attributes hash}
+  gem.homepage      = "https://github.com/conanite/aduki"
+
+  gem.add_development_dependency 'rspec', '~> 2.9'
+
+  gem.files         = `git ls-files`.split($/)
+  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"]
+end

data/lib/aduki.rb

@@ -0,0 +1,62 @@
+require "aduki/version"
+
+module Aduki
+  def self.to_value klass, setter, value
+    type = klass.aduki_type_for_attribute_name setter
+    type ? type.new(value) : value
+  end
+
+  def self.apply_attributes object, attrs
+    setters = { }
+    klass = object.class
+
+    attrs.each do |setter, value|
+      if setter.match /\./
+        first, rest = setter.split(/\./, 2)
+        setters[first] ||= { }
+        setters[first][rest] = value
+      elsif setter.match /\[\d+\]/
+        setters[setter] = value
+      else
+        object.send "#{setter}=", value
+      end
+    end
+
+    setters.each do |setter, value|
+      if setter.match /\[\d+\]/
+        setter = setter.gsub /\[\d+\]/, ''
+        array = object.send setter.to_sym
+        if array == nil
+          array = []
+          object.send("#{setter}=", array)
+        end
+        array << to_value(klass, setter, value)
+      else
+        type = klass.aduki_type_for_attribute_name setter
+        object.send "#{setter}=", to_value(klass, setter, value)
+      end
+    end
+  end
+
+  module ClassMethods
+    @@types = { }
+
+    def aduki types
+      @@types[self] = types
+    end
+
+    def aduki_type_for_attribute_name name
+      @@types[self][name.to_sym]
+    end
+  end
+
+  module Initializer
+    def initialize attrs
+      Aduki.apply_attributes self, attrs
+    end
+
+    def self.included(base)
+      base.extend Aduki::ClassMethods
+    end
+  end
+end

data/lib/aduki/version.rb

@@ -0,0 +1,3 @@
+module Aduki
+  VERSION = "0.0.1"
+end

data/spec/initializer_spec.rb

@@ -0,0 +1,142 @@
+require "aduki"
+require "spec_helper"
+
+describe Aduki::Initializer do
+
+  it "should set a bunch of properties from a hash of property paths" do
+    props = {
+      "name"            => "Willy",
+      "email"           => "willy@wonka.softify.com",
+      "item"            => "HXB5H",
+      "thing"           => "0",
+      "gadget.name"     => "My Big Gadget",
+      "gadget.price"    => "21",
+      "gadget.supplier" => "Apple, Inc.",
+      "machines[0].name" => "The First Machine",
+      "machines[0].weight" => "88",
+      "machines[0].speed" => "142",
+      "machines[0].builder.name"   => "The First Machine Builder",
+      "machines[0].builder.email"  => "wibble@bump",
+      "machines[0].builder.phone"  => "4099",
+      "machines[0].builder.office" => "2nd floor room 12",
+      "machines[0].assemblies[0].name"   => "first machine, first assembly", # the array index distinguishes items but does not order them
+      "machines[0].assemblies[1].name"   => "first machine, second assembly",
+      "machines[0].assemblies[2].name"   => "first machine, third assembly",
+      "machines[0].assemblies[0].colour" => "red",
+      "machines[0].assemblies[1].colour" => "green",
+      "machines[0].assemblies[2].colour" => "blue",
+      "machines[0].assemblies[0].size"   => "pretty large",
+      "machines[0].assemblies[1].size"   => "sort of medium",
+      "machines[0].assemblies[2].size"   => "miniscule",
+      "machines[0].dimensions[0]"   => "2346.56",
+      "machines[0].dimensions[1]"   => "6456.64",
+      "machines[0].dimensions[2]"   => "3859.39",
+      "machines[0].dimensions[3]"   => "2365.68",
+      "machines[0].team.lead"       => "Shakespeare", # there is no class definition for #team, so Aduki will apply a hash with properties #lead, #code, #design
+      "machines[0].team.code"       => "Chaucer",
+      "machines[0].team.design"     => "Jobs",
+      "machines[1].name"           => "The Second Machine",
+      "machines[1].weight"         => "34",
+      "machines[1].speed"          => "289",
+      "machines[1].builder.name"   => "The Second Machine Builder",
+      "machines[1].builder.email"  => "waggie@bump",
+      "machines[1].builder.phone"  => "4101",
+      "machines[1].builder.office" => "3rd floor room 23",
+      "machines[1].assemblies[98].name"   => "second machine, first assembly",  # the array index distinguishes items but does not order them
+      "machines[1].assemblies[98].colour" => "purple",
+      "machines[1].assemblies[98].size"   => "pretty small",
+      "machines[1].assemblies[1].name"   => "second machine, second assembly",
+      "machines[1].assemblies[1].colour" => "turquoise",
+      "machines[1].assemblies[1].size"   => "large-ish",
+      "machines[1].assemblies[99].name"   => "second machine, third assembly",
+      "machines[1].assemblies[99].colour" => "magenta",
+      "machines[1].assemblies[99].size"   => "gigantic",
+      "machines[1].dimensions[20]"   => "1985.85",
+      "machines[1].dimensions[30]"   => "7234.92",
+      "machines[1].dimensions[40]"   => "9725.52",
+      "machines[1].dimensions[50]"   => "3579.79",
+      "machines[1].team.lead"       => "Joyce",
+      "machines[1].team.code"       => "O'Brien",
+      "machines[1].team.design"     => "Moore",
+      "machines[1].team.muffins"    => "MacNamara",
+      "contraptions[0].x"          => "19",
+      "contraptions[0].y"          => "0.003",
+      "contraptions[1].x"          => "12",
+      "contraptions[1].y"          => "0.0012",
+      "contraptions[2].x"          => "24",
+      "contraptions[2].y"          => "0.00063",
+      "contraptions[3].x"          => "16",
+      "contraptions[3].y"          => "0.00091",
+      "countries[0]"               => "France",
+      "countries[1]"               => "Sweden",
+      "countries[2]"               => "Germany",
+      "countries[3]"               => "Ireland",
+      "countries[4]"               => "Spain",
+    }
+
+    model = Model.new props
+
+    model.name.should == "Willy"
+    model.email.should == "willy@wonka.softify.com"
+    model.item.should == "HXB5H"
+    model.thing.should == "0"
+    model.gadget.name.should == "My Big Gadget"
+    model.gadget.price.should == "21"
+    model.gadget.supplier.should == "Apple, Inc."
+    model.machines[0].name.should == "The First Machine"
+    model.machines[0].weight.should == "88"
+    model.machines[0].speed.should == "142"
+    model.machines[0].builder.name.should == "The First Machine Builder"
+    model.machines[0].builder.email.should == "wibble@bump"
+    model.machines[0].builder.phone.should == "4099"
+    model.machines[0].builder.office.should == "2nd floor room 12"
+    model.machines[0].assemblies[0].name.should == "first machine, first assembly"
+    model.machines[0].assemblies[0].colour.should == "red"
+    model.machines[0].assemblies[0].size.should == "pretty large"
+    model.machines[0].assemblies[1].name.should == "first machine, second assembly"
+    model.machines[0].assemblies[1].colour.should == "green"
+    model.machines[0].assemblies[1].size.should == "sort of medium"
+    model.machines[0].assemblies[2].name.should == "first machine, third assembly"
+    model.machines[0].assemblies[2].colour.should == "blue"
+    model.machines[0].assemblies[2].size.should == "miniscule"
+    model.machines[0].dimensions[0].should == "2346.56"
+    model.machines[0].dimensions[1].should == "6456.64"
+    model.machines[0].dimensions[2].should == "3859.39"
+    model.machines[0].dimensions[3].should == "2365.68"
+    model.machines[0].team.should == { "lead" => "Shakespeare", "code" => "Chaucer", "design" => "Jobs"}
+    model.machines[1].name.should == "The Second Machine"
+    model.machines[1].weight.should == "34"
+    model.machines[1].speed.should == "289"
+    model.machines[1].builder.name.should == "The Second Machine Builder"
+    model.machines[1].builder.email.should == "waggie@bump"
+    model.machines[1].builder.phone.should == "4101"
+    model.machines[1].builder.office.should == "3rd floor room 23"
+    model.machines[1].assemblies[0].name.should == "second machine, first assembly"
+    model.machines[1].assemblies[0].colour.should == "purple"
+    model.machines[1].assemblies[0].size.should == "pretty small"
+    model.machines[1].assemblies[1].name.should == "second machine, second assembly"
+    model.machines[1].assemblies[1].colour.should == "turquoise"
+    model.machines[1].assemblies[1].size.should == "large-ish"
+    model.machines[1].assemblies[2].name.should == "second machine, third assembly"
+    model.machines[1].assemblies[2].colour.should == "magenta"
+    model.machines[1].assemblies[2].size.should == "gigantic"
+    model.machines[1].dimensions[0].should == "1985.85"
+    model.machines[1].dimensions[1].should == "7234.92"
+    model.machines[1].dimensions[2].should == "9725.52"
+    model.machines[1].dimensions[3].should == "3579.79"
+    model.machines[1].team.should == { "lead" => "Joyce", "code" => "O'Brien", "design" => "Moore", "muffins" => "MacNamara"}
+    model.contraptions[0].x.should == "19"
+    model.contraptions[0].y.should == "0.003"
+    model.contraptions[1].x.should == "12"
+    model.contraptions[1].y.should == "0.0012"
+    model.contraptions[2].x.should == "24"
+    model.contraptions[2].y.should == "0.00063"
+    model.contraptions[3].x.should == "16"
+    model.contraptions[3].y.should == "0.00091"
+    model.countries[0].should == "France"
+    model.countries[1].should == "Sweden"
+    model.countries[2].should == "Germany"
+    model.countries[3].should == "Ireland"
+    model.countries[4].should == "Spain"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,42 @@
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.order = 'random'
+end
+
+class Contraption
+  include Aduki::Initializer
+  attr_accessor :x, :y
+end
+
+class Assembly
+  include Aduki::Initializer
+  attr_accessor :name, :colour, :size
+end
+
+class MachineBuilder
+  include Aduki::Initializer
+  attr_accessor :name, :email, :phone, :office
+end
+
+class Gadget
+  include Aduki::Initializer
+  attr_accessor :name, :price, :supplier
+end
+
+class Machine
+  include Aduki::Initializer
+  attr_accessor :name, :weight, :speed, :builder, :team
+  attr_accessor :assemblies, :dimensions
+  aduki :assemblies => Assembly, :builder => MachineBuilder
+end
+
+class Model
+  include Aduki::Initializer
+
+  attr_accessor :name, :email, :item, :thing, :gadget
+  attr_accessor :machines, :contraptions, :countries
+  aduki :gadget => Gadget, :machines => Machine, :contraptions => Contraption
+end
+

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: aduki
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Conan Dalton
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+description: recursive attribute setting for ruby objects
+email:
+- conan@conandalton.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- aduki.gemspec
+- lib/aduki.rb
+- lib/aduki/version.rb
+- spec/initializer_spec.rb
+- spec/model.rb
+- spec/spec_helper.rb
+homepage: https://github.com/conanite/aduki
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: set object attributes recursively from an attributes hash
+test_files:
+- spec/initializer_spec.rb
+- spec/model.rb
+- spec/spec_helper.rb