couch-migrate 1.0.0

data/.document

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+gem 'couchrest'
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "yard", "~> 0.6.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,39 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    couchrest (1.1.2)
+      mime-types (~> 1.15)
+      multi_json (~> 1.0.0)
+      rest-client (~> 1.6.1)
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    mime-types (1.16)
+    multi_json (1.0.3)
+    rake (0.9.2)
+    rcov (0.9.10)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    yard (0.6.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  couchrest
+  jeweler (~> 1.6.4)
+  rcov
+  rspec (~> 2.3.0)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Greg Edwards
+
+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.rdoc

@@ -0,0 +1,19 @@
+= couch-migrate
+
+Description goes here.
+
+== Contributing to couch-migrate
+ 
+* 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.
+
+== Copyright
+
+Copyright (c) 2011 Greg Edwards. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+import 'lib/tasks/couch_migrate.rake'
+
+task 'environment' do
+end
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "couch-migrate"
+  gem.homepage = "https://github.com/gedwards/couch-migrate"
+  gem.license = "MIT"
+  gem.summary = %Q{A simple migration system for CouchDB}
+  gem.description = %Q{A simple migration system for CouchDB.}
+  gem.email = "greg@greglearns.com"
+  gem.authors = ["Greg Edwards"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/couch-migrate.gemspec

@@ -0,0 +1,84 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{couch-migrate}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Greg Edwards"]
+  s.date = %q{2011-09-20}
+  s.description = %q{A simple migration system for CouchDB.}
+  s.email = %q{greg@greglearns.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "couch-migrate.gemspec",
+    "db/migrate/1_test.rb",
+    "lib/couch-migrate.rb",
+    "lib/couch_migrate/base_executer.rb",
+    "lib/couch_migrate/base_migrater.rb",
+    "lib/couch_migrate/base_persisted_list.rb",
+    "lib/couch_migrate/couch_executer.rb",
+    "lib/couch_migrate/couch_migrater.rb",
+    "lib/couch_migrate/couch_persisted_list.rb",
+    "lib/couch_migrate/couchrest_model/extend.rb",
+    "lib/couch_migrate/file_migrater.rb",
+    "lib/couch_migrate/file_persisted_list.rb",
+    "lib/couch_migrate_railtie.rb",
+    "lib/tasks/couch_migrate.rake",
+    "spec/couch_migrate/base_executer_spec.rb",
+    "spec/couch_migrate/base_migrater_spec.rb",
+    "spec/couch_migrate/base_persisted_list_spec.rb",
+    "spec/couch_migrate/couch_migrater_spec.rb",
+    "spec/couch_migrate/couch_persisted_list_spec.rb",
+    "spec/couch_migrate/file_migrater_spec.rb",
+    "spec/couch_migrate/file_persisted_list_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{https://github.com/gedwards/couch-migrate}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{A simple migration system for CouchDB}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<couchrest>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<couchrest>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<couchrest>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/db/migrate/1_test.rb

@@ -0,0 +1,3 @@
+puts "this is test 1"
+up do puts "this is in the up of test 1"; end
+down do puts "this is in the down of test 1" end

data/lib/couch-migrate.rb

@@ -0,0 +1,2 @@
+require_relative 'couch_migrate_railtie.rb' if defined?(Rails)
+Dir["#{File.dirname(__FILE__)}/couch_migrate/**/*.rb"].each {|f| require f}

data/lib/couch_migrate/base_executer.rb

@@ -0,0 +1,35 @@
+module CouchMigrate
+  class BaseExecuter
+    def initialize(enabled, str, filename = "")
+      raise "'enabled' argument must be an Array of symbols (such as [:up, :down] or []" unless enabled.is_a?(Array)
+      @migration_str = str
+      @enabled = enabled
+      @filename = filename
+      self
+    end
+
+    def go
+      Namespaced.module_eval(<<-EOS, __FILE__, __LINE__ + 1)
+        def self.up
+          yield if #{@enabled.include?(:up)}
+        end
+
+        def self.down
+          yield if #{@enabled.include?(:down)}
+        end
+
+        # convenience method for migration files to use
+        def self.use_couchrest_model
+          require 'couch_migrate/couchrest_model/extend.rb'
+        end
+
+      EOS
+
+      Namespaced.module_eval(@migration_str, @filename)
+    end
+
+    module Namespaced
+    end
+  end
+end
+

data/lib/couch_migrate/base_migrater.rb

@@ -0,0 +1,96 @@
+module CouchMigrate
+  class BaseMigrater
+    attr_reader :failed_migration
+
+    def initialize(persisted_list = nil, executer = nil, migration_directory = "db/migrations")
+      @raw_migrations = []
+      @completed_migrations = persisted_list || BasePersistedList.new
+      @executer = executer || BaseExecuter
+      directory(migration_directory)
+      self
+    end
+
+    def migrate(*args)
+      migration_reserved_args= [:quiet]
+      executer_args = args - migration_reserved_args
+
+      @failed_migration, completed = nil, []
+      direction, action, migrations = if args.include?(:down)
+        [:down, :remove, [completed_migrations.last]]
+      else
+        [:up, :add, pending_migrations]
+      end
+
+      migrations.compact.each do |migration|
+        begin
+          puts '-'*40, "Migration #{direction} (#{migration})" unless args.include?(:quiet)
+          str = File.read(@directory + migration)
+          @executer.new(executer_args, str, migration).go
+          completed << migration
+          puts '-'*40 unless args.include?(:quiet)
+        rescue Exception => e
+          @failed_migration = migration
+          puts '-'*5,"FAILURE in migration #{direction} (#{migration}) with message:", e.message, '-'*5, e.backtrace[0...10], '-'*40 unless args.include?(:quiet)
+          return {success: completed, failed: [@failed_migration]}
+        end
+      end
+
+      return completed.empty? ? {} : {success: completed}
+    ensure
+      @completed_migrations.send(action, completed)
+    end
+
+    def directory(path=nil)
+      return @directory if path.nil?
+      @directory = Pathname.new(path)
+      refresh_raw_migrations
+      self
+    end
+
+    def reset
+      @completed_migrations.reset
+      self
+    end
+
+    def reload
+      refresh_raw_migrations
+      self
+    end
+
+    def refresh_raw_migrations(arr=nil)
+      raise "argument must be an array" unless arr.nil? || arr.is_a?(Array)
+      arr ||= Pathname.new(@directory).children(with_directory = false) rescue []
+      @raw_migrations = filter_and_sort(arr)
+      self
+    end
+
+    def raw_migrations(arr=nil)
+      return @raw_migrations if arr.nil?
+      refresh_raw_migrations(arr)
+      self
+    end
+
+    def completed_migrations(arr=nil)
+      return @completed_migrations.get if arr.nil?
+      @completed_migrations.set(arr)
+      self
+    end
+
+    def pending_migrations
+      raw_migrations - completed_migrations
+    end
+
+    private
+
+    def filter_and_sort(arr= [])
+      # discard invalid formats, then sort numerically by first number, then alphabetically for remainder
+      format = /(\d+)_(.*)\.rb/
+      arr.map do |e|
+        name = Pathname.new(e).basename.to_s
+        match = format.match(name)
+        [name, match[1], match[2]] rescue nil
+      end.compact.sort_by{|e| [e[1].to_i, e[2]] }.map{|e| e[0] }
+    end
+
+  end
+end

data/lib/couch_migrate/base_persisted_list.rb

@@ -0,0 +1,52 @@
+module CouchMigrate
+  class BasePersistedList
+
+    def initialize
+      @list = []
+    end
+
+    def get
+      read
+      @list
+    end
+
+    def set(arr)
+      raise "argument must be an array" unless arr.is_a?(Array)
+      @list = arr.dup
+      write
+      self
+    end
+
+    def add(arr)
+      raise "argument must be an array" unless arr.is_a?(Array)
+      @list.concat(arr).uniq!
+      write
+      self
+    end
+
+    def remove(arr)
+      raise "argument must be an array" unless arr.is_a?(Array)
+      @list -= arr
+      write
+      self
+    end
+
+    def reset
+      @list = []
+      cleanup
+      self
+    end
+
+    protected
+
+    def read
+    end
+
+    def write
+    end
+
+    def cleanup
+    end
+  end
+end
+

data/lib/couch_migrate/couch_executer.rb

@@ -0,0 +1,10 @@
+module CouchMigrate
+  class CouchExecuter < BaseExecuter
+    def initialize(enabled, str, filename = nil)
+      super
+      self
+    end
+
+  end
+end
+

data/lib/couch_migrate/couch_migrater.rb

@@ -0,0 +1,15 @@
+require_relative 'base_migrater'
+
+module CouchMigrate
+  class CouchMigrater < BaseMigrater
+    def initialize(database, migration_directory="db/migrate")
+      persisted_list = CouchMigrate::CouchPersistedList.new(database)
+      executer = CouchMigrate::CouchExecuter
+      super(persisted_list, executer, migration_directory)
+      self
+    end
+
+  end
+end
+
+

data/lib/couch_migrate/couch_persisted_list.rb

@@ -0,0 +1,36 @@
+require 'couchrest'
+
+module CouchMigrate
+  class CouchPersistedList < BasePersistedList
+    DocName = 'migrations'
+    MigrationField = 'completed'
+
+    def initialize(database)
+      @db = CouchRest.database!(database) # find or create
+      raise "db cannot be created using url #{database}" if @db.nil?
+      super()
+      self
+    end
+
+    private
+
+    def read
+      @list = @db.get(DocName)[MigrationField] rescue []
+    end
+
+    def write
+      doc = @db.get(DocName) rescue {'_id' => DocName}
+      doc[MigrationField] = @list
+      @db.save_doc(doc)
+    end
+
+    def cleanup
+      @list = []
+      write
+      self
+    end
+
+  end
+
+end
+

data/lib/couch_migrate/couchrest_model/extend.rb

@@ -0,0 +1,16 @@
+# use "use_couchrest_model" in the DSL or
+# include this module in a migration to use CouchRest::Model
+if defined?(CouchRest::CouchRest::Model)
+  module CouchRest
+    module Model
+      class Base
+        before_save :rewrite_type_for_migration_classes
+
+        def rewrite_type_for_migration_classes
+          class_name = self.class.to_s.sub(/CouchMigrate::BaseExecuter::Namespaced::/, '')
+          self['type'] = class_name
+        end
+      end
+    end
+  end
+end

data/lib/couch_migrate/file_migrater.rb

@@ -0,0 +1,14 @@
+require_relative 'base_migrater'
+
+module CouchMigrate
+  class FileMigrater < BaseMigrater
+    def initialize(migration_directory="db/migrate")
+      persisted_list = CouchMigrate::FilePersistedList.new(migration_directory)
+      executer = CouchMigrate::CouchExecuter
+      super(persisted_list, executer, migration_directory)
+      self
+    end
+
+  end
+end
+

data/lib/couch_migrate/file_persisted_list.rb

@@ -0,0 +1,35 @@
+require 'pathname'
+require 'yaml'
+
+module CouchMigrate
+  class FilePersistedList < BasePersistedList
+    def initialize(directory="db/migrate")
+      super()
+      path = Pathname.new(directory)
+      path.mkpath
+      @path = path+"meta.yml"
+      read
+      self
+    end
+
+    protected
+
+    def read
+      @data = YAML.load(File.read(@path)) rescue {}
+      @data[:complete] ||= []
+      @list = @data[:complete]
+    end
+
+    def write
+      @data[:complete] = @list
+      File.open(@path,"w"){|f| f<< YAML.dump(@data) }
+    end
+
+    def cleanup
+      @path.delete rescue nil
+    end
+
+  end
+
+end
+

data/lib/couch_migrate_railtie.rb

@@ -0,0 +1,8 @@
+module CouchMigrate
+  class CouchMigrateRailtie < ::Rails::Railtie
+    rake_tasks do
+      load 'tasks/couch_migrate.rake'
+    end
+  end
+end
+

data/lib/tasks/couch_migrate.rake

@@ -0,0 +1,40 @@
+require_relative '../couch-migrate'
+
+def migrater
+  $db_path = 'http://127.0.0.1:5984/couch-migrate_development'
+  migrater = CouchMigrate::CouchMigrater.new($db_path)
+end
+
+namespace :couch_migrate do
+
+  desc 'migrate all pending migrations'
+
+  namespace :test do
+
+    task :migrate => ['migrate:up']
+
+    namespace :migrate do
+      desc 'couchdb migration up'
+      task 'up' => [:environment, :url] do
+        migrater.migrate(:up)
+      end
+
+      desc 'couchdb migration down'
+      task 'down' => [:environment, :url] do
+        migrater.migrate(:down)
+      end
+
+      desc 'couchdb migration down, then up'
+      task 'redo' => [:environment, :url] do
+        migrater.migrate(:down)
+        migrater.migrate(:up)
+      end
+
+      desc 'print couchdb URL'
+      task 'url' => :environment do
+        $stderr.puts("CouchDB URL: #{$db_path}")
+      end
+
+    end
+  end
+end

data/spec/couch_migrate/base_executer_spec.rb

@@ -0,0 +1,93 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+
+describe "CouchMigrate::BaseExecuter" do
+  subject{ CouchMigrate::BaseExecuter }
+  let(:msg) { "this line was executed by the script" }
+  let(:execution_verification) { "raise '#{msg}'" }
+
+  describe "#go" do
+    let(:enabled) { [] }
+    it "executes a string (typically loaded from a script file)" do
+      lambda{ subject.new(enabled, execution_verification).go }.should raise_error(RuntimeError,msg)
+    end
+
+    it "enables classes to be defined" do
+      script =<<-EOS
+        class Foo
+          def test; #{execution_verification} end
+        end
+        up do
+          Foo.new.test
+        end
+      EOS
+      lambda{ subject.new([:up], script).go }.should raise_error(RuntimeError,msg)
+    end
+
+    it "enables classes to be defined, and they are namespaced" do
+      script =<<-EOS
+        class NamespacedFoo
+          def test; end
+        end
+        up do
+          NamespacedFoo.new.test
+          # puts Module.constants.grep(/NamespacedFoo/).inspect
+          # puts Namespaced.constants.grep(/NamespacedFoo/).inspect
+          # puts BaseExecuter::Namespaced.constants.grep(/NamespacedFoo/).inspect
+          # puts BaseExecuter.constants.grep(/NamespacedFoo/).inspect
+          # puts
+        end
+      EOS
+
+      subject.new([:up], script).go
+
+      # puts Module.constants.grep(/Foo/).inspect
+      # puts BaseExecuter::Namespaced.constants.grep(/Foo/).inspect
+      # puts BaseExecuter.constants.grep(/Foo/).inspect
+
+      Module.constants.include?(:NamespacedFoo).should == false
+      CouchMigrate::BaseExecuter.constants.include?(:NamespacedFoo).should == false
+      CouchMigrate::BaseExecuter::Namespaced.constants.include?(:NamespacedFoo).should == true
+    end
+  end
+
+  describe "#up" do
+    context "when enabled" do
+      let(:enabled) { [:up] }
+
+      it "executes its block of code" do
+        lambda{ subject.new(enabled,"up do raise '#{msg}' end").go }.should raise_error(RuntimeError,msg)
+      end
+    end
+
+    context "when disabled" do
+      let(:enabled) { [] }
+
+      it "does not executes its block of code" do
+        lambda{ subject.new(enabled,"up do raise '#{msg}' end").go }.should_not raise_error(RuntimeError,msg)
+      end
+    end
+
+  end
+
+  describe "#down" do
+    context "when enabled" do
+      let(:enabled) { [:down] }
+
+      it "executes its block of code" do
+        lambda{ subject.new(enabled,"down do raise '#{msg}' end").go }.should raise_error(RuntimeError,msg)
+      end
+    end
+
+    context "when disabled" do
+      let(:enabled) { [] }
+
+      it "does not executes its block of code" do
+        lambda{ subject.new(enabled,"down do raise '#{msg}' end").go }.should_not raise_error(RuntimeError,msg)
+      end
+    end
+
+  end
+
+end
+

data/spec/couch_migrate/base_migrater_spec.rb

@@ -0,0 +1,91 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+
+describe "BaseMigrater", "#migrate" do
+  subject { CouchMigrate::BaseMigrater.new }
+
+  let(:file_name_1){ "1_migration_a.rb" }
+  let(:file_name_2){ "2_migration_b.rb" }
+  let(:file_name_3){ "3_migration_b.rb" }
+
+  it "can set migrations from a list" do
+    subject.raw_migrations.should == []
+
+    subject.raw_migrations([file_name_1, file_name_2]).raw_migrations.should == [file_name_1,file_name_2]
+  end
+
+  context "interacting with the file system" do
+    let(:path){ Pathname.new("spec/tmp") }
+    let(:file_1){ path + file_name_1 }
+    let(:file_2){ path + file_name_2 }
+    let(:file_3){ path + file_name_3 }
+
+    before(:all) do
+      path.mkpath
+      File.open(file_3,"w"){|f| f << "up do end" }
+      File.open(file_2,"w"){|f| f << "up do raise '2 simulated failure' end" }
+      File.open(file_1,"w"){|f| f << "up do end" }
+    end
+
+    after(:all) do
+      file_1.delete
+      file_2.delete
+      file_3.delete
+      path.rmdir rescue nil
+    end
+
+    it "reads the db/migrations directory to generate a list of potential migrations to run" do
+      subject.directory(path).raw_migrations.should == [file_name_1, file_name_2, file_name_3]
+      subject.directory(path).pending_migrations.should == [file_name_1, file_name_2, file_name_3]
+    end
+
+    it "stops when a migration file exits with an error, not processing any subsequent files afterwards" do
+      subject.directory(path).pending_migrations.should == [file_name_1, file_name_2, file_name_3]
+      subject.migrate(:quiet, :up).should == {success: [file_name_1], failed: [file_name_2]}
+      subject.failed_migration.should == file_name_2
+      subject.pending_migrations.should == [file_name_2, file_name_3]
+    end
+
+  end
+
+  it "does not execute migrations that have already been run" do
+    subject.raw_migrations([file_name_1, file_name_2]).completed_migrations([file_name_1]).pending_migrations.should == [file_name_2]
+  end
+
+end
+
+describe "BaseMigrater", "sorting and filtering" do
+  subject { CouchMigrate::BaseMigrater.new }
+
+  it "sorts on migration numbers" do
+    subject.raw_migrations(['2_name.rb','1_name.rb', '3_name.rb'])
+    subject.pending_migrations.should == ['1_name.rb','2_name.rb', '3_name.rb']
+  end
+
+  it "sorts on title if migration numbers are the same" do
+    subject.raw_migrations(['2_a_name.rb','2_b_name.rb'])
+    subject.raw_migrations.should == ['2_a_name.rb','2_b_name.rb']
+  end
+
+  it "sorts on title if migration numbers are the same (version 2)" do
+    subject.raw_migrations(['2_b_name.rb','2_a_name.rb'])
+    subject.raw_migrations.should == ['2_a_name.rb','2_b_name.rb']
+  end
+
+  it "sorts migration numbers numerically, not alphabetically" do
+    subject.raw_migrations(['10_name.rb','2_name.rb'])
+    subject.raw_migrations.should == ['2_name.rb', '10_name.rb']
+  end
+
+  it "sorts migration numbers numerically, not alphabetically (version 2)" do
+    subject.raw_migrations(['2_name.rb','10_name.rb'])
+    subject.raw_migrations.should == ['2_name.rb', '10_name.rb']
+  end
+
+  it "ignores files that do not have follow the migrationOrder_migration_title format" do
+    subject.raw_migrations(['2_name.rb','a_bad_name.rb'])
+    subject.raw_migrations.should == ['2_name.rb']
+  end
+
+end
+

data/spec/couch_migrate/base_persisted_list_spec.rb

@@ -0,0 +1,44 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+
+describe CouchMigrate::BasePersistedList do
+
+  it "starts off with an empty value/list" do
+    subject.get.should == []
+  end
+
+  it "can set values" do
+    arr = [1,2,3]
+    subject.set(arr).get.should == arr
+  end
+
+  it "can append values" do
+    arr = [1,2,3]
+    more = [4,5]
+    expected = [1,2,3,4,5]
+
+    subject.set(arr).add(more)
+    subject.get.should == expected
+  end
+
+  it "can remove values" do
+    arr = [1,2,3]
+    remove = [2,3]
+    expected = [1]
+
+    subject.set(arr).remove(remove)
+    subject.get.should == expected
+  end
+
+  it "can be reset" do
+    subject.set([1,2,3]).reset
+    subject.get.should == []
+  end
+
+  it "is chainable" do
+    subject.set([1]).add([2]).get.should == [1,2]
+    subject.set([1]).add([2]).reset.get.should == []
+  end
+
+end
+

data/spec/couch_migrate/couch_migrater_spec.rb

@@ -0,0 +1,84 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+
+describe "CouchMigrater", "#migrate" do
+
+
+  context "interacting with the file system" do
+    subject { CouchMigrate::CouchMigrater }
+    let(:db_path) { 'http://127.0.0.1:5984/couch-migrate_test' }
+    let(:path){ Pathname.new("spec/tmp") }
+
+    let(:file_name_1){ "1_migration_a.rb" }
+    let(:file_name_2){ "2_migration_b.rb" }
+    let(:file_name_3){ "3_migration_b.rb" }
+    let(:file_path_1){ path + file_name_1 }
+    let(:file_path_2){ path + file_name_2 }
+    let(:file_path_3){ path + file_name_3 }
+
+    before(:each) do
+      migrater.reset # clear pre-existing migration meta data
+      path.mkpath
+      file_path_1.delete rescue nil
+      file_path_2.delete rescue nil
+      file_path_3.delete rescue nil
+    end
+
+    after(:each) do
+      # migrater.reset # remove meta file
+      file_path_1.delete rescue nil
+      file_path_2.delete rescue nil
+      file_path_3.delete rescue nil
+      path.rmdir rescue nil
+    end
+
+    def migrater
+      # allows new migrations to be picked up
+      res = subject.new(db_path, path)
+      res
+    end
+
+    it "handles a sequence of migration added over time" do
+      params = [:up, :quiet]
+      down_params = [:down, :quiet]
+
+      # should succeed
+      File.open(file_path_1,"w"){|f| f << "up do end" }
+      migrater.migrate(*params).should == {success: [file_name_1]}
+
+      # should do nothing
+      migrater.migrate(*params).should == {}
+
+      # should fail
+      File.open(file_path_2,"w"){|f| f << "up do raise '2 simulated failure' end" }
+      migrater.migrate(*params).should == {success: [], failed: [file_name_2]}
+
+      # should pass now
+      File.open(file_path_2,"w"){|f| f << "up do end" }
+      migrater.migrate(*params).should == {success: [file_name_2]}
+
+      # should succeed
+      File.open(file_path_3,"w"){|f| f << "up do end" }
+      migrater.migrate(*params).should == {success: [file_name_3]}
+
+      # should do nothing
+      migrater.migrate(*params).should == {}
+
+      # resetting the migration causes all to be run next time
+      migrater.reset
+      migrater.migrate(*params).should == {success: [file_name_1, file_name_2, file_name_3]}
+
+      # Down * 3
+      migrater.migrate(*down_params).should == {success: [file_name_3]}
+      migrater.migrate(*down_params).should == {success: [file_name_2]}
+      migrater.migrate(*down_params).should == {success: [file_name_1]}
+
+      # Down does nothing
+      migrater.migrate(*down_params).should == {}
+    end
+
+  end
+
+end
+
+

data/spec/couch_migrate/couch_persisted_list_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+
+describe CouchMigrate::CouchPersistedList do
+  let(:db_path) { 'http://127.0.0.1:5984/couch-migrate_test' }
+  subject { CouchMigrate::CouchPersistedList.new(db_path) }
+
+  before(:each) do
+    subject.reset
+  end
+
+  it "starts off with an empty value/list" do
+    subject.get.should == []
+  end
+
+  it "can set values" do
+    arr = [1,2,3]
+    subject.set(arr).get.should == arr
+  end
+
+  it "can append values" do
+    arr = [1,2,3]
+    more = [4,5]
+    expected = [1,2,3,4,5]
+
+    subject.set(arr).add(more)
+    subject.get.should == expected
+  end
+
+  it "can be reset" do
+    subject.set([1,2,3]).reset
+    subject.get.should == []
+  end
+
+  it "is chainable" do
+    subject.set([1]).add([2]).get.should == [1,2]
+    subject.set([1]).add([2]).reset.get.should == []
+  end
+
+end

data/spec/couch_migrate/file_migrater_spec.rb

@@ -0,0 +1,87 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+
+describe "FileMigrater", "#migrate" do
+
+
+  context "interacting with the file system" do
+    subject { CouchMigrate::FileMigrater }
+    let(:path){ Pathname.new("spec/tmp") }
+
+    let(:file_name_1){ "1_migration_a.rb" }
+    let(:file_name_2){ "2_migration_b.rb" }
+    let(:file_name_3){ "3_migration_b.rb" }
+    let(:file_path_1){ path + file_name_1 }
+    let(:file_path_2){ path + file_name_2 }
+    let(:file_path_3){ path + file_name_3 }
+
+    before(:each) do
+      migrater.reset # clear pre-existing migration meta data
+      path.mkpath
+      file_path_1.delete rescue nil
+      file_path_2.delete rescue nil
+      file_path_3.delete rescue nil
+    end
+
+    after(:each) do
+      migrater.reset # remove meta file
+      file_path_1.delete rescue nil
+      file_path_2.delete rescue nil
+      file_path_3.delete rescue nil
+      path.rmdir rescue nil
+    end
+
+    def migrater
+      # allows new migrations to be picked up
+      subject.new(path)
+    end
+
+    it "handles a sequence of migration added over time" do
+      up_params = [:up, :quiet]
+      down_params = [:down, :quiet]
+
+      # should succeed
+      File.open(file_path_1,"w"){|f| f << "up do end" } 
+      migrater.migrate(*up_params).should == {success: [file_name_1]}
+
+      # should do nothing
+      migrater.migrate(*up_params).should == {}
+
+      # should fail
+      File.open(file_path_2,"w"){|f| f << "up do raise '2 simulated failure' end" }
+      migrater.migrate(*up_params).should == {success: [], failed: [file_name_2]}
+
+      # should pass now
+      File.open(file_path_2,"w"){|f| f << "up do end" }
+      migrater.migrate(*up_params).should == {success: [file_name_2]}
+
+      # Down
+      migrater.migrate(*down_params).should == {success: [file_name_2]}
+
+      # up
+      migrater.migrate(*up_params).should == {success: [file_name_2]}
+
+      # should succeed
+      File.open(file_path_3,"w"){|f| f << "up do end" }
+      migrater.migrate(*up_params).should == {success: [file_name_3]}
+
+      # should do nothing
+      migrater.migrate(*up_params).should == {}
+
+      # resetting the migration causes all to be run next time
+      migrater.reset
+      migrater.migrate(*up_params).should == {success: [file_name_1, file_name_2, file_name_3]}
+
+      # Down * 3
+      migrater.migrate(*down_params).should == {success: [file_name_3]}
+      migrater.migrate(*down_params).should == {success: [file_name_2]}
+      migrater.migrate(*down_params).should == {success: [file_name_1]}
+
+      # Down does nothing
+      migrater.migrate(*down_params).should == {}
+    end
+
+  end
+
+end
+

data/spec/couch_migrate/file_persisted_list_spec.rb

@@ -0,0 +1,42 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'couch-migrate'
+require 'pathname'
+
+describe CouchMigrate::FilePersistedList do
+  let(:path){ Pathname.new("spec/tmp") }
+  subject { CouchMigrate::FilePersistedList.new(path) }
+
+  after(:all) do
+    Pathname.new(path).delete
+  end
+
+  it "starts off with an empty value/list" do
+    subject.get.should == []
+  end
+
+  it "can set values" do
+    arr = [1,2,3]
+    subject.set(arr).get.should == arr
+  end
+
+  it "can append values" do
+    arr = [1,2,3]
+    more = [4,5]
+    expected = [1,2,3,4,5]
+
+    subject.set(arr).add(more)
+    subject.get.should == expected
+  end
+
+  it "can be reset" do
+    subject.set([1,2,3]).reset
+    subject.get.should == []
+  end
+
+  it "is chainable" do
+    subject.set([1]).add([2]).get.should == [1,2]
+    subject.set([1]).add([2]).reset.get.should == []
+  end
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: couch-migrate
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Greg Edwards
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-20 00:00:00.000000000 -06:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: couchrest
+  requirement: &2157870300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2157870300
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2157869180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *2157869180
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &2157868040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2157868040
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2157866720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *2157866720
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &2157865660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+  type: :development
+  prerelease: false
+  version_requirements: *2157865660
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &2157864760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2157864760
+description: A simple migration system for CouchDB.
+email: greg@greglearns.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- couch-migrate.gemspec
+- db/migrate/1_test.rb
+- lib/couch-migrate.rb
+- lib/couch_migrate/base_executer.rb
+- lib/couch_migrate/base_migrater.rb
+- lib/couch_migrate/base_persisted_list.rb
+- lib/couch_migrate/couch_executer.rb
+- lib/couch_migrate/couch_migrater.rb
+- lib/couch_migrate/couch_persisted_list.rb
+- lib/couch_migrate/couchrest_model/extend.rb
+- lib/couch_migrate/file_migrater.rb
+- lib/couch_migrate/file_persisted_list.rb
+- lib/couch_migrate_railtie.rb
+- lib/tasks/couch_migrate.rake
+- spec/couch_migrate/base_executer_spec.rb
+- spec/couch_migrate/base_migrater_spec.rb
+- spec/couch_migrate/base_persisted_list_spec.rb
+- spec/couch_migrate/couch_migrater_spec.rb
+- spec/couch_migrate/couch_persisted_list_spec.rb
+- spec/couch_migrate/file_migrater_spec.rb
+- spec/couch_migrate/file_persisted_list_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/gedwards/couch-migrate
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 952696308215902437
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A simple migration system for CouchDB
+test_files: []