toystore 0.5

data/.autotest

@@ -0,0 +1,11 @@
+require 'autotest/growl'
+
+Autotest.add_hook(:initialize) {|at|
+  at.add_exception %r{^\.git}  # ignore Version Control System
+  at.add_exception %r{^./tmp}  # ignore temp files, lest autotest will run again, and again...
+  #  at.clear_mappings         # take out the default (test/test*rb)
+  at.add_mapping(%r{^lib/.*\.rb$}) {|f, _|
+    Dir['spec/**/*.rb']
+  }
+  nil
+}

data/.bundle/config

@@ -0,0 +1,2 @@
+--- 
+BUNDLE_DISABLE_SHARED_GEMS: "1"

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+testing/
+.rvmrc
+log
+tmp
+pkg

data/Gemfile

@@ -0,0 +1,10 @@
+source :rubygems
+gemspec
+
+group(:development) do
+  gem 'rake',       '~> 0.8.7'
+  gem 'rspec',      '~> 2.3'
+  gem 'timecop',    '~> 0.3.5'
+  gem 'tzinfo',     '~> 0.3.23'
+  gem 'log_buddy',  '~> 0.5.0'
+end

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    toystore (0.5)
+      activemodel (~> 3.0.3)
+      activesupport (~> 3.0.3)
+      adapter (~> 0.5.1)
+      simple_uuid (~> 0.1.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activesupport (3.0.3)
+    adapter (0.5.1)
+    builder (2.1.2)
+    diff-lcs (1.1.2)
+    i18n (0.5.0)
+    log_buddy (0.5.0)
+    rake (0.8.7)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+    simple_uuid (0.1.1)
+    timecop (0.3.5)
+    tzinfo (0.3.23)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activemodel (~> 3.0.3)
+  activesupport (~> 3.0.3)
+  adapter (~> 0.5.1)
+  log_buddy (~> 0.5.0)
+  rake (~> 0.8.7)
+  rspec (~> 2.3)
+  simple_uuid (~> 0.1.1)
+  timecop (~> 0.3.5)
+  toystore!
+  tzinfo (~> 0.3.23)

data/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2011, Zynga Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of Zynga Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/LOGGING.rdoc

@@ -0,0 +1,16 @@
+What the 3 letter codes mean when they show up in logging:
+
+  SET: write to store
+  GET: read from store
+  DEL: delete from store
+  KEY: check if key exists in store
+
+  IMG: read from identity map
+  IMS: write to identity map
+  IMD: delete from identity map
+
+  RTG: get cache read
+  RTS: get cache set
+  WTS: cache write set
+
+  IEM: invalid embedded document

data/README.rdoc

@@ -0,0 +1,13 @@
+= Toystore
+
+An object mapper for anything that can read, write and delete data.
+
+See examples/models.rb for potential direction. The idea is that any key-value store (via adapters) that supports read, write, delete will work (memcache, membase, redis, couch, toyko. Potentially even RESTFUL services or sqlite with a single key-value table?)
+
+== Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so we don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine, but bump version in a commit by itself so we can ignore when we pull)
+* Send us a pull request. Bonus points for topic branches.

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+
+task :default => :spec

data/examples/memcached.rb

@@ -0,0 +1,20 @@
+require 'pp'
+require 'rubygems'
+require 'toystore'
+require 'adapter/memcached'
+
+class GameList
+  include Toy::Store
+  store :memcached, Memcached.new
+
+  attribute :source, Hash
+end
+
+list = GameList.create(:source => {'foo' => 'bar'})
+
+pp list
+pp GameList.get(list.id)
+
+list.destroy
+
+pp GameList.get(list.id)

data/examples/memory.rb

@@ -0,0 +1,20 @@
+require 'pp'
+require 'rubygems'
+require 'toystore'
+require 'adapter/memory'
+
+class User
+  include Toy::Store
+  store :memory, {}
+
+  attribute :name, String
+end
+
+user = User.create(:name => 'John')
+
+pp user
+pp User.get(user.id)
+
+user.destroy
+
+pp User.get(user.id)

data/examples/models.rb

