activerecord-postgis-array 0.3.4

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bin/
+.rbenv-version*
+
+spec/dummy/config/database.yml

data/.rspec

@@ -0,0 +1,2 @@
+--format Fivemat
+--colour

data/.travis.yml

@@ -0,0 +1,18 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby-18mode
+  - jruby-19mode
+
+before_script:
+  - psql -c 'create database activerecord-postgis-array_test;' -U postgres
+  - cp spec/dummy/config/database.yml.example spec/dummy/config/database.yml
+  - RAILS_ENV=test rake db:migrate
+
+notifications:
+  email: 
+    - git@danmcclain.net
+  campfire:
+    rooms:
+      - secure: "yVESPleawl+fzvnzXw/W7rULyCjMEq3gPc3cEqcqM2SBBtEIDNXto2zoTAoR\nC5yqhijr+UtmVMsI7CxVK3XvfkmCJZN9P4DP0uas8XYx5DsSabCdPN0h3pka\nbaDCMCInU5QF4WswL2iuyLsOJeKDRwxh09adsHi1HpMgf0nTKPA="

data/CHANGELOG.md

@@ -0,0 +1,99 @@
+## 0.3.1
+
+ * Fixes issue with array -> string code - Dan McClain
+ * Adds support for ISN types - Ezekiel Templin
+ * Fix for Squeel compatibility - Alexander Borovsky
+
+## 0.3.0
+
+ * Adds support to create indexes concurrently  -  Dan McClain
+ * Changes using syntax, updates specs  -  Dan McClain
+ * Empty strings are converted to nil by string_to_cidr_address -  Dan McClain
+ * Replaced .symbolize with .to_sym in arel nodes.  -  OMCnet Development Team
+ * Removes array_contains in favor of a column aware contains  -  Dan McClain
+ * Renames Arel array_overlap to overlap  -  Dan McClain
+ * Merge pull request #67 from jagregory/array_contains Array contains operator support -  Dan McClain
+ * Update querying doc to include array_contains  -  James Gregory
+ * Array contains operator ( @> ) support -  James Gregory
+ * how to use SQL to convert string-delimited arrays in docs -  Turadg Aleahmad
+ * Check if connection responds to #support_extensions? before invoking it  -  Dirk von Grünigen
+
+## 0.2.2
+
+ * Fixes issue with visit_Array monkey patch - Dan McClain (@danmcclain)
+
+## 0.2.1
+
+ * Fixes issue with citext change column calls - Dan McClain
+(@danmcclain)
+
+## 0.2.0
+
+ * Introduces extensions to `ActiveRecord::Relation.where` to simplify
+Array and INET/CIDR queries - Dan McClain (@danmcclain)
+ * Fixes `where(:array => [1,2])` to use equailty instead of IN clauses
+- Dan McClain (@danmcclain)
+ * Adds Arel predicates for more network comparisons - Patrick Muldoon
+(@doon)
+ * Adds support for citext in migrations/schema.rb - Jonathan Younger
+(@daikini)
+ * Fixes text character encoding for text columns - Andy Monat (@amonat)
+ * Cleans up alias_method_chains for better interoperability - Raido
+Paaslepp (@legendetm)
+ * Doc updates - Dan McClain, Caleb Woods (@danmcclain @calebwoods)
+
+## 0.1.0
+
+ * Performs PostgreSQL version check before attempting to dumpe
+extensions - Dan McClain (@danmcclain)
+ * Fixes issues with schema dumper when indexes have no index_opclass -
+Mario Visic (@mariovisic)
+
+## 0.0.10
+
+ * Fixes parsing of number arrays when they are set from a string array - Alexey Noskov (@alno)
+ * Cleans up spec organization  - Dan McClain (@danmcclain)
+ * Adds support for index operator classes (:index_opclass) in
+migrations and schema dumps - & Dan McClain (@danmcclain)
+ * Fixes Arel Nodes created by activerecord-postgis-array  - Dan McClain (@danmcclain)
+ * Add support to schema.rb to export and import extensions - Keenan
+Brock (@kbrock)
+ * Handles PostgreSQL strings when passed in as defaults by fixing the
+quote method
+ * Documentation updates. - Dan McClain & Doug Yun (@danmcclain
+@duggieawesome)
+ * Fixes #update_column calls - Dan McClain (@danmcclain)
+
+
+## 0.0.9
+
+ * Fixes #<attribute_name>?, Adds (pending) test case for #update_column - Dan McClain (@danmcclain)
+ * Fix handing of pgsql arrays for the literal and argument-binding
+cases - Michael Graff (@skandragon)
+ * Fixes UTF-8 strings in string arrays are not returned as UTF-8
+encoded strings - Michael Graff (@skandragon)
+ * Documentation fixes - Michael Graff (@skandragon) and Dan McClain
+(@danmcclain)
+ * Properly encode strings stored in an array. - Michael Graff
+(@skandragon)
+ * Fixes integer array support - Keenan Brock (@kbrock)
+ * Adds more robust index types with add_index options :index_type and :where. - Keenan Brock (@kbrock)
+
+## 0.0.8
+
+Fixes add and change column 
+
+## 0.0.7
+
+Adds Arel predicate functions for array overlap operator (`&&`) and
+INET/CIDR contained within operator (`<<`)
+
+## 0.0.6
+
+Lots of array related fixes:
+ * Model creation should no longer fail when not assigning a value to an
+   array column
+ * Array columns follow database defaults
+
+Migration fix (rn0 and gilltots)  
+Typos in README (bcardarella)

