migrator 1.0.0

data/.autotest

@@ -0,0 +1,29 @@
+# -*- ruby -*-
+
+module Autotest::GnomeNotify
+
+  # Time notification will be displayed before disappearing automatically
+  EXPIRATION_IN_SECONDS = 2
+  ERROR_STOCK_ICON = "gtk-dialog-error"
+  SUCCESS_STOCK_ICON = "gtk-dialog-info"
+
+  # Convenience method to send an error notification message
+  #
+  # [stock_icon]   Stock icon name of icon to display
+  # [title]        Notification message title
+  # [message]      Core message for the notification
+  def self.notify stock_icon, title, message
+    options = "-t #{EXPIRATION_IN_SECONDS * 1000} -i #{stock_icon}"
+    system "notify-send #{options} '#{title}' '#{message}'"
+  end
+
+  Autotest.add_hook :red do |at|
+    notify ERROR_STOCK_ICON, "Tests failed", "#{at.files_to_test.size} tests failed"
+  end
+
+  Autotest.add_hook :green do |at|
+    notify SUCCESS_STOCK_ICON, "All tests passed, good job!", ""
+  end
+
+end
+

data/History.txt

@@ -0,0 +1,5 @@
+=== 1.0.0 / 2009-09-17
+
+* 1 major enhancement
+
+  * Birthday!

data/Manifest.txt

@@ -0,0 +1,13 @@
+lib/aef/migrator/adapter.rb
+lib/aef/migrator/migrator.rb
+lib/aef/migrator/abstract_adapter.rb
+lib/aef/migrator.rb
+Manifest.txt
+History.txt
+Rakefile
+.autotest
+spec/spec_helper.rb
+spec/mock_adapter.rb
+spec/spec.opts
+spec/migrator_spec.rb
+README.rdoc

data/README.rdoc