@@ -0,0 +1,51 @@
+require 'pathname'
+
+root_path = Pathname(__FILE__).dirname.join('..').expand_path
+lib_path  = root_path.join('lib')
+$:.unshift(lib_path)
+
+require 'toy'
+require 'adapter/memory'
+
+class Address
+  include Toy::Store
+  store :memory, {}
+
+  attribute :city,  String
+  attribute :state, String
+  attribute :zip,   String
+
+  index :zip
+end
+
+class PhoneNumber
+  include Toy::Store
+
+  attribute :area_code, String
+  attribute :number,    String
+end
+
+class Company
+  include Toy::Store
+  store :memory, {}
+
+  attribute :name, String
+end
+
+class User
+  include Toy::Store
+  store :memory, {}
+
+  attribute :name,  String
+  attribute :age,   Integer
+  attribute :admin, Boolean, :default => false
+  attribute :ssn,   String
+  timestamps
+
+  index :ssn
+
+  list :addresses, :dependendent => true
+  reference :employer, Company
+
+  # validations and callbacks are available too
+end

data/examples/redis.rb

@@ -0,0 +1,20 @@
+require 'pp'
+require 'rubygems'
+require 'toystore'
+require 'adapter/redis'
+
+class User
+  include Toy::Store
+  store :redis, Redis.new
+
+  attribute :name, String
+end
+
+user = User.create(:name => 'John')
+
+pp user
+pp User.get(user.id)
+
+user.destroy
+
+pp User.get(user.id)

data/lib/toy.rb

@@ -0,0 +1,81 @@
+require 'set'
+require 'pathname'
+require 'forwardable'
+require 'digest/sha1'
+
+root_path = Pathname(__FILE__).dirname.join('..').expand_path
+
+require 'adapter'
+require 'simple_uuid'
+require 'active_model'
+require 'active_support/json'
+require 'active_support/core_ext/object'
+require 'active_support/core_ext/hash/indifferent_access'
+require 'active_support/core_ext/hash/keys'
+require 'active_support/core_ext/class/inheritable_attributes'
+require 'active_support/core_ext/string/conversions'
+require 'active_support/core_ext/string/inflections'
+
+extensions_path = root_path.join('lib', 'toy', 'extensions')
+Dir[extensions_path + '**/*.rb'].each { |file| require(file) }
+
+module Toy
+  extend self
+
+  # Resets all tracking of things in memory. Useful for running
+  # before each request in development mode with Rails and such.
+  def reset
+    identity_map.clear
+    plugins.clear
+    models.clear
+  end
+
+  # Clears all the stores for all the models. Useful in specs/tests/etc.
+  # Do not use in production, harty harr harr.
+  #
+  # Note: that if your models are auto-loaded like in Rails, you will need
+  # to make sure they are loaded in order to clear them or ToyStore will
+  # not be aware of their existence.
+  def clear
+    models.each do |model|
+      model.store.clear         if model.has_store?
+      model.cache.clear         if model.has_cache?
+      model.identity_map.clear  if model.identity_map_on?
+    end
+  end
+end
+
+require 'toy/exceptions'
+require 'toy/connection'
+require 'toy/attribute'
+require 'toy/attributes'
+require 'toy/callbacks'
+require 'toy/dirty'
+require 'toy/dolly'
+require 'toy/equality'
+require 'toy/inspect'
+require 'toy/persistence'
+require 'toy/mass_assignment_security'
+require 'toy/plugins'
+require 'toy/store'
+require 'toy/serialization'
+require 'toy/timestamps'
+require 'toy/validations'
+require 'toy/querying'
+require 'toy/identity_map'
+
+require 'toy/collection'
+require 'toy/embedded_list'
+require 'toy/embedded_lists'
+require 'toy/list'
+require 'toy/lists'
+require 'toy/reference'
+require 'toy/references'
+
+require 'toy/index'
+require 'toy/indices'
+require 'toy/identity/abstract_key_factory'
+require 'toy/identity/uuid_key_factory'
+require 'toy/identity'
+require 'toy/caching'
+require 'toy/logger'

data/lib/toy/attribute.rb

