sam-dm-core 0.9.6

data/.autotest

@@ -0,0 +1,26 @@
+Autotest.add_hook :initialize do |at|
+  ignore = %w[ .git burn www log plugins script tasks bin CHANGELOG FAQ MIT-LICENSE PERFORMANCE QUICKLINKS README ]
+
+  unless ENV['AUTOTEST'] == 'integration'
+    ignore << 'spec/integration'
+  end
+
+  ignore.each do |exception|
+    at.add_exception(exception)
+  end
+
+  at.clear_mappings
+
+  at.add_mapping(%r{^spec/.+_spec\.rb$}) do |filename,_|
+    filename
+  end
+
+  at.add_mapping(%r{^lib/data_mapper/(.+)\.rb$}) do |_,match|
+    [ "spec/unit/#{match[1]}_spec.rb" ] +
+    at.files_matching(%r{^spec/integration/.+_spec\.rb$})
+  end
+
+  at.add_mapping(%r{^spec/spec_helper\.rb$}) do
+    at.files_matching(%r{^spec/.+_spec\.rb$})
+  end
+end

data/CONTRIBUTING

@@ -0,0 +1,51 @@
+# NOTE: This is a work in progress. As of July 24, it applies only to dm-core.
+
+# Contributing to Edge DataMapper
+
+We have now implemented Hoe throughout the DataMapper suite, so there will be a 
+handful of new procedures for contributing to our git repositories. I'll give 
+you a run through of how to set up your machine, and then provide a few 
+commands that should be run before committing or pushing changes.
+
+## Installing and configuring Hoe
+
+The first step is to install hoe. You'll need at least version 1.7.0.
+
+    (sudo) gem install hoe --include-dependencies
+    
+Now you'll need to configure hoe. You'll need to run this from inside of 
+dm-core, or one of the other DataMapper projects.
+
+    rake config_hoe
+    
+The only thing you should need to change is the exclude regular expression, 
+which needs to look like this:
+
+    exclude: !ruby/regexp /tmp$|CVS|\.svn|\.git|.+\.gemspec/
+    
+Now you have the correct setup for contributing.
+
+## Before committing changes
+
+Before you commit changes, you must verify that `Manifest.txt` (the file which 
+contains the names of every file to be included in a gem release) and 
+`[project-name].gemspec` are up to date. We have create a rake task to make 
+this easy:
+
+    rake gemspec
+    
+This will check `Manifest.txt` (using Hoe's `rake check_manifest`) to ensure 
+there are no differences between the files in the project, and those listed in 
+the manifest. If there is a difference, it will display a warning and a list of 
+the differences in `diff` format.
+
+If the changes in the diff are correct, then you can run the following command 
+to update the manifest.
+
+    rake check_manifest | patch
+    
+If there are files you do not want added to the manifest, then you should 
+remove the files from the project, and then run `rake gemspec` again.
+
+If `rake gemspec` says it was successful, then you can proceed with committing 
+and pushing your changes.

data/FAQ

@@ -0,0 +1,92 @@
+:include:QUICKLINKS
+
+= FAQ
+
+=== So where's my :id column?
+
+DataMapper will NOT create an auto-incrementing <tt>:id</tt> key for you 
+automatically, so you'll need to either explicitly create one with
+
+  property :id, Serial
+
+You can choose to use a natural key by doing
+
+  property :slug, String, :key => true
+
+Remember, DataMapper supports multiple keys ("composite keys"), so if your
+model has two or more keys, no big deal
+
+  property :store_id, 	Integer, :key => true
+  property :invoice_id, Integer, :key => true
+
+=== How do I make a model paranoid?
+
+Create a property and make it a ParanoidDateTime or ParanoidBoolean type.
+
+  property :deleted_at, ParanoidDateTime
+  property :deleted, ParanoidBoolean
+
+All of your calls to <tt>##all()</tt>, <tt>##first()</tt> will be scoped 
+with <tt>:deleted_at => nil</tt> or <tt>:deleted => false</tt>. Plus, 
+you won't see deleted objects in your associations.
+
+=== Does DataMapper do Single Table Inheritance?
+
+This is what the Discriminator data-type is for:
+
+  class Person
+    include DataMapper::Resource
+    property :id, Serial
+    property :type, Discriminator ## other shared properties here
+  end
+
+  class Salesperson < Person; end
+
+You can claim a column to have the type <tt>Discriminator</tt> and DataMapper will
+automatically drop the class name of the inherited classes into that field of
+the data-store.
+
+=== How do I run my own commands?
+
+  repository.adapter.query("select * from users where clue > 0")
+  repository(:integration).adapter.query("select * from users where clue > 0")
+
+This does not return any Users (har har), but rather Struct's that will quack
+like Users. They'll be read-only as well.
+
+<tt>repository.adapter.query</tt> shouldn't be used if you aren't expecting a result set
+back.  If you want to just execute something against the database, use
+<tt>repository.adapter.execute</tt> instead.
+
+
+=== Can I get an query log of what DataMapper is issuing?
+
+An example of how to modify an existing logger:
+
+  DataMapper.logger.set_log(STDOUT, :debug)
+
+An example of how to create new logger:
+
+  DataMapper::Logger.new(STDOUT, :info)
+
+To send a message to the DataMapper logger:
+
+  DataMapper.logger.debug("something")
+  DataMapper.logger.info ("something")
+  DataMapper.logger.warn ("something")
+  DataMapper.logger.error("something")
+  DataMapper.logger.fatal("something")
+
+
+=== I want to run the specs, but I have a custom database setup
+
+For example, if you installed MySQL using MacPorts, your socket may be located
+at /opt/local/var/run/mysql5/mysqld.sock instead of /tmp/mysql.sock
+
+In that case, setup an environment variable in your shell before running the
+specs:
+  export MYSQL_SPEC_URI="mysql://localhost/dm_core_test?socket=/opt/local/var/run/mysql5/mysqld.sock"
+  rake spec
+
+Using another kind of database? Note that spec_helper.rb will also look for
+SQLITE3_SPEC_URI AND POSTGRES_SPEC_URI.

data/History.txt

@@ -0,0 +1,145 @@
+
+== 0.3.0
+* HasManyAssociation::Set now has a nil? method, so we can do stuff like cage.animal.nil?
+
+== 0.2.5
+* has_one bugfixes
+* Added syntax for setting CHECK-constraints directly in your properties (Postgres)
+* You can now set indexes with :index => true and :index => :unique
+* Support for composite indexes (thanks to Jeffrey Gelens)
+* Add composite scope to validates_uniqueness
+* Added private/protected properties
+* Remove HasOneAssociation, Make HasManyAssociation impersonate has_one relationships
+* Added #get method
+* Persistence module added, inheriting from DataMapper::Base no longer necessary
+
+== 0.2.4
+* Bug fixes
+* Added paranoia
+
+== 0.2.3
+* Added String#t for translation and overrides for default validation messages
+* Give credit where it's due: zapnap, not pimpmaster, submitted the String#blank? patch. My bad. :-(
+* MAJOR: Resolve issue with non-unique-hash values and #dirty?; now frozen original values are stored instead
+* Added Base#update_attributes
+* MAJOR: Queries are now passed to the database drivers in a parameterized fashion
+* Updated PostgreSQL driver and adapter to current
+
+== 0.2.2
+* Removed C extension bundles and log files from package
+
+== 0.2.1
+* Added :float column support
+* Added association proxies: ie: Zoo.first.exhibits.animals
+* Columns stored in SortedSet
+* Swig files are no longer RDOCed
+* Added :date column support
+* BUG: Fixed UTC issues with datetimes
+* Added #to_yaml method
+* Added #to_xml method
+* Added #to_json method
+* BUG: Fixed HasManyAssociation::Set#inspect
+* BUG: Fixed #reload!
+* BUG: Column copy for STI moved into Table#initialize to better handle STI with multiple mapped databases
+* BUG: before_create callbacks moved in the execution flow since they weren't guaranteed to fire before
+* Threading enhancements: Removed single_threaded_mode, #database block form adjusted for thread-safety
+* BUG: Fixed String#blank? when a multi-line string contained a blank line (thanks zapnap!)
+* Performance enhancements: (thanks wycats!)
+
+== 0.2.0
+* AdvancedHasManyAssociation now functional for fetches
+* AdvancedHasManyAssociation renamed to HasNAssociation
+* HasManyAssociation refactored to use HasNAssociation superclass
+* Slight spec tweaks to accomodate the updates
+* HasOneAssociation refactored to use HasNAssociation superclass
+* Added HasAndBelongsToManyAssociation, using HasNAssociation as a basis; Need to add corresponding SQL generation code in AdvancedLoadCommand
+* Added spec for habtm query generation
+* HasNAssociation#foreign_key returns a DataMapper::Adapters::Sql::Mappings::Column instance instead of a raw String now
+* Added table, association, association_table and to_sql methods to HasNAssociation
+* Added associations_spec.rb
+* Added a forced table-recreation to spec_helper.rb so the tests could run with a clean version of the database, including any new columns added to the models
+* Added HasAndBelongsToManyAssociation#to_sql (all current specs pass now!)
+* Minor tweaks to Callbacks
+* Added CallbacksHelper to declare class-method ::callbacks on DataMapper::Base
+* Implemented before_validate and after_validate hooks in ValidationHelper
+* Minor documentation additions in callbacks.rb
+* Added callbacks_spec
+* Moved class-method declarations for built-in callbacks to the callbacks helper instead of DataMapper::Base
+* Renamed :before/after_validate callback to :before/after_validation to match ActiveRecord
+* Callbacks#add now accepts a Symbol which maps a callback to a method call on the targetted instance, also added a spec to verify this behavior
+* Documented callbacks.rb
+* Added DataMapper::Associations::Reference class
+* Documented DataMapper::Associations::Reference class
+* Upgraded BelongsToAssociation to new style
+* Added AssociationsSet to handle simple "last-in" for association bindings
+* Fixed extra spec loading
+* Added *Association#columns
+* Some refactoring in AdvancedLoadCommand regarding :include options
+* Added support for class-less Mappings::Table instances, with just a string name
+* HasAndBelongsToManyAssociation#join_table #left_foreign_key and #right_foreign_key reference actual Table or Column objects now
+* Added :shallow_include option for HABTM joins in AdvancedLoadCommand and corresponding spec
+* Added Commands::AdvancedConditions
+* Added ORDER, LIMIT, OFFSET and WHERE support to AdvancedLoadCommand
+* Renamed spec/has_many.rb to spec/has_many_spec.rb
+* Tweaked the loading of has_many relationships; big performance boost; got rid of an extra query
+* Added EmbeddedValue support, and accompanying spec
+* Fleshed out AdvancedConditions a bit; added conditions_spec.rb
+* Added more AdvancedConditions specs
+* Added Loader to handle multi-instanced rows
+* AdvancedLoadCommand replaced LoadCommand; down to 3 failing specs
+* All specs pass
+* Added :intercept_load finder option and accompanying spec
+* Modified :intercept_load block signature to |instance,columns,row|
+* HasAndBelongsToMany works, all specs pass
+* Fixed a couple bugs with keys; Added DataMapper::Base#key= method
+* Made DataMapper::Base#lazy_load! a little more flexible
+* Removed LoadCommand overwrites from MysqlAdapter
+* Default Database#single_threaded mode is true now
+* Removed MysqlAdapter#initialize, which only served to setup the connections, moved to SqlAdapter
+* Added SqlAdapter#create_connection and SqlAdapter#close_connection abstract methods
+* Added MysqlAdapter#create_connection and MysqlAdapter#close_connection concrete methods
+* Made SqlAdapter#connection a concrete method (instead of abstract), with support for single_threaded operation
+* Database#setup now takes a Hash of options instead of a block-initializer
+* Validation chaining should work for all association types
+* Save chaining should work for has_many associations
+* Added benchmarks for in-session performance to performance.rb
+* Removed block conditions; They're slower and don't offer any real advantages
+* Removed DeleteCommand
+* Removed SaveCommand
+* Removed TableExistsCommand
+* Session renamed to Context
+* Most command implementations moved to methods in SqlAdapter
+* Removed UnitOfWork module, instead moving a slightly refactored implementation into Base
+
+== 0.1.1
+* Removed /lib/data_mapper/extensions
+* Moved ActiveRecordImpersonation into DataMapper::Support module
+* Moved CallbackHelper methods into DataMapper::Base class
+* Moved ValidationHelper into DataMapper::Validations module
+* Removed LoadedSet since it's not necessary for it to reference the Database, so it's nothing more than an array now; Replaced with Array
+* Modified data_mapper.rb to load DataMapper::Support::Enumerable
+* Modified example.rb and performance.rb to require 'lib/data_mapper' instead of modifying $LOADPATH
+* Created SqlAdapter base-class
+* Refactored MysqlAdapter to use SqlAdapter superclass
+* Refactored Sqlite3Adapter to use SqlAdapter superclass
+* Moved /lib/data_mapper/queries to /lib/data_mapper/adapters/sql/queries
+* Moved Connection, Result and Reader classes along with Coersion and Quoting modules to DataMapper::Adapters::Sql module
+* Moved DataMapper::Adapters::Sql::Queries to ::Commands
+* Moved Mappings to SqlAdapter
+* Added monolithic DeleteCommand
+* Added monolithic SaveCommand
+* Added TableExistsCommand
+* Moved save/delete logic out of Session
+* Added create-table functionality to SaveCommand
+* Cleaned up Session; #find no longer supported, use #all or #first
+* Moved object materialization into LoadCommand
+* Migrated Sqlite3Adapter::Commands
+* Added Session#query support back in
+* Removed Connection/Reader/Result classes
+* Set DataMapper::Base#key on load to avoid double-hit against Schema
+* Added DataMapper::Support::Struct for increased Session#query performance
+* Added AdvancedHasManyAssociation (preview status)
+* Added benchmarks comparing ActiveRecord::Base::find_by_sql with Session#query
+
+== 0.1.0
+* Initial Public Release

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2007 Sam Smoot
+
+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/Manifest.txt

@@ -0,0 +1,125 @@
+.autotest
+CONTRIBUTING
+FAQ
+History.txt
+MIT-LICENSE
+Manifest.txt
+QUICKLINKS
+README.txt
+Rakefile
+SPECS
+TODO
+lib/dm-core.rb
+lib/dm-core/adapters.rb
+lib/dm-core/adapters/abstract_adapter.rb
+lib/dm-core/adapters/data_objects_adapter.rb
+lib/dm-core/adapters/mysql_adapter.rb
+lib/dm-core/adapters/postgres_adapter.rb
+lib/dm-core/adapters/sqlite3_adapter.rb
+lib/dm-core/associations.rb
+lib/dm-core/associations/many_to_many.rb
+lib/dm-core/associations/many_to_one.rb
+lib/dm-core/associations/one_to_many.rb
+lib/dm-core/associations/one_to_one.rb
+lib/dm-core/associations/relationship.rb
+lib/dm-core/associations/relationship_chain.rb
+lib/dm-core/auto_migrations.rb
+lib/dm-core/collection.rb
+lib/dm-core/dependency_queue.rb
+lib/dm-core/hook.rb
+lib/dm-core/identity_map.rb
+lib/dm-core/is.rb
+lib/dm-core/logger.rb
+lib/dm-core/migrations/destructive_migrations.rb
+lib/dm-core/migrator.rb
+lib/dm-core/model.rb
+lib/dm-core/naming_conventions.rb
+lib/dm-core/property.rb
+lib/dm-core/property_set.rb
+lib/dm-core/query.rb
+lib/dm-core/repository.rb
+lib/dm-core/resource.rb
+lib/dm-core/scope.rb
+lib/dm-core/support.rb
+lib/dm-core/support/array.rb
+lib/dm-core/support/assertions.rb
+lib/dm-core/support/errors.rb
+lib/dm-core/support/kernel.rb
+lib/dm-core/support/symbol.rb
+lib/dm-core/transaction.rb
+lib/dm-core/type.rb
+lib/dm-core/type_map.rb
+lib/dm-core/types.rb
+lib/dm-core/types/boolean.rb
+lib/dm-core/types/discriminator.rb
+lib/dm-core/types/object.rb
+lib/dm-core/types/paranoid_boolean.rb
+lib/dm-core/types/paranoid_datetime.rb
+lib/dm-core/types/serial.rb
+lib/dm-core/types/text.rb
+lib/dm-core/version.rb
+script/all
+script/performance.rb
+script/profile.rb
+spec/integration/association_spec.rb
+spec/integration/association_through_spec.rb
+spec/integration/associations/many_to_many_spec.rb
+spec/integration/associations/many_to_one_spec.rb
+spec/integration/associations/one_to_many_spec.rb
+spec/integration/auto_migrations_spec.rb
+spec/integration/collection_spec.rb
+spec/integration/data_objects_adapter_spec.rb
+spec/integration/dependency_queue_spec.rb
+spec/integration/model_spec.rb
+spec/integration/mysql_adapter_spec.rb
+spec/integration/postgres_adapter_spec.rb
+spec/integration/property_spec.rb
+spec/integration/query_spec.rb
+spec/integration/repository_spec.rb
+spec/integration/resource_spec.rb
+spec/integration/sqlite3_adapter_spec.rb
+spec/integration/sti_spec.rb
+spec/integration/strategic_eager_loading_spec.rb
+spec/integration/transaction_spec.rb
+spec/integration/type_spec.rb
+spec/lib/logging_helper.rb
+spec/lib/mock_adapter.rb
+spec/lib/model_loader.rb
+spec/lib/publicize_methods.rb
+spec/models/vehicles.rb
+spec/models/zoo.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/unit/adapters/abstract_adapter_spec.rb
+spec/unit/adapters/adapter_shared_spec.rb
+spec/unit/adapters/data_objects_adapter_spec.rb
+spec/unit/adapters/postgres_adapter_spec.rb
+spec/unit/associations/many_to_many_spec.rb
+spec/unit/associations/many_to_one_spec.rb
+spec/unit/associations/one_to_many_spec.rb
+spec/unit/associations/one_to_one_spec.rb
+spec/unit/associations/relationship_spec.rb
+spec/unit/associations_spec.rb
+spec/unit/auto_migrations_spec.rb
+spec/unit/collection_spec.rb
+spec/unit/data_mapper_spec.rb
+spec/unit/identity_map_spec.rb
+spec/unit/is_spec.rb
+spec/unit/migrator_spec.rb
+spec/unit/model_spec.rb
+spec/unit/naming_conventions_spec.rb
+spec/unit/property_set_spec.rb
+spec/unit/property_spec.rb
+spec/unit/query_spec.rb
+spec/unit/repository_spec.rb
+spec/unit/resource_spec.rb
+spec/unit/scope_spec.rb
+spec/unit/transaction_spec.rb
+spec/unit/type_map_spec.rb
+spec/unit/type_spec.rb
+tasks/ci.rb
+tasks/dm.rb
+tasks/doc.rb
+tasks/gemspec.rb
+tasks/hoe.rb
+tasks/install.rb