data/CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contribution Guidelines #
+
+## Submitting a new issue ##
+
+If you need to open a new issue you *must* provide the following:
+
+1. Version of Rails
+
+Failure to include the aforementioned requirements will result in the
+issue being closed.
+
+If you want to ensure that your issue gets fixed *fast* you should
+attempt to reproduce the issue in an isolated example application that
+you can share.
+
+## Making a pull request ##
+
+If you'd like to submit a pull request please adhere to the following:
+
+1. Your code *must* be tested. Please TDD your code!
+2. No single-character variables
+3. Two-spaces instead of tabs
+4. Single-quotes instead of double-quotes unless you are using string
+   interpolation or escapes.
+5. General Rails/Ruby naming conventions for files and classes
+6. *Do not* use Ruby 1.9 hash syntax
+7. *Do not* use Ruby 1.9 stubby proc syntax
+8. Follow Tim Pope's [model for git commit messages](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html). This will make it 
+   much easier to generate change logs and navigate through the logs
+
+Please note that you must adhere to each of the aforementioned rules.
+Failure to do so will result in an immediate closing of the pull
+request. If you update and rebase the pull request to follow the
+guidelines your pull request will be re-opened and considered for
+inclusion.

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in activerecord-postgis-array.gemspec
+gemspec
+unless ENV['CI']
+  if RUBY_PLATFORM =~ /java/
+    gem 'ruby-debug'
+  elsif RUBY_VERSION == '1.9.3' || RUBY_VERSION == '2.0.0'
+    gem 'debugger'
+  end
+end
+gem 'fivemat'

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Dan Seaver
+
+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,87 @@
+# ActiveRecordPostgisArrays
+
+Adds support for missing PostgreSQL data types to ActiveRecord.
+
+[![Build Status](https://secure.travis-ci.org/dockyard/activerecord-postgis-array.png?branch=master)](http://travis-ci.org/dockyard/activerecord-postgis-array)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/dockyard/activerecord-postgis-array)
+
+## Looking for help? ##
+
+If it is a bug [please open an issue on
+Github](https://github.com/dockyard/party_foul/issues). If you need help using
+the gem please ask the question on
+[Stack Overflow](http://stackoverflow.com). Be sure to tag the
+question with `DockYard` so we can find it.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'activerecord-postgis-array'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install activerecord-postgis-array
+
+## Usage
+
+Just `require 'activerecord-postgis-array'` and use ActiveRecord as you normally would! postgres\_ext extends
+ActiveRecord's data type handling.
+
+ * [Migration/Schema.rb support](docs/migrations.md)
+ * [Type Casting support](docs/type_casting.md)
+ * [Querying PostgreSQL datatypes](docs/querying.md)
+ * [Indexes](docs/indexes.md)
+
+## Usage Notes
+Avoid the use of in place operators (ie `Array#<<`). These changes are
+*not* tracked by Rails ([this issue](https://github.com/rails/rails/issues/6954))
+explains why). In place modifications also modify the default object.
+
+Assuming we have the following model:
+
+```ruby
+create_table :items do |t|
+  t.string :names, :array => true, :default => []
+end
+
+class Item < ActiveRecord::Base
+end
+```
+
+The following will modify the default value of the names attribute.
+
+```ruby
+a = Item.new
+a.names << 'foo'
+
+b = Item.new
+puts b.names
+# => ['foo']
+```
+
+The supported way of modifying `a.names`:
+
+```ruby
+a = Item.new
+a.names += ['foo']
+
+b = Item.new
+puts b.names
+# => []
+```
+
+As a result, in place operators are discouraged and will not be
+supported in postgres\_ext at this time. 
+
+
+
+
+## Authors
+
+Dan McClain [twitter](http://twitter.com/_danmcclain) [github](http://github.com/danmcclain)
+

data/Rakefile

@@ -0,0 +1,33 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'activerecord-postgis-array'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+task :default => :spec

data/activerecord-postgis-array.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/activerecord-postgis-array/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Hannah Howard"]
+  gem.email         = ["hannah@techgirlwonder.com"]
+  gem.description   = %q{Adds missing native PostgreSQL array types to ActiveRecord}
+  gem.summary       = %q{Extends ActiveRecord to handle native PostgreSQL array types and is compatible with postgis}
+  gem.homepage      = ""
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "activerecord-postgis-array"
+  gem.require_paths = ["lib"]
+  gem.version       = ActiveRecordPostgisArray::VERSION
+
+  gem.add_dependency 'activerecord', '~> 3.2.0'
+  gem.add_dependency 'pg_array_parser', '~> 0.0.8'
+  gem.add_dependency 'activerecord-postgis-adapter'
+  
+  gem.add_development_dependency 'rails', '~> 3.2.0'
+  gem.add_development_dependency 'rspec-rails', '~> 2.12.0'
+  gem.add_development_dependency 'bourne', '~> 1.3.0'
+  if RUBY_PLATFORM =~ /java/
+    gem.add_development_dependency 'activerecord-jdbcpostgresql-adapter'
+  else
+    gem.add_development_dependency 'pg', '~> 0.13.2'
+  end
+end

data/docs/indexes.md

@@ -0,0 +1,28 @@
+# Indexes
+
+## Index types
+
+Postgres\_ext allows you to specify index type and index operator
+class at index creation.
+
+```ruby
+add_index :table_name, :column, :using => :gin
+add_index :table_name, :column, :using => :gin, :index_opclass => :gin_trgm_ops
+```
+
+## Where clauses
+
+Postgres\_ext allows you to specify a where clause at index creation.
+
+```ruby
+add_index :table_name, :column, :where => 'column < 50'
+```
+
+## Concurrent Indexes
+
+Postgres\_ext allows you to create indexes concurrently using the
+`:algorithm` option
+
+```ruby
+add_index :table_name, :column, :algorithm => :concurrently
+```

data/docs/migrations.md

@@ -0,0 +1,92 @@
+# Migration/Schema.rb support
+
+## INET
+
+```ruby
+create_table :testing do |t|
+  t.inet :inet_column
+  # or
+  t.inet :inet_column_1, :inet_column_2
+  # or
+  t.column :inet_column, :inet
+end
+```
+
+## CIDR
+
+```ruby
+create_table :testing do |t|
+  t.cidr :cidr_column
+  # or
+  t.cidr :cidr_column_1, :cidr_column_2
+  # or
+  t.column :cidr_column, :cidr
+end
+```
+
+## MACADDR
+
+```ruby
+create_table :testing do |t|
+  t.macaddr :macaddr_column
+  # or
+  t.macaddr :macaddr_column_1, :macaddr_column_2
+  # or
+  t.column :macaddr_column, :macaddr
+end
+```
+
+## UUID
+
+```ruby
+create_table :testing do |t|
+  t.uuid :uuid_column
+  # or
+  t.uuid :uuid_column_1, :uuid_column_2
+  # or
+  t.column :uuid_column, :uuid
+end
+```
+
+## CITEXT
+
+```ruby
+create_table :testing do |t|
+  t.citext :citext_column
+  # or
+  t.citext :citext_column_1, :citext_column_2
+  # or
+  t.column :citext_column, :citext
+end
+```
+
+## Arrays
+Arrays are created from any ActiveRecord supported datatype (including
+ones added by postgres\_ext), and respect length constraints
+
+```ruby
+create_table :testing do |t|
+  t.integer :int_array, :array => true
+  # integer[]
+  t.integer :int_array, :array => true, :limit => 2
+  # smallint[]
+  t.string :macaddr_column_1, :array => true, :limit => 30
+  # char varying(30)[]
+end
+```
+
+### Converting to Arrays
+
+If you have an existing column with a string-delimited array (e.g. 'val1 val2 val3') convert that data using SQL in your migration.
+
+```ruby
+class AddLinkedArticleIdsToLinkSet < ActiveRecord::Migration
+  def change
+    add_column :link_sets, :linked_article_ids, :integer, :array => true, :default => []
+    execute <<-eos
+    UPDATE link_sets
+    SET linked_article_ids = cast (string_to_array(linked_articles_string, ' ') as integer[])
+    eos
+  end
+end
+````