@@ -0,0 +1,73 @@
+module Toy
+  class Attribute
+    attr_reader :model, :name, :type, :options
+
+    def initialize(model, name, type, options={})
+      options.assert_valid_keys(:default, :embedded_list, :virtual, :abbr)
+
+      @model, @name, @type, @options = model, name.to_sym, type, options
+      @virtual = options.fetch(:virtual, false)
+
+      if abbr?
+        options[:abbr] = abbr.to_sym
+        model.alias_attribute(abbr, name)
+      end
+
+      model.attributes[name.to_s] = self
+    end
+
+    def from_store(value)
+      value = default if default? && value.nil?
+      type.from_store(value, self)
+    end
+
+    def to_store(value)
+      value = default if default? && value.nil?
+      type.to_store(value, self)
+    end
+
+    def default
+      if options.key?(:default)
+        options[:default].respond_to?(:call) ? options[:default].call : options[:default]
+      else
+        type.respond_to?(:store_default) ? type.store_default : nil
+      end
+    end
+
+    def default?
+      options.key?(:default) || type.respond_to?(:store_default)
+    end
+
+    def virtual?
+      @virtual
+    end
+
+    def persisted?
+      !virtual?
+    end
+
+    def abbr?
+      options.key?(:abbr)
+    end
+
+    def abbr
+      options[:abbr]
+    end
+
+    def store_key
+      (abbr? ? abbr : name).to_s
+    end
+
+    # Stores reference to related embedded list
+    def embedded_list
+      options[:embedded_list]
+    end
+
+    def eql?(other)
+      self.class.eql?(other.class) &&
+        model == other.model &&
+        name  == other.name
+    end
+    alias :== :eql?
+  end
+end

data/lib/toy/attributes.rb

@@ -0,0 +1,137 @@
+module Toy
+  module Attributes
+    extend ActiveSupport::Concern
+    include ActiveModel::AttributeMethods
+
+    included do
+      attribute_method_suffix('', '=', '?')
+      attribute :id, String
+    end
+
+    module ClassMethods
+      def attributes
+        @attributes ||= {}
+      end
+
+      def defaulted_attributes
+        attributes.values.select(&:default?)
+      end
+
+      def attribute(key, type, options = {})
+        Attribute.new(self, key, type, options)
+      end
+
+      def attribute?(key)
+        attributes.has_key?(key.to_s)
+      end
+    end
+
+    module InstanceMethods
+      def initialize(attrs={})
+        @_new_record = true unless defined?(@_new_record)
+        initialize_attributes_with_defaults
+        self.attributes = attrs
+        write_attribute :id, self.class.next_key(self) unless id?
+      end
+
+      def initialize_from_database(attrs={})
+        @_new_record = false
+        send(:initialize, attrs)
+        self
+      end
+
+      def reload
+        if attrs = store.read(store_key)
+          instance_variables.each        { |ivar| instance_variable_set(ivar, nil) }
+          initialize_attributes_with_defaults
+          self.attributes = attrs
+          self.class.lists.each_key      { |name| send(name).reset }
+          self.class.references.each_key { |name| send(name).reset }
+        else
+          raise NotFound.new(id)
+        end
+        self
+      end
+
+      def id
+        read_attribute(:id)
+      end
+
+      def attributes
+        @attributes
+      end
+
+      def persisted_attributes
+        {}.tap do |attrs|
+          self.class.attributes.each do |name, attribute|
+            next if attribute.virtual?
+            attrs[attribute.store_key] = attribute.to_store(read_attribute(attribute.name))
+          end
+        end.merge(embedded_attributes)
+      end
+
+      def embedded_attributes
+        {}.tap do |attrs|
+          self.class.embedded_lists.each_key do |name|
+            attrs[name.to_s] = send(name).map(&:persisted_attributes)
+          end
+        end
+      end
+
+      def attributes=(attrs)
+        return if attrs.nil?
+        attrs.each do |key, value|
+          if attribute_method?(key)
+            write_attribute(key, value)
+          elsif respond_to?("#{key}=")
+            send("#{key}=", value)
+          end
+        end
+      end
+
+      def [](key)
+        read_attribute(key)
+      end
+
+      def []=(key, value)
+        write_attribute(key, value)
+      end
+
+      private
+        def read_attribute(key)
+          @attributes[key]
+        end
+
+        def write_attribute(key, value)
+          @attributes[key] = attribute_definition(key).try(:from_store, value)
+        end
+
+        def attribute_definition(key)
+          self.class.attributes[key.to_s]
+        end
+
+        def attribute_method?(key)
+          self.class.attribute?(key)
+        end
+
+        def attribute(key)
+          read_attribute(key)
+        end
+
+        def attribute=(key, value)
+          write_attribute(key, value)
+        end
+
+        def attribute?(key)
+          read_attribute(key).present?
+        end
+
+        def initialize_attributes_with_defaults
+          @attributes = {}.with_indifferent_access
+          self.class.defaulted_attributes.each do |attribute|
+            @attributes[attribute.name] = attribute.default
+          end
+        end
+    end
+  end
+end