rgeo-activerecord 0.2.0

data/History.rdoc

@@ -0,0 +1,6 @@
+=== 0.2.0 / 2010-12-07
+
+* Initial public alpha release. Spun rgeo-activerecord off from the core rgeo gem.
+* Support for setting factory by column.
+
+For earlier history, see the History file for the rgeo gem.

data/README.rdoc

@@ -0,0 +1,89 @@
+== RGeo::ActiveRecord
+
+RGeo::ActiveRecord is an optional {RGeo}[http://github.com/dazuma/rgeo]
+module providing spatial extensions for \ActiveRecord, as well as a set
+of helpers for writing spatial \ActiveRecord adapters based on \RGeo.
+
+=== Summary
+
+\RGeo is a key component for writing location-aware applications in the
+Ruby programming language. At its core is an implementation of the
+industry standard OGC Simple Features Specification, which provides data
+representations of geometric objects such as points, lines, and polygons,
+along with a set of geometric analysis operations. See the README for the
+"rgeo" gem for more information.
+
+RGeo::ActiveRecord is an optional \RGeo add-on module providing spatial
+extensions for \ActiveRecord, as well as a set of helpers for writing
+spatial \ActiveRecord adapters based on \RGeo.
+
+=== Installation
+
+RGeo::ActiveRecord has the following requirements:
+
+* Ruby 1.8.7 or later. Ruby 1.9.2 or later preferred.
+* \RGeo 0.2.0 or later.
+* \ActiveRecord 3.0.3 or later. Earlier versions will not work.
+
+Generally, \ActiveRecord adapters which depend on this module should be
+installed as gems, and they will install this module automatically as
+a dependency. However, you can also install it manually as a gem:
+
+ gem install rgeo
+ gem install rgeo-activerecord
+
+See the README for the "rgeo" gem, a required dependency, for further
+installation information.
+
+=== To-do list
+
+* We want to investigate writing some Arel extensions for constructing
+  spatial queries.
+
+=== Development and support
+
+Documentation is available at http://virtuoso.rubyforge.org/rgeo-activerecord/README_rdoc.html
+
+Source code is hosted on Github at http://github.com/dazuma/rgeo-activerecord
+
+Contributions are welcome. Fork the project on Github.
+
+Report bugs on Github issues at http://github.org/dazuma/rgeo-activerecord/issues
+
+Contact the author at dazuma at gmail dot com.
+
+=== Acknowledgments
+
+\RGeo is written by Daniel Azuma (http://www.daniel-azuma.com).
+
+Development of \RGeo is sponsored by GeoPage, Inc. (http://www.geopage.com).
+
+=== License
+
+Copyright 2010 Daniel Azuma
+
+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 the copyright holder, nor the names of any other
+  contributors to this software, 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 OWNER 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/Version

@@ -0,0 +1 @@
+0.2.0

data/lib/rgeo/active_record.rb

@@ -0,0 +1,66 @@
+# -----------------------------------------------------------------------------
+# 
+# ActiveRecord extensions for RGeo
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# 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 the copyright holder, nor the names of any other
+#   contributors to this software, 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 OWNER 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.
+# -----------------------------------------------------------------------------
+;
+
+
+# Dependencies
+require 'rgeo'
+require 'active_record'
+
+
+# RGeo is a spatial data library for Ruby, provided by the "rgeo" gem.
+# 
+# The optional RGeo::ActiveRecord module provides spatial extensions for
+# ActiveRecord, and a set of tools and helpers for writing RGeo-based
+# spatial connection adapters.
+
+module RGeo
+  
+  
+  # This module contains a set of ActiveRecord extensions for RGeo.
+  # Generally, you will not need to interact with the contents of this
+  # module directly, unless you are writing a spatial ActiveRecord
+  # connection adapter.
+  
+  module ActiveRecord
+  end
+  
+  
+end
+
+
+# Implementation files
+require 'rgeo/active_record/common.rb'
+require 'rgeo/active_record/arel_modifications'
+require 'rgeo/active_record/ar_modifications'

data/lib/rgeo/active_record/adapter_test_helper.rb

@@ -0,0 +1,147 @@
+# -----------------------------------------------------------------------------
+# 
+# Helper methods for ActiveRecord adapter tests
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# 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 the copyright holder, nor the names of any other
+#   contributors to this software, 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 OWNER 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.
+# -----------------------------------------------------------------------------
+;
+
+
+require 'rgeo/active_record'
+require 'yaml'
+require 'logger'
+
+
+module RGeo
+  module ActiveRecord
+    
+    
+    # A helper module for creating unit tests for adapters.
+    
+    module AdapterTestHelper
+      
+      @class_num = 0
+      
+      
+      # When this module is included in a test case class, it
+      # automatically attempts to load the database config file from the
+      # path specified by the class's DATABASE_CONFIG_FILE constant.
+      # It then defines the DATABASE_CONFIG and DEFAULT_AR_CLASS constants
+      # in the testcase class.
+      # 
+      # When you define your test methods, you should wrap them in a call
+      # to the class method define_test_methods. This will cause them to
+      # be defined conditionally based on whether the database config is
+      # present.
+      
+      def self.included(klass_)
+        database_config_ = ::YAML.load_file(klass_.const_get(:DATABASE_CONFIG_PATH)) rescue nil
+        if database_config_
+          database_config_.symbolize_keys!
+          if klass_.respond_to?(:before_open_database)
+            klass_.before_open_database(:config => database_config_)
+          end
+          klass_.const_set(:DATABASE_CONFIG, database_config_)
+          ar_class_ = AdapterTestHelper.new_class(database_config_)
+          klass_.const_set(:DEFAULT_AR_CLASS, ar_class_)
+          if klass_.respond_to?(:initialize_database)
+            klass_.initialize_database(:ar_class => ar_class_, :connection => ar_class_.connection)
+          end
+          def klass_.define_test_methods
+            yield
+          end
+        else
+          def klass_.define_test_methods
+            def test_warning
+              puts "WARNING: Couldn't find database.yml; skipping tests."
+            end
+          end
+        end
+      end
+      
+      
+      def self.new_class(param_)  # :nodoc:
+        base_ = param_.kind_of?(::Class) ? param_ : ::ActiveRecord::Base
+        config_ = param_.kind_of?(::Hash) ? param_ : nil
+        klass_ = ::Class.new(base_)
+        @class_num += 1
+        self.const_set("Klass#{@class_num}".to_sym, klass_)
+        klass_.class_eval do
+          establish_connection(config_) if config_
+          set_table_name(:spatial_test)
+        end
+        klass_
+      end
+      
+      
+      # Default setup method that calls cleanup_tables.
+      # It also defines a couple of useful factories: @factory (a
+      # cartesian factory) and @geographic_factory (a spherical factory)
+      
+      def setup
+        @factory = ::RGeo::Cartesian.preferred_factory(:srid => 4326)
+        @geographic_factory = ::RGeo::Geographic.spherical_factory(:srid => 4326)
+        cleanup_tables
+      end
+      
+      
+      # Default teardown method that calls cleanup_tables.
+      
+      def teardown
+        cleanup_tables
+      end
+      
+      
+      # Utility method that attempts to clean up any table that was
+      # created by a test method. Normally called automatically at setup
+      # and teardown. If you override those methods, you'll need to call
+      # this from your method.
+      
+      def cleanup_tables
+        klass_ = self.class.const_get(:DEFAULT_AR_CLASS)
+        if klass_.connection.tables.include?('spatial_test')
+          klass_.connection.drop_table(:spatial_test)
+        end
+      end
+      
+      
+      # Utility method that creates and returns a new ActiveRecord class
+      # subclassing the DEFAULT_AR_CLASS.
+      
+      def create_ar_class(opts_={})
+        @ar_class = AdapterTestHelper.new_class(self.class.const_get(:DEFAULT_AR_CLASS))
+      end
+      
+      
+    end
+    
+    
+  end
+end

data/lib/rgeo/active_record/ar_modifications.rb

@@ -0,0 +1,149 @@
+# -----------------------------------------------------------------------------
+# 
+# Mysqlgeo adapter for ActiveRecord
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# 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 the copyright holder, nor the names of any other
+#   contributors to this software, 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 OWNER 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.
+# -----------------------------------------------------------------------------
+;
+
+
+require 'active_record'
+
+
+# RGeo extensions to ActiveRecord are installed when one of the spatial
+# connection adapters is needed. These modifications require ActiveRecord
+# 3.0.3 or later.
+
+module ActiveRecord
+  
+  
+  # RGeo extends ActiveRecord::Base to include the following new class
+  # attributes. These attributes are inherited by subclasses, and can
+  # be overridden in subclasses.
+  # 
+  # === ActiveRecord::Base::rgeo_factory_generator
+  # 
+  # The value of this attribute is a RGeo::Feature::FactoryGenerator
+  # that is used to generate the proper factory when loading geometry
+  # objects from the database. For example, if the data being loaded
+  # has M but not Z coordinates, and an embedded SRID, then this
+  # FactoryGenerator is called with the appropriate configuration to
+  # obtain a factory with those properties. This factory is the one
+  # associated with the actual geometry properties of the ActiveRecord
+  # object. The result of this generator can be overridden by setting
+  # an explicit factory for a given class and column using the
+  # column_rgeo_factory method.
+  
+  class Base
+    
+    
+    self.attribute_types_cached_by_default << :geometry
+    
+    
+    class_attribute :rgeo_factory_generator, :instance_writer => false
+    self.rgeo_factory_generator = nil
+    
+    
+    class << self
+      
+      
+      # This is a convenient way to set the rgeo_factory_generator by
+      # passing a block.
+      
+      def to_generate_rgeo_factory(&block_)
+        self.rgeo_factory_generator = block_
+      end
+      
+      
+      # Set a specific factory for this ActiveRecord class and the given
+      # column name. This setting, if present, overrides the result of the
+      # rgeo_factory_generator.
+      
+      def set_rgeo_factory_for_column(column_, factory_)
+        @rgeo_factory_for_column = {} unless defined?(@rgeo_factory_for_column)
+        @rgeo_factory_for_column[column_.to_sym] = factory_
+      end
+      
+      
+      # Returns the factory generator or specific factory to use for this
+      # ActiveRecord class and the given column name.
+      # If an explicit factory was set for the given column, returns it.
+      # Otherwise, if a params hash is given, passes that has to the
+      # rgeo_factory_generator for this class, and returns the resulting
+      # factory. Otherwise, if no params hash is given, just returns the
+      # rgeo_factory_generator for this class.
+      
+      def rgeo_factory_for_column(column_, params_=nil)
+        @rgeo_factory_for_column = {} unless defined?(@rgeo_factory_for_column)
+        result_ = @rgeo_factory_for_column[column_.to_sym] || rgeo_factory_generator || ::RGeo::ActiveRecord::DEFAULT_FACTORY_GENERATOR
+        if params_ && !result_.kind_of?(::RGeo::Feature::Factory::Instance)
+          result_ = result_.call(params_)
+        end
+        result_
+      end
+      
+      
+      # :stopdoc:
+      alias_method :columns_without_rgeo_modification, :columns
+      def columns
+        unless defined?(@columns) && @columns
+          columns_without_rgeo_modification.each do |column_|
+            column_.set_ar_class(self) if column_.respond_to?(:set_ar_class)
+          end
+        end
+        @columns
+      end
+      # :startdoc:
+      
+    end
+    
+  end
+  
+  
+  module ConnectionAdapters  # :nodoc:
+    
+    class TableDefinition  # :nodoc:
+      
+      ::RGeo::ActiveRecord::GEOMETRY_TYPES.each do |type_|
+        method_ = <<-END_METHOD
+          def #{type_}(*args_)
+            opts_ = args_.extract_options!
+            args_.each{ |name_| column(name_, '#{type_}', opts_) }
+          end
+        END_METHOD
+        class_eval(method_, __FILE__, __LINE__-5)
+      end
+      
+    end
+    
+  end
+  
+  
+end

data/lib/rgeo/active_record/arel_modifications.rb

@@ -0,0 +1,73 @@
+# -----------------------------------------------------------------------------
+# 
+# Mysqlgeo adapter for ActiveRecord
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# 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 the copyright holder, nor the names of any other
+#   contributors to this software, 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 OWNER 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.
+# -----------------------------------------------------------------------------
+;
+
+
+require 'arel'
+
+
+# :stopdoc:
+
+module Arel
+  
+  module Attributes
+    
+    class Geometry < Attribute; end
+    
+    class << self
+      alias_method :for_without_geometry, :for
+      def for(column_)
+        column_.type == :geometry ? Geometry : for_without_geometry(column_)
+      end
+    end
+    
+  end
+  
+  module Visitors
+    
+    class Dot
+      alias :visit_Arel_Attributes_Geometry :visit_Arel_Attribute
+      alias :visit_RGeo_Feature_Geometry :visit_String
+    end
+    
+    class ToSql
+      alias :visit_Arel_Attributes_Geometry :visit_Arel_Attributes_Attribute
+      alias :visit_RGeo_Feature_Geometry :visit_String
+    end
+    
+  end
+  
+end
+
+# :startdoc:

data/lib/rgeo/active_record/common.rb

@@ -0,0 +1,84 @@
+# -----------------------------------------------------------------------------
+# 
+# Common tools for spatial adapters for ActiveRecord
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# 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 the copyright holder, nor the names of any other
+#   contributors to this software, 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 OWNER 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.
+# -----------------------------------------------------------------------------
+;
+
+
+module RGeo
+  
+  module ActiveRecord
+    
+    
+    # Additional column types for geometries.
+    GEOMETRY_TYPES = [:geometry, :point, :line_string, :polygon, :geometry_collection, :multi_line_string, :multi_point, :multi_polygon].freeze
+    
+    # The default factory generator for ActiveRecord::Base.
+    DEFAULT_FACTORY_GENERATOR = ::Proc.new do |config_|
+      if config_.delete(:geographic)
+        ::RGeo::Geographic.spherical_factory(config_)
+      else
+        ::RGeo::Cartesian.preferred_factory(config_)
+      end
+    end
+    
+    
+    # Index definition struct with a spatial flag field.
+    
+    class SpatialIndexDefinition < ::Struct.new(:table, :name, :unique, :columns, :lengths, :spatial)
+    end
+    
+    
+    class << self
+      
+      
+      # Returns a feature type module given a string type.
+      
+      def geometric_type_from_name(name_)
+        case name_.downcase
+        when 'geometry' then ::RGeo::Feature::Geometry
+        when 'point' then ::RGeo::Feature::Point
+        when 'linestring' then ::RGeo::Feature::LineString
+        when 'polygon' then ::RGeo::Feature::Polygon
+        when 'geometrycollection' then ::RGeo::Feature::GeometryCollection
+        when 'multipoint' then ::RGeo::Feature::MultiPoint
+        when 'multilinestring' then ::RGeo::Feature::MultiLineString
+        when 'multipolygon' then ::RGeo::Feature::MultiPolygon
+        else nil
+        end
+      end
+      
+    end
+    
+  end
+  
+end

data/test/tc_basic.rb

@@ -0,0 +1,90 @@
+# -----------------------------------------------------------------------------
+# 
+# Tests for basic ActiveRecord extensions
+# 
+# -----------------------------------------------------------------------------
+# Copyright 2010 Daniel Azuma
+# 
+# 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 the copyright holder, nor the names of any other
+#   contributors to this software, 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 OWNER 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.
+# -----------------------------------------------------------------------------
+;
+
+
+require 'test/unit'
+require 'rgeo/active_record'
+
+
+module RGeo
+  module ActiveRecord
+    module Tests  # :nodoc:
+      
+      class TestBasic < ::Test::Unit::TestCase  # :nodoc:
+        
+        
+        def test_default_factory_generator
+          ::ActiveRecord::Base.rgeo_factory_generator = nil
+          factory_ = ::ActiveRecord::Base.rgeo_factory_for_column(:hello).call(:has_z_coordinate => true, :srid => 4326)
+          assert_equal(true, factory_.property(:has_z_coordinate))
+          assert_equal(true, factory_.property(:is_cartesian))
+          assert_nil(factory_.property(:is_geographic))
+          assert_equal(4326, factory_.srid)
+        end
+        
+        
+        def test_set_factory_generator
+          ::ActiveRecord::Base.rgeo_factory_generator = ::RGeo::Geographic.method(:spherical_factory)
+          factory_ = ::ActiveRecord::Base.rgeo_factory_for_column(:hello, :has_z_coordinate => true, :srid => 4326)
+          assert_equal(true, factory_.property(:has_z_coordinate))
+          assert_equal(true, factory_.property(:is_geographic))
+          assert_nil(factory_.property(:is_cartesian))
+          assert_equal(false, factory_.has_projection?)
+          assert_equal(4326, factory_.srid)
+        end
+        
+        
+        def test_specific_factory_for_column
+          ::ActiveRecord::Base.rgeo_factory_generator = nil
+          ::ActiveRecord::Base.set_rgeo_factory_for_column(:foo, ::RGeo::Geographic.simple_mercator_factory(:has_z_coordinate => true))
+          factory_ = ::ActiveRecord::Base.rgeo_factory_for_column(:foo)
+          assert_equal(true, factory_.property(:has_z_coordinate))
+          assert_equal(true, factory_.property(:is_geographic))
+          assert_nil(factory_.property(:is_cartesian))
+          assert_equal(true, factory_.has_projection?)
+          assert_equal(4326, factory_.srid)
+        end
+        
+        
+        def test_geometry_types
+          [:geometry, :point, :line_string, :polygon, :geometry_collection, :multi_line_string, :multi_point, :multi_polygon].each{ |type_| assert(::RGeo::ActiveRecord::GEOMETRY_TYPES.include?(type_), "Type #{type_.inspect} not found" ) }
+        end
+        
+        
+      end
+    
+    end
+  end
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: rgeo-activerecord
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Daniel Azuma
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-07 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rgeo
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 3
+        version: 3.0.3
+  type: :runtime
+  version_requirements: *id002
+description: RGeo is a geospatial data library for Ruby. RGeo::ActiveRecord is an optional RGeo module providing some spatial extensions to ActiveRecord, as well as common tools used by RGeo-based spatial adapters.
+email: dazuma@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.rdoc
+- README.rdoc
+files: 
+- lib/rgeo/active_record/adapter_test_helper.rb
+- lib/rgeo/active_record/ar_modifications.rb
+- lib/rgeo/active_record/arel_modifications.rb
+- lib/rgeo/active_record/common.rb
+- lib/rgeo/active_record.rb
+- History.rdoc
+- README.rdoc
+- test/tc_basic.rb
+- Version
+has_rdoc: true
+homepage: http://virtuoso.rubyforge.org/rgeo-activerecord
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: virtuoso
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: An RGeo module providing spatial extensions to ActiveRecord.
+test_files: 
+- test/tc_basic.rb