@@ -0,0 +1,209 @@
+= Migrator
+
+* Project: https://rubyforge.org/projects/migrator/
+* RDoc: http://migrator.rubyforge.org/
+* Github: http://github.com/aef/migrator/
+
+== DESCRIPTION:
+
+Migrator is a Ruby library for building general purpose versioning systems in
+the style of ActiveRecord's migrations.
+
+== FEATURES/PROBLEMS:
+
+* Completely written in Ruby
+* Tested and fully working on:
+  * Ubuntu Linux 8.10 amd64/x86_64
+    * Ruby 1.8.7p72
+    * Ruby 1.9.1p129
+  * Debian GNU/Linux 4.0 x86
+    * Ruby 1.8.6
+  * On Windows XP x86
+    * Ruby 1.8.6
+
+== SYNOPSIS:
+
+Load the gem:
+
+  require 'aef/migrator'
+
+Build an adapter:
+
+  class Adapter
+    include Aef::Migrator::Adapter
+    
+    # version() has to reflect the current version. Also version=() must exist
+    # to set the current version
+    attr_accessor :version,
+
+    # versions() has to provide a list of all versions in correct order
+    attr_accessor :versions
+
+    def initialize
+      self.versions = %w{a b c d e}
+      self.version = 'c'
+    end
+
+    # process() has to do the work behind a migration in forward direction. Will
+    # be called multiple times for multistep migrations.
+    def process(target_version)
+      puts "Migrating from #{version} to #{target_version}"
+
+      self.version = target_version
+    end
+
+    # revert() has to do the work behind a migration in backward direction. Will
+    # be called multiple times for multistep migrations.
+    def revert(target_version)
+      puts "Unmigrating from #{version} to #{target_version}"
+
+      self.version = target_version
+    end
+  end
+
+Notice that the module Aef::Migrator::Adapter and the class
+Aef::Migrator::AbstractAdapter both provide the basic method definitions for an
+adapter but no functionality. The advantage are better error messages when you
+forget to implement something, but you don't have to use either, as
+Aef::Migrator defines an adapter only by checking for required methods.
+
+Now we setup the migrator:
+
+  migrator = Aef::Migrator.new(Adapter.new)
+
+After that we can use the versioning backend provided by the adapter to do
+migrations:
+
+  migrator.version
+  # => "c"
+
+  migrator.up
+  migrator.version
+  # => "d"
+
+  migrator.up.version
+  # => "e"
+
+  migrator.down('b')
+  migrator.version
+  # => "b"
+
+  migrator.migrate('e').version
+  # => "e"
+
+When migrations cannot be done, exceptions of the baseclass Aef::Migrator::Error
+are raised. If there is a problem with the Adapter the exceptions will be of
+Aef::Migrator::AdapterError which is a subclass of Aef::Migrator::Error.
+Exceptions informing about unmatched migration constraints are from the subclass
+Aef::Migrator::MigrationError.
+
+We can also check if a migration is possible before running it. This way we
+don't have to deal with exceptions when a migration cannot be done.
+
+  migrator.migratable?('e')
+  # => false
+
+  migrator.upable?
+  # => false
+
+  migrator.downable?('c')
+  # => true
+
+See the files in the spec subdirectory for further examples of usage.
+
+== REQUIREMENTS:
+
+* rubygems
+
+=== Additional for automated testing
+* hoe (>= 2.3.2)
+* rspec (>= 1.2.8)
+
+== INSTALL:
+
+On *nix systems you may need to prefix the command with sudo to get root
+privileges.
+
+=== High security (recommended)
+
+There is a high security installation option available through rubygems. It is
+highly recommended over the normal installation, although it may be a bit less
+comfortable. To use the installation method, you will need my public key, which
+I use for cryptographic signatures on all my gems. You can find the public key
+and more detailed verification information in the aef-certificates section of my
+rubyforge project[https://rubyforge.org/frs/?group_id=7890&release_id=31749]
+
+Add the key to your rubygems' trusted certificates by the following command:
+
+  gem cert --add aef.pem
+
+Now you can install the gem while automatically verifying it's signature by the
+following command:
+
+  gem install migrator --ignore-dependencies -P HighSecurity
+
+Please notice that you may need other keys for dependent libraries, so you may
+have to install dependencies manually.
+
+=== Normal (insecure)
+
+  gem install migrator
+
+=== Github (also insecure)
+
+Alternatively you could install migrator from github which may be a bit more
+up to date. The version may however not be as stable as the normal gem and there
+is no way to install the gem securely. Therefore this is not recommended.
+
+  gem install aef-migrator --source http://gems.github.com
+
+=== Automated testing
+
+You can test this package through rspec on your system. First find the path
+where the gem was installed to:
+
+  gem which aef/migrator
+
+Go into the root directory of the installed gem and run the following command
+to start the test runner:
+
+  rake spec
+
+If something goes wrong you should be noticed through failing examples.
+
+== DEVELOPMENT:
+
+This software is developed in the source code management system git hosted
+at github.com. You can download the most recent sourcecode through the following
+command:
+
+  git clone git://github.com/aef/migrator.git
+
+Help on making this software better is always very appreciated. If you want your
+changes to be included in the official release, please send me a patch through
+the project's tracker[https://rubyforge.org/tracker/?group_id=7890] at
+rubyforge.org. You can generate a patch-file by the following command:
+
+  git diff > patch.diff
+
+Please make sure to write tests for your changes and notice that I can't promise
+to include your changes before reviewing them.
+
+== LICENSE:
+
+Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+
+This file is part of Migrator.
+
+Migrator is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.

data/Rakefile

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec('migrator') do
+  developer('Alexander E. Fischer', 'aef@raxys.net')
+
+  self.rubyforge_name = 'migrator'
+  self.extra_dev_deps = {
+    'rspec' => '>= 1.2.8'
+  }
+  self.url = 'https://rubyforge.org/projects/migrator/'
+  self.readme_file = 'README.rdoc'
+  self.extra_rdoc_files = %w{README.rdoc}
+  self.spec_extras = {
+    :rdoc_options => ['--main', 'README.rdoc', '--inline-source', '--line-numbers', '--title', 'Migrator']
+  }
+  self.rspec_options = ['--options', 'spec/spec.opts']
+  self.remote_rdoc_dir = ''
+end
+
+# vim: syntax=Ruby

data/lib/aef/migrator.rb

@@ -0,0 +1,27 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# Namespace for projects of Alexander E. Fischer <aef@raxys.net>
+#
+# If you want to be able to simply type Example instead of Aef::Example to
+# address classes in this namespace simply write the following before using the
+# classes:
+#
+#  include Aef
+module Aef
+  autoload :Migrator, 'aef/migrator/migrator'
+end

data/lib/aef/migrator/abstract_adapter.rb

@@ -0,0 +1,26 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# This class implements the interface for an adapter required by Aef::Migrator
+# and could be used as an abstract base class. See also: Adapter
+class Aef::Migrator::AbstractAdapter
+  include Aef::Migrator::Adapter
+
+  def initialize
+    raise NotImplementedError, 'Abstract class' if self.class == Aef::Migrator::AbstractAdapter
+  end
+end

data/lib/aef/migrator/adapter.rb

@@ -0,0 +1,40 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# This module implements the interface for an adapter required by Aef::Migrator.
+# See also: AbstractAdapter.
+module Aef::Migrator::Adapter
+  def process(target_version)
+    raise NotImplementedError, 'The process method needs to be implemented'
+  end
+
+  def revert(target_version)
+    raise NotImplementedError, 'The revert method needs to be implemented'
+  end
+
+  def version
+    raise NotImplementedError, 'The version method needs to be implemented'
+  end
+
+  def version=(versions)
+    raise NotImplementedError, 'The version= method needs to be implemented'
+  end
+
+  def versions
+    raise NotImplementedError, 'The versions method needs to be implemented'
+  end
+end

data/lib/aef/migrator/migrator.rb

@@ -0,0 +1,170 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# Class for building general purpose versioning systems in the style of
+# ActiveRecord's migrations. An adapter object is needed for any instance of
+# this class to have any use. See Adapter and AbstractAdapter for the required
+# interface.
+class Aef::Migrator
+  VERSION = '1.0.0'
+
+  # Baseclass for all Migrator specific exceptions
+  class Error < RuntimeError; end
+
+  # Baseclass for exceptions describing adapter errors
+  class AdapterError < Error; end
+  class AdapterMissingError < AdapterError; end
+  class AdapterMethodMissingError < AdapterError; end
+  class CurrentVersionInvalidError < AdapterError; end
+
+  # Baseclass for exceptions describing errors while processing migrations
+  class MigrationError < Error; end
+  class AlreadyOnTopError < MigrationError; end
+  class AlreadyOnBottomError < MigrationError; end
+  class TargetVersionInvalidError < MigrationError; end
+  class UpMigrationInvalidError < MigrationError; end
+  class DownMigrationInvalidError < MigrationError; end
+  class MigrationUnneccessaryError < MigrationError; end
+
+  autoload :Adapter, 'aef/migrator/adapter'
+  autoload :AbstractAdapter, 'aef/migrator/abstract_adapter'
+
+  attr_accessor :adapter
+
+  def initialize(adapter)
+    @adapter = adapter
+  end
+
+  # Checks if a migration is possible
+  def migratable?(target_version, direction = nil)
+    !!migration_steps(target_version, direction)
+  rescue MigrationError
+    false
+  end
+
+  # Checks if an up migration is possible
+  def upable?(target_version = nil)
+    migratable?(target_version, :up)
+  end
+
+  # Checks if a down migration is possible
+  def downable?(target_version = nil)
+    migratable?(target_version, :down)
+  end
+
+  # Process a migration
+  #
+  # Raises MigratorError in case of invalid actions
+  def migrate(target_version, direction = nil)
+    params = migration_steps(target_version, direction)
+
+    params[:steps].each do |version|
+      @adapter.send(params[:action], version)
+    end
+
+    self
+  end
+
+  # Process an up migration
+  #
+  # Raises MigratorError in case of invalid actions
+  def up(target_version = nil)
+    migrate(target_version, :up)
+  end
+
+  # Process a down migration
+  #
+  # Raises MigratorError in case of invalid actions
+  def down(target_version = nil)
+    migrate(target_version, :down)
+  end
+
+  # Current version
+  def version
+    @adapter.version
+  end
+
+  # All possible versions in correct order
+  def versions
+    @adapter.versions
+  end
+
+  protected
+
+  # Returns a hash with an :action value and a :steps array with all versions
+  # to reach the target
+  def migration_steps(target_version, direction)
+    raise ArgumentError, 'Invalid direction' unless [nil, :up, :down].include?(direction)
+
+    unless @adapter
+      raise AdapterMissingError, 'No adapter set'
+    else
+      Adapter.instance_methods(false).each do |method|
+        raise AdapterMethodMissingError, "Adapter must respond to #{method}" unless @adapter.respond_to?(method)
+      end
+    end
+
+    version_list = versions
+    current_version = version
+
+    indices = {:current => version_list.index(current_version)}
+
+    raise CurrentVersionInvalidError, "Current version not in version list: " +
+      "'#{current_version}'" unless indices[:current]
+
+    # When direction is set and target_version is unset step up/down by one
+    unless target_version
+      case direction
+      when :up
+        step_up = indices[:current] + 1
+        raise AlreadyOnTopError, 'Already on highest version' unless step_up < version_list.size
+        indices[:target] = step_up
+        target_version = version_list[step_up]
+      when :down
+        step_down = indices[:current] - 1
+        raise AlreadyOnBottomError, 'Already on lowest version' unless step_down >= 0
+        indices[:target] = step_down
+        target_version = version_list[step_down]
+      else
+        raise ArgumentError, 'No target version specified'
+      end
+    else
+      indices[:target] = version_list.index(target_version)
+
+      raise TargetVersionInvalidError, 'Target version not in version list: ' +
+        "'#{target_version}'" unless indices[:target]
+    end
+
+    if indices[:current] < indices[:target]
+      raise DownMigrationInvalidError, "Current version '#{current_version}' " +
+        "is lower than '#{target_version}'"  if direction == :down
+
+      indices[:current] += 1
+      
+      {:action => :process, :steps => version_list[indices.values.min..indices.values.max]}
+    elsif indices[:current] > indices[:target]
+      raise UpMigrationInvalidError, "Current version '#{current_version}' " +
+        "is higher than '#{target_version}'" if direction == :up
+
+      indices[:current] -= 1
+
+      {:action => :revert, :steps => version_list[indices.values.min..indices.values.max].reverse}
+    else
+      raise MigrationUnneccessaryError, "Current version equals target version: '#{current_version}'"
+    end
+  end
+end

data/spec/migrator_spec.rb

@@ -0,0 +1,214 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'spec/spec_helper'
+
+describe Aef::Migrator do
+  before(:all) do
+    class BrokenAdapter < described_class::AbstractAdapter
+      undef :process
+    end
+  end
+
+  before(:each) do
+    @adapter = MockAdapter.new
+    @adapter.verbose = false
+    @migrator = described_class.new(@adapter)
+  end
+
+  it "should complain about invalid direction params" do
+    lambda {
+      @migrator.migrate('a', :invalid)
+    }.should raise_error(ArgumentError)
+  end
+
+  it "should complain when no adapter is set" do
+    lambda {
+      @migrator.adapter = nil
+      @migrator.migrate('a')
+    }.should raise_error(described_class::AdapterMissingError)
+  end
+
+  it "should complain about missing adapter methods" do
+    lambda {
+      @migrator.adapter = BrokenAdapter.new
+      @migrator.migrate('a')
+    }.should raise_error(described_class::AdapterMethodMissingError)
+  end
+
+  it "should complain about current versions which are not in versions" do
+    lambda {
+      @adapter.version = 'f'
+      @migrator.migrate('a')
+    }.should raise_error(described_class::CurrentVersionInvalidError)
+  end
+
+  it "should complain about target versions which are not in versions" do
+    lambda {
+      @migrator.migrate('invalid')
+    }.should raise_error(described_class::TargetVersionInvalidError)
+  end
+
+  it "should complain about migrating to the current version" do
+    lambda {
+      @migrator.migrate('c')
+    }.should raise_error(described_class::MigrationUnneccessaryError)
+  end
+
+  it "should be able to implicitly migrate one version up" do
+    lambda {
+      @migrator.up
+    }.should change{@migrator.version}.from('c').to('d')
+  end
+
+  it "should be able to implicitly migrate one version down" do
+    lambda {
+      @migrator.down
+    }.should change{@migrator.version}.from('c').to('b')
+  end
+
+  it "should be able to explicitly migrate one version up" do
+    lambda {
+      @migrator.up('d')
+    }.should change{@migrator.version}.from('c').to('d')
+  end
+
+  it "should be able to explicitly migrate one version down" do
+    lambda {
+      @migrator.down('b')
+    }.should change{@migrator.version}.from('c').to('b')
+  end
+
+  it "should be able to migrate multiple version up with one call" do
+    lambda {
+      @migrator.up('e')
+    }.should change{@migrator.version}.from('c').to('e')
+  end
+
+  it "should be able to migrate multiple version down with one call" do
+    lambda {
+      @migrator.down('a')
+    }.should change{@migrator.version}.from('c').to('a')
+  end
+
+  it "should prohibit migration in wrong direction when up method is used" do
+    lambda {
+      @migrator.up('a')
+    }.should raise_error(described_class::UpMigrationInvalidError)
+  end
+
+  it "should prohibit migration in wrong direction when down method is used" do
+    lambda {
+      @migrator.down('e')
+    }.should raise_error(described_class::DownMigrationInvalidError)
+  end
+
+  it "should allow up migration with generic migrate method" do
+    lambda {
+      @migrator.migrate('e')
+    }.should change{@migrator.version}.from('c').to('e')
+  end
+
+  it "should allow down migration with generic migrate method" do
+    lambda {
+      @migrator.migrate('a')
+    }.should change{@migrator.version}.from('c').to('a')
+  end
+
+  it "should complain about invalid direction params when migratable? is called" do
+    lambda {
+      @migrator.migratable?('a', :invalid)
+    }.should raise_error(ArgumentError)
+  end
+
+  it "should complain when no adapter is set when migratable? is called" do
+    lambda {
+      @migrator.adapter = nil
+      @migrator.migrate('a')
+    }.should raise_error(described_class::AdapterMissingError)
+  end
+
+  it "should complain about missing adapter methods when migratable? is called" do
+    lambda {
+      @migrator.adapter = BrokenAdapter.new
+      @migrator.migratable?('a')
+    }.should raise_error(described_class::AdapterMethodMissingError)
+  end
+
+  it "should complain about current versions which are not in versions when migratable? is called" do
+    lambda {
+      @adapter.version = 'f'
+      @migrator.migratable?('a')
+    }.should raise_error(described_class::CurrentVersionInvalidError)
+  end
+
+  it "should indicate that a migration to an invalid target version is impossible" do
+    @migrator.migratable?('invalid').should be_false
+  end
+
+  it "should indicate that implicitly migrating one version up is possible" do
+    @migrator.upable?.should be_true
+  end
+
+  it "should indicate that implicitly migrating one version down is possible" do
+    @migrator.downable?.should be_true
+  end
+
+  it "should indicate that migrating one version up is possible" do
+    @migrator.upable?('d').should be_true
+  end
+
+  it "should indicate that migrating one version down is possible" do
+    @migrator.downable?('b').should be_true
+  end
+
+  it "should indicate that a multi-step migration up is possible" do
+    @migrator.upable?('e').should be_true
+  end
+
+  it "should indicate that a multi-step migration down is possible" do
+    @migrator.downable?('a').should be_true
+  end
+
+  it "should indicate a wrong direction migration is impossible when upable? method is used" do
+    @migrator.upable?('a').should be_false
+  end
+
+  it "should indicate a wrong direction migration is impossible when downable? method is used" do
+    @migrator.downable?('e').should be_false
+  end
+
+  it "should indicate that up migration is possible when migratable? method is used" do
+    @migrator.migratable?('e').should be_true
+  end
+
+  it "should indicate that down migration is possible when migratable? method is used" do
+    @migrator.migratable?('a').should be_true
+  end
+
+  it "should return itself for method changing through method migrate" do
+    @migrator.migrate('d').should eql(@migrator)
+  end
+
+  it "should return itself for method changing through method up" do
+    @migrator.up.should eql(@migrator)
+  end
+
+  it "should return itself for method changing through method down" do
+    @migrator.down.should eql(@migrator)
+  end
+end

data/spec/mock_adapter.rb

@@ -0,0 +1,47 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+class MockAdapter < Aef::Migrator::AbstractAdapter
+  attr_accessor :version, :versions_hash, :verbose
+
+  def initialize
+    @versions_hash = {
+      'a' => 'a.version',
+      'b' => 'b.version',
+      'c' => 'c.version',
+      'd' => 'd.version',
+      'e' => 'e.version'
+    }
+    self.version = 'c'
+  end
+
+  def process(target_version)
+    puts "Migrating from #{version} to #{target_version} (#{versions_hash[target_version]})" if @verbose
+
+    self.version = target_version
+  end
+
+  def revert(target_version)
+    puts "Unmigrating from #{version} to #{target_version} (#{versions_hash[version]})" if @verbose
+
+    self.version = target_version
+  end
+
+  def versions
+    versions_hash.keys.sort
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,4 @@
+--colour
+--format progress
+--loadby mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+# Copyright 2009 Alexander E. Fischer <aef@raxys.net>
+#
+# This file is part of Migrator.
+#
+# Migrator is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+$LOAD_PATH.unshift('lib')
+
+require 'aef/migrator'
+require 'spec/mock_adapter'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification 
+name: migrator
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Alexander E. Fischer
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDKDCCAhCgAwIBAgIBADANBgkqhkiG9w0BAQUFADA6MQwwCgYDVQQDDANhZWYx
+  FTATBgoJkiaJk/IsZAEZFgVyYXh5czETMBEGCgmSJomT8ixkARkWA25ldDAeFw0w
+  OTAyMjUyMDM5MDhaFw0xMDAyMjUyMDM5MDhaMDoxDDAKBgNVBAMMA2FlZjEVMBMG
+  CgmSJomT8ixkARkWBXJheHlzMRMwEQYKCZImiZPyLGQBGRYDbmV0MIIBIjANBgkq
+  hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoYtj0qad5/MpbdttITzBH0h1SNe6eO7R
+  7qVeqNYu6qDQAQ0rYc0JhubJCWYrZEJorHEBhUFU6cdQgQOs78wiJaDgkeU7YfXB
+  q2l125kJ8aHkA1ukrK2/DRzp2AHEmzxHIYpXV5/63h+NWjCP+uKvTELYsotS2MKt
+  3d43E0QajsPZu2ZuNFwkroqeue872gMHUldGOVy5WtSd9ajw2xI/CociY6746dL+
+  pYriV3QaYtR/ezeaLpKBLsc5T1UQ07t7Xs7mI281tdmRvpLdP5dQhjzInfio0CJv
+  1Pf5bZUjGG0K9RW2Gb/tGPSYEETiLMubjH61OwBooXKiWR5cs4/1BQIDAQABozkw
+  NzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUSYvjhG2EWnR5kx5l
+  DAewXCkJOVEwDQYJKoZIhvcNAQEFBQADggEBAB2ryDbU4bQtnunKv/AXq4CuO3LS
+  kik9Xhye8E/5dTcsgitCZJXAqx0rHcK0u2EHnjA5CDcdF5JB7XgSvRrQkFWoW/9K
+  lCB4ih+sB2AI2IUiYBeoCGctXdBQ020prqop/oTQEudzFk/gyQ686lp06HdLRt+O
+  HoQjTIab8vmfgIubjPdIRzokMfHbelvhLi+mQfWVghRhs2jpEfdXbL0w5nNw+trp
+  rO70Dw59hduDUOpgpxew+PLbs4vP1tb1QKPG+39C+PZtosbbf1fai0hqYV1txMCx
+  55akF+N8NbO6tpVDy6TMagqa10LfEpiQH6dvDHe/xdAqYOCrXKpmqzwu2PI=
+  -----END CERTIFICATE-----
+
+date: 2009-09-17 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.2
+    version: 
+description: |-
+  Migrator is a Ruby library for building general purpose versioning systems in
+  the style of ActiveRecord's migrations.
+email: 
+- aef@raxys.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- Manifest.txt
+- History.txt
+- README.rdoc
+files: 
+- lib/aef/migrator/adapter.rb
+- lib/aef/migrator/migrator.rb
+- lib/aef/migrator/abstract_adapter.rb
+- lib/aef/migrator.rb
+- Manifest.txt
+- History.txt
+- Rakefile
+- .autotest
+- spec/spec_helper.rb
+- spec/mock_adapter.rb
+- spec/spec.opts
+- spec/migrator_spec.rb
+- README.rdoc
+has_rdoc: true
+homepage: https://rubyforge.org/projects/migrator/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+- --inline-source
+- --line-numbers
+- --title
+- Migrator
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: migrator
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Migrator is a Ruby library for building general purpose versioning systems in the style of ActiveRecord's migrations.
+test_files: []
+