rails_has_uuid 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fe1a840f333bb81266b31143361bb208d9cf8de5
+  data.tar.gz: e5a4d58e367ed67670e6c09e5f3d7c73d6a06e9b
+SHA512:
+  metadata.gz: 601952672befc862b8aa84bde7a29cae13d2452b5b0d023eb71183148d1839c5c91184d0811990cd3fc48e7de7baa632ace502e87df034a953a50e664c21d7f6
+  data.tar.gz: e766bf870602fe7f22472117f36b84fd4f1c58dc33446d1161830e40420b2aceaadf7fc017a280b1bed6d12197485763a47665fc6323adb8e774969cb017bd26

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/coverage
+/spec/debug.log
+/gemfiles/*.lock

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,16 @@
+language: ruby
+rvm:
+  - 2.3.0
+  - 2.2.0
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3
+
+before_install: gem install bundler -v 1.11.2
+
+gemfile:
+  - gemfiles/rails_3_2.gemfile
+  - gemfiles/rails_4_0.gemfile
+  - gemfiles/rails_4_1.gemfile
+
+script: "bundle exec rake spec"

data/Appraisals

@@ -0,0 +1,11 @@
+appraise "rails-3-2" do
+  gem "rails", "3.2.22.2"
+end
+
+appraise "rails-4-0" do
+  gem "rails", "4.0.13"
+end
+
+appraise "rails-4-1" do
+  gem "rails", "4.1.15"
+end

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,4 @@
+guard :test do
+  watch(%r{^lib/has_uuid/(.+)\.rb$})           { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^test/(.+)_test\.rb$})              { |m| "lib/has_uuid/#{m[1]}.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Myles Eftos
+
+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,234 @@
+# has_uuid [![Build Status](https://travis-ci.org/madpilot/has_uuid.svg?branch=master)](https://travis-ci.org/madpilot/has_uuid)
+
+A gem to help you retrofit UUIDs to your existing Rails application.
+
+## The scenario
+
+You have an existing Rails site that uses auto-incrementing ids, that you want to add, say, offline syncronization. The problem with auto-incrementing ids is that you will hit clashes
+if you create entries offline.
+
+One solution is to use UUIDs, which has a very, very low probability of clashing. Now the problem is how do you add that to Rails? One way is to replace all the auto-incrementing ids
+with uuids, using something like activeuuid. This can be problematic if you have a running site, as converting all the ids and relationships would be a pain.
+
+Enter: has_uuid
+
+To use has_uuid you mirror all of the primary key id, and foreign key ids with another uuid column, and it makes sure you can search the whole object graph using uuids! If that didn't make sense check this out.
+
+## Example
+
+###Migration
+
+```ruby
+class SetupDatabase < ActiveRecord::Migration
+  def up
+    create_table :record_labels do |t|
+      t.string :name
+      t.uuid :uuid
+    end
+
+    create_table :albums do |t|
+      t.uuid :uuid
+      t.string :name
+      t.integer :record_label_id
+      t.uuid :record_label_uuid
+      t.integer :artist_id
+      t.uuid :artist_uuid
+    end
+  end
+end
+```
+
+has_uuid adds a uuid type to mirations. On SQLite and MySQL it's a binary(16), on PostgreSQL it uses their native uuid type. Notice how we have both a 
+record_label_id and record_label_uuid column...
+
+###Model
+
+```ruby
+class RecordLabel < ActiveRecord::Base
+  has_uuid
+  has_many :albums
+end
+
+class Album < ActiveRecord::Base
+  has_uuid
+  belongs_to :record_label
+end
+```
+
+By calling the has_uuid class method, your model is primed.
+
+### Finders    
+
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+# id: 1, the autogenerated uuid is: cf1ba930-6946-4bd5-9265-d9043e5dbb93
+record_label = RecordLabel.create!(:name => 'Misfit Records')
+# id: 2, the autogenerated uuid is: a957f2d6-371e-4275-9aec-b54a380688e0
+
+RecordLabel.find(1, 2)
+RecordLabel.find('cf1ba930-6946-4bd5-9265-d9043e5dbb93', a957f2d6-371e-4275-9aec-b54a380688e0)
+RecordLabel.find(UUIDTools::UUID.parse('cf1ba930-6946-4bd5-9265-d9043e5dbb93'), UUIDTools::UUID.parse('a957f2d6-371e-4275-9aec-b54a380688e0'))
+```
+
+...will return an array of objects that match those ids
+
+### Relationships
+```ruby    
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+artist_1 = Artist.create!(:name => 'NOFX') 
+
+artist.record_label = record_label
+artist.record_label_uuid
+```
+
+Will return the uuid of the associated record label.
+
+The reverse is also true
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+artist_1 = Artist.create!(:name => 'NOFX') 
+
+artist.record_label_uuid = record_label.uuid
+artist.record_label
+```
+
+Will return the record label object
+
+Finally, it'll find the uuid when you associate via id
+i
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+artist_1 = Artist.create!(:name => 'NOFX') 
+
+artist.record_label_id = record_label.id
+artist.record_label_uuid
+```
+
+Will be the uuid of the record label
+
+Generally, a UUID will be a UUIDTools::UUID, but you can set uuids via a string, so these are equivalent:
+
+```ruby
+uuid = UUIDTools::UUID.random_create
+ => #<UUID:0x3fd4186240e0 UUID:7c9748da-f9fe-467e-bdb3-34ce2dc67605>
+
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords', :uuid => uuid)
+artist_1 = Artist.create!(:name => 'NOFX') 
+
+artist.record_label_uuid = uuid.to
+# is the same as
+artist.record_label_uuid = '7c9748da-f9fe-467e-bdb3-34ce2dc67605'
+```
+
+### Collections
+
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+artist_1 = Artist.create!(:name => 'NOFX') 
+artist_2 = Artist.create!(:name => 'Strung Out') 
+artist_3 = Artist.create!(:name => 'Screeching Weasel') 
+
+record_label.artists = [ artist_1, artist_2, artist_3 ]
+record_label.save!
+
+record_label.artists_uuids
+```
+
+Returns an array of UUIDTools::UUID objects that correspond to artist_1, artist_2, artist_3
+
+it also works the other way:
+
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+artist_1 = Artist.create!(:name => 'NOFX') 
+artist_2 = Artist.create!(:name => 'Strung Out') 
+artist_3 = Artist.create!(:name => 'Screeching Weasel') 
+
+record_label.artist_uuids = [ artist_1.uuid, artist_2.uuid, artist_3.uuid ]
+record_label.save!
+
+record_label.artists
+```
+
+Returns artist_1, artist_2, artist_3
+
+Finally, if you set a relationship id, it will automatically fetch the uuid for you
+
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+artist_1 = Artist.create!(:name => 'NOFX') 
+artist_2 = Artist.create!(:name => 'Strung Out') 
+artist_3 = Artist.create!(:name => 'Screeching Weasel') 
+
+record_label.artist_ids = [ artist_1.uuid, artist_2.uuid, artist_3.uuid ]
+record_label.save!
+
+record_label.artists_uuids
+```
+
+Will also return an array of UUIDTools::UUID objects that correspond to artist_1, artist_2, artist_3
+
+All of these will return the same record
+
+```ruby
+record_label = RecordLabel.create!(:name => 'Fat Wreck Chords')
+# id: 1, the autogenerated uuid is: cf1ba930-6946-4bd5-9265-d9043e5dbb93
+RecordLabel.find(1)
+RecordLabel.find('cf1ba930-6946-4bd5-9265-d9043e5dbb93')
+RecordLabel.find(UUIDTools::UUID.parse('cf1ba930-6946-4bd5-9265-d9043e5dbb93'))
+```
+
+## What doesn't work
+
+Unfortunately, because of the way ARel works, you can only search via a UUIDTools::UUID
+
+```ruby
+uuid = UUIDTools::UUID.random_create
+ => #<UUID:0x3fd4186323c0 UUID:7cd2feb5-6929-4288-9ea4-c4e68927f289> 
+
+Artist.where('uuid = ?', uuid) # This works
+Artist.where('uuid = ?', '7cd2feb5-6929-4288-9ea4-c4e68927f289') # This won't (except on PostgreSQL)
+
+As a result, this also won't work
+Artist.find_by_uuid('7cd2feb5-6929-4288-9ea4-c4e68927f289') 
+```
+
+## TODO
+
+* Some more testing - I'm sure it will fail if you have a relationship between a has_uuidmodel and a regular one
+* Release as a gem - it's not tested well enough yet.
+* Probably other stuff I haven't thought of yet
+
+## Contributing to has_uuid
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Setting up for development environment
+
+has_uuid uses the appraisal gem for testing against multiple versions of Rails.
+
+To get started run:
+
+```appraisal install```
+
+Then to run tests against rails 3.2:
+
+```appraisal rails-3-2 rspec```
+
+Against rails 4.0
+
+```appraisal rails-4-0 rspec```
+
+Against rails 4.1
+
+```appraisal rails-4-1 rspec```
+
+## Copyright
+
+Copyright (c) 2012 [MadPilot Productions](http://www.madpilot.com.au/). See LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "has_uuid"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/gemfiles/rails_3_2.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "3.2.22.2"
+
+gemspec :path => "../"

data/gemfiles/rails_4_0.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "4.0.13"
+
+gemspec :path => "../"

data/gemfiles/rails_4_1.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "4.1.15"
+
+gemspec :path => "../"

data/has_uuid.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'has_uuid/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rails_has_uuid"
+  spec.version       = HasUuid::VERSION
+  spec.authors       = ["Myles Eftos"]
+  spec.email         = ["myles@madpilot.com.au"]
+
+  spec.summary       ="A gem to help you retrofit UUIDs to your existing Rails application. "
+  spec.description   ="A gem to help you retrofit UUIDs to your existing Rails application. "
+  spec.homepage      = "http://github.com/madpilot/has_uuid"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "uuidtools"
+  spec.add_dependency "activeuuid"
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "appraisal", "~> 2.1.0"
+  spec.add_development_dependency "sqlite3"
+  spec.add_development_dependency "database_cleaner"
+  spec.add_development_dependency "mocha"
+end

data/lib/has_uuid.rb

@@ -0,0 +1,67 @@
+require "has_uuid/version"
+
+require 'active_support'
+require 'uuidtools'
+require 'activeuuid'
+
+module HasUuid
+  def self.included(base)
+    base.send :extend, ClassMethods
+  end
+
+  module ClassMethods
+    def has_uuid(options = {})
+      self.class_eval do
+        cattr_accessor :has_uuid_options
+        self.has_uuid_options = options
+        options[:primary_uuid] ||= :uuid
+
+        if options[:primary_uuid] != :uuid
+          class_eval do
+            include ActiveUUID::UUID
+
+            def uuid
+              self.send self.class.primary_uuid
+            end
+
+            def uuid=(uuid)
+              self.send "#{self.class.primary_uuid}=".to_sym, uuid
+            end
+          end
+        end
+
+        class_eval do
+          before_create :generate_uuids_if_needed
+
+          def generate_uuids_if_needed
+            unless self.uuid
+              begin
+                self.uuid = UUIDTools::UUID.random_create
+              end while !HasUuid.check_uuid(self)
+            end
+          end
+        end
+      end
+    end
+
+    def primary_uuid
+      self.has_uuid_options[:primary_uuid]
+    end
+  end
+
+  def self.check_uuid(klass)
+    return false if klass.uuid && klass.id && klass.class.where("#{klass.class.primary_uuid} = ?", klass.uuid).where('id <> ?', klass.id).count > 0
+    return false if klass.uuid && klass.new_record? && klass.class.where("#{klass.class.primary_uuid} = ?", klass.uuid).count > 0
+    return true
+  end
+end
+
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'connection_adapters', 'migration.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'finder_methods.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'reflection.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'associations', 'singular_association.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'associations', 'collection_association.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'associations', 'builder', 'collection_association.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'associations', 'builder', 'singular_association.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'active_record', 'belongs_to_association.rb')
+require File.join(File.dirname(__FILE__), 'has_uuid', 'railtie.rb')

data/lib/has_uuid/active_record/associations/builder/collection_association.rb

@@ -0,0 +1,73 @@
+module HasUuid
+  module ActiveRecord
+    module Associations
+      module Builder
+        module CollectionAssociation
+          extend ActiveSupport::Concern
+          def self.included(base)
+            if ::ActiveRecord::VERSION::STRING >= "4.1"
+              base.extend RedefinedReader
+              base.extend RedefinedWriter
+
+              base.class_eval do
+                class << self
+                  alias_method_chain :define_readers, :uuid_args
+                  alias_method_chain :define_writers, :uuid_args
+                end
+              end
+
+            else
+              base.class_eval do
+                include RedefinedReader
+                include RedefinedWriter
+
+                alias_method_chain :define_readers, :uuid_no_args
+                alias_method_chain :define_writers, :uuid_no_args
+              end
+            end
+          end
+
+          module RedefinedReader
+            def define_readers_with_uuid(mixin, name)
+              mixin.class_eval <<-CODE, __FILE__, __LINE__ + 1
+                def #{name.to_s.singularize}_uuids
+                  association(:#{name}).uuids_reader
+                end
+              CODE
+            end
+
+            def define_readers_with_uuid_args(mixin, name)
+              define_readers_without_uuid_args(mixin, name)
+              define_readers_with_uuid(mixin, name)
+            end
+
+            def define_readers_with_uuid_no_args
+              define_readers_without_uuid_no_args
+              define_readers_with_uuid(mixin, name)
+            end
+          end
+
+          module RedefinedWriter
+            def define_writers_with_uuid(mixin, name)
+              mixin.class_eval <<-CODE, __FILE__, __LINE__ + 1
+                def #{name.to_s.singularize}_uuids=(uuids)
+                  association(:#{name}).uuids_writer(uuids)
+                end
+              CODE
+            end
+
+            def define_writers_with_uuid_args(mixin, name)
+              define_writers_without_uuid_args(mixin, name)
+              define_writers_with_uuid(mixin, name)
+            end
+
+            def define_writers_with_uuid_no_args
+              define_writers_without_uuid_no_args
+              define_writers_with_uuid(mixin, name)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/associations/builder/singular_association.rb

@@ -0,0 +1,51 @@
+module HasUuid
+  module ActiveRecord
+    module Associations
+      module Builder
+        module SingularAssociation
+          extend ActiveSupport::Concern
+
+          def self.included(base)
+            if ::ActiveRecord::VERSION::STRING >= "4.1"
+              base.extend RedefinedWriter
+              base.class_eval do
+                class << self
+                  alias_method_chain :define_writers, :uuid_args
+                end
+              end
+            else
+              base.class_eval do
+                include RedefinedWriter
+                alias_method_chain :define_writers, :uuid_no_args
+              end
+            end
+          end
+
+          module RedefinedWriter
+            def define_writers_with_uuid(mixin, name)
+              mixin.class_eval <<-CODE, __FILE__, __LINE__ + 1
+                def #{name.to_s.singularize}_uuid=(uuids)
+                  association(:#{name}).uuid_writer(uuids)
+                end
+
+                def #{name.to_s.singularize}_uuid
+                  association(:#{name}).uuid_reader
+                end
+              CODE
+            end
+
+            def define_writers_with_uuid_args(mixin, name)
+              define_writers_without_uuid_args(mixin, name)
+              define_writers_with_uuid(mixin, name)
+            end
+
+            def define_writers_with_uuid_no_args
+              define_writers_without_uuid_no_args
+              define_writers_with_uuid(mixin, name)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/associations/collection_association.rb

@@ -0,0 +1,28 @@
+module HasUuid
+  module ActiveRecord
+    module Associations
+      module CollectionAssociation
+        extend ActiveSupport::Concern
+        included do
+          def uuids_reader
+            if loaded? || options[:finder_sql]
+              load_target.map do |record|
+                record.send(reflection.association_primary_uuid)
+              end
+            else
+              column  = "#{reflection.quoted_table_name}.#{reflection.association_primary_uuid}"
+              association_scope.pluck(column)
+            end
+          end
+
+          def uuids_writer(uuids)
+            uuid_column = reflection.primary_uuid_column
+            uuids = Array(uuids).reject { |uuid| uuid.blank? }
+            uuids.map! { |u| uuid_column.type_cast(u) }
+            replace(klass.find(uuids).index_by { |r| r.uuid }.values_at(*uuids))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/associations/singular_association.rb

@@ -0,0 +1,24 @@
+module HasUuid
+  module ActiveRecord
+    module Associations
+      module SingularAssociation
+        extend ActiveSupport::Concern
+        included do
+          def uuid_writer(uuid)
+            replace(klass.find(uuid)) unless uuid.nil? || uuid.to_s.empty?
+            replace(nil) if uuid.nil? || uuid.to_s.empty?
+          end
+
+          def uuid_reader(force_reload = false)
+            id = self.owner.send(reflection.foreign_key)
+            if id
+              klass.find(id).uuid
+            else
+              nil
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/belongs_to_association.rb

@@ -0,0 +1,27 @@
+module HasUuid
+  module ActiveRecord
+    module BelongsToAssociation
+      extend ActiveSupport::Concern
+
+      included do
+        def replace_keys_with_uuid(record)
+          if record.class.respond_to?(:has_uuid?) && record.class.has_uuid?
+            if foreign_uuid_present?
+              if record
+                owner[reflection.foreign_uuid] = record[reflection.association_uuid_key(record.class)]
+              else
+                owner[reflections.foreign_uuid] = nil
+              end
+            end
+          end
+          replace_keys_without_uuid(record)
+        end
+        alias_method_chain :replace_keys, :uuid
+      end
+
+      def foreign_uuid_present?
+        owner.class.columns.map(&:name).include?(reflection.foreign_uuid.to_s)
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/connection_adapters/migration.rb

@@ -0,0 +1,15 @@
+module HasUuid
+  module ActiveRecord
+    module ConnectionAdapters
+      module Migration
+        def uuid(*column_names)
+          options = column_names.extract_options!
+          column_names.each do |name|
+            type = @base.adapter_name.downcase == 'postgresql' ? 'uuid' : 'binary(16)'
+            column(name, "#{type}", options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/finder_methods.rb

@@ -0,0 +1,54 @@
+module HasUuid
+  VALID_FORMAT = /^([0-9a-f]{8})-([0-9a-f]{4})-([0-9a-f]{4})-([0-9a-f]{2})([0-9a-f]{2})-([0-9a-f]{12})$/
+
+  module ActiveRecord
+    module FinderMethods
+      def find_one(id)
+        if id.is_a?(::UUIDTools::UUID) || id.to_s =~ VALID_FORMAT
+          id = ::UUIDTools::UUID.parse(id) if id.is_a?(String)
+          return self.find_by_uuid!(id)
+        end
+        super
+      end
+
+      def find_some(ids)
+        if ids.length > 0 && ids.inject(true) { |r, id| r && (id.is_a?(::UUIDTools::UUID) || id.to_s =~ VALID_FORMAT) }
+          uuids = ids.map do |id|
+            id = ::UUIDTools::UUID.parse(id) if id.is_a?(String)
+            id
+          end
+
+          arr = where(table[:uuid].in(uuids))
+          if ::ActiveRecord::VERSION::MAJOR >= 4
+            result = arr.load
+          else
+            result = arr.all
+          end
+
+          expected_size =
+            if @limit_value && ids.size > @limit_value
+              @limit_value
+            else
+              ids.size
+            end
+
+            if @offset_value && (ids.size - @offset_value < expected_size)
+              expected_size = ids.size - @offset_value
+            end
+
+            if result.size == expected_size
+              result
+            else
+              conditions = arel.where_sql
+              conditions = " [#{conditions}]" if conditions
+              error = "Couldn't find all #{@klass.name.pluralize} with UUIDs "
+              error << "(#{ids.join(", ")})#{conditions} (found #{result.size} results, but was looking for #{expected_size})"
+              raise ::ActiveRecord::RecordNotFound, error
+            end
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/active_record/reflection.rb

@@ -0,0 +1,42 @@
+module HasUuid
+  module ActiveRecord
+    module Reflection
+      module AssociationReflection
+        extend ActiveSupport::Concern
+        
+        included do
+          def primary_uuid_column
+            @primary_uuid_column ||= klass.columns.find { |c| c.name.to_sym == klass.primary_uuid }
+          end
+
+          def association_primary_uuid(klass = nil)
+            options[:primary_uuid] || primary_uuid(klass || self.klass)
+          end
+     
+          def active_record_primary_uuid
+            @active_record_primary_uuid ||= options[:primary_uuid] || primary_uuid(active_record)
+          end
+
+          def foreign_uuid
+            @foreign_uuid ||= options[:foreign_uuid] || derive_foreign_uuid              
+          end
+
+        private
+          def primary_uuid(klass)
+            klass.primary_uuid || raise(UnknownPrimaryKey.new(klass))
+          end
+
+          def derive_foreign_uuid
+            if belongs_to?
+              "#{name}_uuid"
+            elsif options[:as]
+              "#{options[:as]}_uuid"
+            else
+              active_record.name.foreign_key
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/has_uuid/railtie.rb

@@ -0,0 +1,22 @@
+module HasUuid
+  class Railtie < Rails::Railtie
+    initializer 'has_uuid' do |app|
+      ActiveSupport.on_load :active_record do
+        ::ActiveRecord::Relation.send :include, HasUuid::ActiveRecord::FinderMethods
+        ::ActiveRecord::Reflection::AssociationReflection.send :include, HasUuid::ActiveRecord::Reflection::AssociationReflection
+        ::ActiveRecord::Associations::BelongsToAssociation.send :include, HasUuid::ActiveRecord::BelongsToAssociation
+        ::ActiveRecord::Associations::SingularAssociation.send :include, HasUuid::ActiveRecord::Associations::SingularAssociation
+        ::ActiveRecord::Associations::CollectionAssociation.send :include, HasUuid::ActiveRecord::Associations::CollectionAssociation
+        ::ActiveRecord::Associations::Builder::SingularAssociation.send :include, HasUuid::ActiveRecord::Associations::Builder::SingularAssociation
+        ::ActiveRecord::Associations::Builder::CollectionAssociation.send :include, HasUuid::ActiveRecord::Associations::Builder::CollectionAssociation
+        ::ActiveRecord::Base.send :include, HasUuid
+      end
+
+      ActiveSupport.on_load :activeuuid do
+        # We don't want our ids to be UUIDs so override activeuuid's implementation
+        ::ActiveRecord::ConnectionAdapters::Table.send :include, HasUuid::ActiveRecord::ConnectionAdapters::Migrations if defined? ActiveRecord::ConnectionAdapters::Table
+        ::ActiveRecord::ConnectionAdapters::TableDefinition.send :include, HasUuid::ActiveRecord::ConnectionAdapters::Migrations if defined? ActiveRecord::ConnectionAdapters::TableDefinition
+      end
+    end
+  end
+end

data/lib/has_uuid/version.rb

@@ -0,0 +1,3 @@
+module HasUuid
+  VERSION = "0.2.0"
+end

metadata

@@ -0,0 +1,198 @@
+--- !ruby/object:Gem::Specification
+name: rails_has_uuid
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Myles Eftos
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-03-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: uuidtools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activeuuid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'A gem to help you retrofit UUIDs to your existing Rails application. '
+email:
+- myles@madpilot.com.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".document"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Appraisals
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- gemfiles/rails_3_2.gemfile
+- gemfiles/rails_4_0.gemfile
+- gemfiles/rails_4_1.gemfile
+- has_uuid.gemspec
+- lib/has_uuid.rb
+- lib/has_uuid/active_record/associations/builder/collection_association.rb
+- lib/has_uuid/active_record/associations/builder/singular_association.rb
+- lib/has_uuid/active_record/associations/collection_association.rb
+- lib/has_uuid/active_record/associations/singular_association.rb
+- lib/has_uuid/active_record/belongs_to_association.rb
+- lib/has_uuid/active_record/connection_adapters/migration.rb
+- lib/has_uuid/active_record/finder_methods.rb
+- lib/has_uuid/active_record/reflection.rb
+- lib/has_uuid/railtie.rb
+- lib/has_uuid/version.rb
+homepage: http://github.com/madpilot/has_uuid
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: A gem to help you retrofit UUIDs to your existing Rails application.
+test_files: []