promotion 1.4.7 → 2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 108a5dc05ae4bb258ba20b5b00a77707a4031176
+  data.tar.gz: c5a25b54336e9b6f5247cbda54812da242c3f7a9
+SHA512:
+  metadata.gz: 9497b89f2b3b4805d7db3f60fa64ee439475ad7e1f95b229876ecc94d3a120b02dda71c1a10fcfadd231b8620e5dc5af9c07634d23ec3b67dfdee68df74e6867
+  data.tar.gz: baa82d045a06c70f4118678baab14f6c6170f2209c76b441f6c2ae66dbaf91af90f57aebf578d12de1140b71740c162066a4120a7cc990fa7964d589301032fa

data/CHANGELOG

@@ -1,3 +1,8 @@
+== Version 2.0
+- Promotion no longer changes the system-wide files, such as /etc/rc.conf.local. Instead it just recommends what should be changed.
+- Upgraded for Ruby 2.0, since 1.8.7 is no longer supported.
+- Removed the log4r dependency in favour of the standard library Logger.
+
 == Version 1.4.7
 - Preserve empty lines in config files
 

data/README

@@ -1,6 +1,5 @@
 = Promotion
-Promotion makes it possible to repeatedly deploy an application in a fast and
-reliable way.
+Promotion makes it possible to repeatedly deploy an application in a fast and reliable way.
 
 == Staging
 A key concept is the *staging* area. It is a folder (+/var/staging+ by default)
@@ -48,11 +47,10 @@ files that need to be adjusted to enable an application to startup or run proper
 - /etc/sudoers
 - /var/cron/tabs/*
 
-Promotion generates these files based on the set of all of the deployment descriptors it finds
-in the staging area. It will preserve the original contents of the file, and append generated
-contents after the following special demarcation line:
-  #---promotion---
-This respects the need for an administrator to add custom contents (above the line).
+Deployment descriptors can include recommended settings for these sensitive system files, but it
+does not change them. That would be too intrusive. Instead, Promotion reads the files to check if the
+recommended entries are present, and if they are not it displays a message for the admin explaining
+what needs to be done.
 
 An important aspect is that a deployment is *idempotent* - you can do it as many
 times as you like and the result will be the same. This means its safe to make a
@@ -67,7 +65,7 @@ to suit your system's paths.
 
 == Installation
 *WARNING*::
- Promotion will makes changes to your operating system, including important system-wide files.
+ Promotion will makes changes to your operating system.
 
  DO NOT USE ON A PRODUCTION SYSTEM without rigorous testing in a virtual machine first.
 
@@ -235,9 +233,7 @@ The +User+ is the user running the process, typically an unprivileged user named
 Leave blank to run the startup script as root (eg. as when dropping privileges).
 
 === +Crontab+
-Cron jobs are often needed for an application to run smoothly. Instead of creating them by hand,
-you can specify each job as part of the deployment descriptor and let promotion set up the crontab
-automatically.
+Cron jobs are often needed for an application to run smoothly. 
   <Crontab>
     <Schedule User="root" Hour="2" Minute="7"
       Comment="Backup the entire database at 2:07am each morning">

data/lib/promotion/application.rb

@@ -3,8 +3,8 @@ require 'promotion/config'
 require 'promotion/enforcer'
 require 'promotion/generator'
 require 'promotion/evolver'
-require 'log4r'
-include Log4r
+require 'logger'
+require 'time'
 
 module Promotion	# :nodoc:
 
@@ -18,10 +18,11 @@ class Application
 	# A global +$log+ logger is also created.
 	def initialize(appname)
 		@appname = appname
-		$log = Logger.new(@appname)
-		FileOutputter[@appname] = FileOutputter.new(@appname, :filename => Files::Log)
-		FileOutputter[@appname].formatter = PatternFormatter.new(:pattern => "%d %m")
-		$log.outputters = FileOutputter[@appname]
+		$log = Logger.new(Files::Log, 0) # rotate log file at 1M limit
+		$log.formatter = proc { |severity, datetime, progname, message|
+      "#{datetime.iso8601()} #{severity} #{message}\n"
+    }
+		$log.level = Logger::INFO
 	end
 
 	# Promotes an application into production.

data/lib/promotion/generator/crontab.rb

@@ -3,65 +3,39 @@ module Generator
 module Crontab
 
   # The crontab for each user must be deployed using the crontab tool
-  def self.generate(specs)
-    sym = "Crontab"
-		begin
-			schedules = {}  # keyed on user, value is array of schedule elements
-			specs.each { |spec|
-				spec.elements.each("/Specification/Crontab/Schedule") { |sched|
-					user = sched.attributes["User"]
-					schedules[user] = [] unless schedules.has_key?(user)
-					schedules[user] << sched
-				}
-			}
-			schedules.each { |user, crontablist|
-				generatedContents = self.contents(user, crontablist)
-				userCrontab = File.expand_path(user, Folders::Crontabs)
-        begin
-					tempFilename = user + ".tmp"
-					tempFile = File.new(tempFilename, File::WRONLY | File::CREAT | File::TRUNC)
-					tempFile.puts(generatedContents)
-					# previous cron jobs are *NOT* preserved - the tab is competely generated!
-					# otherwise we accumulate the cron-generated warning messages at the top of the file
-				ensure
-					tempFile.close unless tempFile.nil? || tempFile.closed?
-				end
-				$log.info("Checking temporary crontab written to #{tempFilename}.")
-				crontabResults = `#{Files::Crontab} -u #{user} #{tempFilename}`
-				if $?.exitstatus == 0
-					$log.info("crontab confirms that crontab syntax is correct for user #{user}.")
-				else
-					$log.error(crontabResults)
-					raise
-				end
-				FileUtils.rm_f(tempFilename)
-				$log.info("New crontab installed for user #{user}")
-			}
-		rescue => e
-			$log.error("Error occurred while generating crontab\n#{e.message}" + e.backtrace.join("\n"))
-			exit 1
-		end
-  end
-
-  # Generates the contents for /var/cron/tabs/{user}, containing scheduled jobs
-  def self.contents(user, crontablist)
-    contents = []
-    contents << "# /var/cron/tabs/#{user} - #{user}'s crontab \n#\n"
-    contents << "#minute hour    mday    month   wday    command\n#\n\n"
-    crontablist.each { |sched|
-      if sched.attributes["Comment"]
-        contents << "#______________________________\n"
-        contents << "# #{sched.attributes["Comment"]} \n"
+  def self.check(specs)
+    schedules = {}  # keyed on user, value is array of schedule elements
+    specs.each { |spec|
+      spec.elements.each("/Specification/Crontab/Schedule") { |sched|
+        user = sched.attributes["User"]
+        schedules[user] = [] unless schedules.has_key?(user)
+        schedules[user] << sched
+      }
+    }
+    schedules.each { |user, crontablist|
+      userCrontab = File.expand_path(user, "/var/cron/tabs/")
+      contents = IO.readlines(userCrontab).collect!{ |s| s.gsub(/\s/,"") }
+      proposals = []
+      crontablist.each { |sched|
+        minute = sched.attributes["Minute"] || "*"
+        hour   = sched.attributes["Hour"]   || "*"
+        mday   = sched.attributes["DayOfMonth"] || "*"
+        month  = sched.attributes["Month"]  || "*"
+        wday   = sched.attributes["DayOfWeek"] || "*"
+        cmd    = (sched.elements["Command"].cdatas[0]).value().strip()
+        needed = minute + "\t" + hour + "\t" + mday + "\t" + month + "\t" + wday + "\t" + cmd
+        unless contents.include?(needed.gsub(/\s/,""))
+          if sched.attributes["Comment"]
+            proposals << "# #{sched.attributes["Comment"]}"
+          end
+          proposals << needed
+        end
+      }
+      if proposals.size > 0
+        header = "# min\thour\tmday\tmonth\twday\tcommand\n"
+        puts("\nSuggested changes to /var/cron/tabs/#{user}:", header, proposals.join("\n"), "\n")
       end
-      minute = sched.attributes["Minute"] || "*"
-      hour   = sched.attributes["Hour"]   || "*"
-      mday   = sched.attributes["DayOfMonth"] || "*"
-      month  = sched.attributes["Month"]  || "*"
-      wday   = sched.attributes["DayOfWeek"] || "*"
-      cmd    = (sched.elements["Command"].cdatas[0]).value().strip()
-      contents << minute + "\t" + hour + "\t" + mday + "\t" + month + "\t" + wday + "\t" + cmd + "\n"
     }
-    return(contents.join(""))
   end
 
 end

data/lib/promotion/generator/newsyslog.rb

@@ -3,29 +3,12 @@ module Generator
 module Newsyslog
 
   # Writes the Newsyslog configuration
-  def self.generate(specs)
-    sym = "Newsyslog"
-    begin
-      originalContents = Promotion::Generator::original_contents_for(sym)
-      newContents = originalContents + Marker + "\n" + contents(specs)
-      Promotion::Generator::write_file_for(sym, newContents)
-    rescue => e
-      $log.error("Error occurred while generating #{sym}\n#{e.message}" + e.backtrace.join("\n"))
-      exit 1
-    end
-  end
-
-  # Generates the contents for /etc/newsyslog.conf, which controls rolling and retention of logs
-  def self.contents(specs)
-    contents = []
-    contents << "# This section of the file should not be edited\n"
-    contents << "# It was generated by the promotion application and will be overwritten\n"
-    contents << "# when the next promotion occurs.\n"
-    contents << "# The previous section will be preserved\n\n"
-    contents << "# Filename                              Owner:Group         Mode   Count  Size   When     Flags   Command\n"
+  def self.check(specs)
+    contents = IO.readlines("/etc/newsyslog.conf").collect!{ |s| s.gsub(/\s/,"") }
+    proposals = []
     specs.each { |spec|
       spec.elements.each("/Specification/Newsyslog") { |nsl|
-        contents << "%-40s" % nsl.text()
+        needed = nsl.text() << "\t"
         owner = nsl.attributes["Owner"]
         group = nsl.attributes["Group"]
         if owner.nil? or group.nil?
@@ -33,31 +16,35 @@ module Newsyslog
         else
             og = owner + ":" + group
         end
-        contents << "%-20s" % og
-        contents << "%-7s" % (nsl.attributes["Mode"] || "0640")
-        contents << "%-7s" % (nsl.attributes["Count"] || "*")
-        contents << "%-7s" % (nsl.attributes["Size"] || "*")
+        needed << og << "\t"
+        needed << (nsl.attributes["Mode"] || "0640") << "\t"
+        needed << (nsl.attributes["Count"] || "*") << "\t"
+        needed << (nsl.attributes["Size"] || "*") << "\t"
         # treat as $-format if starts with D,W,M; treat as integer if integer
         # else treat as @-format if digits with a 'T'
         sched = nsl.attributes["When"] || "*"
         if sched[0..0] == "D" or sched[0..0] == "W" or sched[0..0] == "M"
-          contents << "$%-9s" % sched
+          needed << sched << "\t"
         elsif sched.include?("T")
-          contents << "@%-9s" % sched
+          needed << "@" << sched << "\t"
         else
-          contents << "%-9s" % sched
+          needed << sched << "\t"
         end
         # We normally do not want to add rotation messages or compress
-        contents << "Z" if (nsl.attributes["Zip"] || "false") == "true"
-        contents << "B" if (nsl.attributes["Binary"] || "true") == "true"
+        needed << "Z" if (nsl.attributes["Zip"] || "false") == "true"
+        needed << "B" if (nsl.attributes["Binary"] || "true") == "true"
         restart = nsl.attributes["Restart"]   # service to restart
         if restart
-          contents << "   /etc/rc.d/#{restart} restart "
+          needed << "\t/etc/rc.d/#{restart} restart >/dev/null 2>&1 "
         end
-        contents << "\n"
+        # see if its already present - check the pattern ignoring whitespace
+        proposals << needed unless contents.include?(needed.gsub(/\s/,""))
       }
     }
-    return(contents.join(""))
+    if proposals.size > 0
+      header = "# Filename\t\tOwner:Group\tMode\tCount\tSize\tWhen\tFlags\tCommand\n"
+      puts("\nSuggested changes to /etc/newsyslog.conf:", header, proposals.join("\n"), "\n")
+    end
   end
 
 end

data/lib/promotion/generator/profile.rb

@@ -3,39 +3,29 @@ module Generator
 module Profile
 
   # Writes the system profile
-  def self.generate(specs)
-    sym = "Profile"
-		begin
-      originalContents = Promotion::Generator::original_contents_for(sym)
-      newContents = originalContents + Marker + "\n" + contents(specs)
-			Promotion::Generator::write_file_for(sym, newContents)
-		rescue => e
-			$log.error("Error occurred while generating #{sym}\n#{e.message}" + e.backtrace.join("\n"))
-			exit 1
-		end
-  end
-
-  # Generates the contents for /etc/profile, containing environment variables and aliases
-  def self.contents(specs)
-    contents = []
-    contents << "# This section of the file should not be edited\n"
-    contents << "# It was generated by the promotion application and will be overwritten\n"
-    contents << "# when the next promotion occurs.\n"
-    contents << "# The previous section will be preserved\n"
+  def self.check(specs)
+    contents = IO.readlines("/etc/profile").collect!{ |s| s.strip() }
+    proposals = []
     specs.each { |spec|
       spec.elements.each("/Specification/Environment") { |env|
         env.elements.each("Variable") { |var|
           t = var.cdatas.length > 0 ? var.cdatas[0].to_s() : var.text()
-          contents << "export #{var.attributes["Name"]}=\"#{t}\" \n"
+          needed = "export #{var.attributes["Name"]}=\"#{t}\""
+          unless contents.include?(needed.strip())
+            proposals << needed
+          end
         }
         env.elements.each("Alias") { |ali|
           contents << "# #{ali.attributes["Comment"]}\n" if ali.attributes["Comment"]
           t = ali.cdatas.length > 0 ? ali.cdatas[0].to_s() : ali.text()
-          contents << "alias #{ali.attributes["Name"]}='#{t}' \n"
+          needed = "alias #{ali.attributes["Name"]}='#{t}'"
+          unless contents.include?(needed.strip())
+            proposals << needed
+          end
         }
       }
     }
-    return(contents.join(""))
+    puts("\nSuggested changes to /etc/profile:", proposals.join("\n"), "\n") if proposals.size > 0
   end
 
 end

data/lib/promotion/generator/rcconf.rb

@@ -3,27 +3,10 @@ module Generator
 module Rcconf
 
   # Writes the system file /etc/rc.conf.local
-  def self.generate(specs)
-    sym = "Rc_conf"
-		begin
-			originalContents = Promotion::Generator::original_contents_for(sym)
-      newContents = originalContents + Marker + "\n" + contents(specs)
-			Promotion::Generator::write_file_for(sym, newContents)
-		rescue => e
-			$log.error("Error occurred while generating #{sym}\n#{e.message}" + e.backtrace.join("\n"))
-			exit 1
-		end
-  end
-
-  # Generates the contents for /etc/rc.conf.local, containing instructions for running daemons
-  def self.contents(specs)
-    contents = []
-    contents << "# This section of the file should not be edited\n"
-    contents << "# It was generated by the promotion application and will be overwritten\n"
-    contents << "# when the next promotion occurs.\n"
-    contents << "# The previous section will be preserved\n"
-    contents << "# ---------------------------\n"
-    contents << "# generated application flags\n"
+  def self.check(specs)
+    contents = IO.readlines("/etc/rc.conf.local").collect!{ |s| s.strip() }
+    proposals = []
+    # Extract package scripts and sort them by increasing priority
     daemonSpecs = specs.reject {|s| s.elements["/Specification/Daemon"].nil? }
     daemonSpecs.sort!() { |a, b|
       ap = a.elements["/Specification/Daemon"].attributes["Priority"].to_i || 10
@@ -31,18 +14,22 @@ module Rcconf
       ap <=> bp
     }
     pkgScripts = []
-    daemonSpecs.each { |spec|   # allow for multiple daemons in a spec
-      spec.each_element("Daemon") { |d|
+    daemonSpecs.each { |spec|
+      spec.each_element("Daemon") { |d|  # allow for multiple daemons in a spec
         # Name defaults to the name of the spec, but may be overridden by the optional Name attribute
         name = d.attributes["Name"] || spec.attributes["Name"]
         flags = d.attributes["Flags"]
-        contents << "#{name}_flags=\"#{flags}\" \n"
+        needed = "#{name}_flags=\"#{flags}\""
+        proposals << needed unless contents.include?(needed.strip())
         pkgScripts << name
       }
     }
-    contents << "\n# rc.d(8) packages scripts, started in the specified order and stopped in reverse order\n"
-    contents << "pkg_scripts=\"${pkg_scripts} #{pkgScripts.join(" ")}\" \n"
-    return(contents.join(""))
+    puts("\nSuggested changes to /etc/rc.conf.local:", proposals.join("\n")) if proposals.size > 0
+    pkgList = pkgScripts.join(" ")
+    unless contents.join("\n") =~ /pkg_scripts.*#{pkgList}/
+      puts("pkg_scripts=\"${pkg_scripts} #{pkgList}\" ")
+    end
+    puts("") if proposals.size > 0
   end
 
 end

data/lib/promotion/generator/sudoers.rb

@@ -3,51 +3,23 @@ module Generator
 module Sudoers
 
   # Writes the sudoers file after testing it with visudo
-  def self.generate(specs)
-    sym = "Sudoers"
-		begin
-      originalContents = Promotion::Generator::original_contents_for(sym)
-      newContents = originalContents + Marker + "\n" + contents(specs)
-			tempFilename = Promotion::Generator::write_file_for(sym, newContents, true)
-			$log.info("Checking temporary sudoers written to #{tempFilename}.")
-			visudoResults = `#{Files::Visudo} -c -f #{tempFilename}`
-			if visudoResults =~ /parsed OK/
-				$log.info("visudo confirms that sudoers syntax is correct.")
-			else
-				$log.error(visudoResults)
-				raise
-			end
-			Promotion::Generator::write_file_for("Sudoers", newContents)
-			FileUtils.rm_f(tempFilename)
-		rescue => e
-			$log.error("Error occurred while generating sudoers\n#{e.message}" + e.backtrace.join("\n"))
-			exit 1
-		end
-  end
-
-  # Generates the contents for /etc/sudoers, containing environment variables and aliases
-  def self.contents(specs)
-    contents = []
-    contents << "# This section of the file should not be edited\n"
-    contents << "# It was generated by the promotion application and will be overwritten\n"
-    contents << "# when the next promotion occurs.\n"
-    contents << "# The previous section will be preserved\n\n"
-    contents << "Defaults timestamp_timeout=55\n\n"
-    contents << "root    ALL = (ALL) ALL \n"
-    contents << "# people in group wheel may run all commands \n"
-    contents << "%wheel  ALL = (ALL) ALL \n\n"
-    contents << "# Generated user privilege specifications \n"
+  def self.check(specs)
+    contents = IO.readlines("/etc/sudoers").collect!{ |s| s.strip() }
+    proposals = []
     specs.each { |spec|
       spec.elements.each("/Specification/Sudoers/UserPrivilege") { |priv|
-        contents << "%-16s" % priv.attributes["User"]
-        contents << " ALL = "
-        contents << "(#{priv.attributes["Runas"]}) " if priv.attributes["Runas"]
+        needed = "%-16s" % priv.attributes["User"]
+        needed << " ALL = "
+        needed << "(#{priv.attributes["Runas"]}) " if priv.attributes["Runas"]
         pwd = (priv.attributes["Password"] || "false").downcase() == "true"
-        contents <<  (pwd ? " " : "NOPASSWD: ")
-        contents << "#{priv.text().strip()} \n"
+        needed <<  (pwd ? " " : "NOPASSWD: ")
+        needed << "#{priv.text().strip()}"
+        proposals << needed unless contents.include?(needed.strip())
       }
     }
-    return(contents.join(""))
+    if proposals.size > 0
+      puts("\nSuggested changes to /etc/sudoers:", proposals.join("\n"), "\n") if proposals.size > 0
+    end
   end
 
 end

data/lib/promotion/generator.rb

@@ -8,16 +8,14 @@ require 'promotion/generator/crontab'
 module Promotion
 module Generator
 
-  Marker = "#---promotion---"	# add this marker to a config file to preserve the contents before it
-
   def self.start()
-		$log.info("\n#{'_'*40}\nGenerating common environment files")
+		$log.info("\n#{'_'*40}\nChecking common environment files")
 		specs = self.gather_specs()
-		Profile.generate(specs)
-		Rcconf.generate(specs)
-		Newsyslog.generate(specs)
-		Sudoers.generate(specs)
-		Crontab.generate(specs)
+		Profile.check(specs)
+		Rcconf.check(specs)
+		Newsyslog.check(specs)
+		Sudoers.check(specs)
+		Crontab.check(specs)
   end
 
 	# Gathers specs from all deployment descriptors in folders with the staging area
@@ -40,29 +38,5 @@ module Generator
 		end
 	end
 
-	# Write the approved contents to the system file
-	# or a temporary file instead if temp is true.
-	def self.write_file_for(sym, newContents, temp=false)
-		begin
-			filename = Files.const_get(sym) + (temp ? ".tmp" : "")
-			f = File.new(filename, File::WRONLY | File::CREAT | File::TRUNC)
-			f.puts(newContents)
-			$log.info("Generated #{sym} written to #{filename}.") unless temp
-		ensure
-			f.close unless f.nil? || f.closed?
-		end
-		return(filename)
-	end
-
-	# Returns a string of the new content for the file up to the +marker+
-	def self.original_contents_for(sym)
-		begin
-			originalContents = IO.readlines(Files.const_get(sym), nil)[0].split(Marker)[0]
-		rescue
-			originalContents = ""
-		end
-		return(originalContents)
-	end
-
 end
 end

metadata

@@ -1,59 +1,36 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: promotion
-version: !ruby/object:Gem::Version 
-  hash: 9
-  prerelease: 
-  segments: 
-  - 1
-  - 4
-  - 7
-  version: 1.4.7
+version: !ruby/object:Gem::Version
+  version: '2.0'
 platform: ruby
-authors: 
+authors:
 - Richard Kernahan
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-10-18 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: log4r
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 1
-        - 1
-        - 10
-        version: 1.1.10
-  type: :runtime
-  version_requirements: *id001
-description: "\t\tThe Promotion tool is designed to make it easy and quick to deploy an application\n\
-  \t\tinto production. Originally built for use with OpenBSD, it can be used on an *nix\n\
-  \t\tsystem by adjusting a few paths (in config.rb).\n\n\
-  \t\tTo deploy or install an application you just need to copy a few files into place, right?\n\
-  \t\tWell, the folders need to be there first of course, oh and the permissions need to be set,\n\
-  \t\tand I guess we need the right users set up before file ownerships can be set correctly,\n\
-  \t\twhich means we need groups before that ... ok, so there is more to it than copying a few files.\n\n\
-  \t\tThere are also system-wide settings that may need to be modified to support an application,\n\
-  \t\tsuch as environment variables in /etc/profile, /etc/sudoers,\n\
-  \t\tstartup scripts in /etc/rc.conf.local, and /var/cron/tabs/* cron jobs.\n\n\
-  \t\tPromotion handles all of this based on an XML deployment descriptor for each application,\n\
-  \t\tallowing rapid, reliable redeployment with a single line command. It also manages database\n\
-  \t\tschema migration.\n"
+date: 2013-10-30 00:00:00.000000000 Z
+dependencies: []
+description: "\t\tThe Promotion tool is designed to make it easy and quick to deploy
+  an application\n\t\tinto production. Originally built for use with OpenBSD, it can
+  be used on an *nix\n\t\tsystem by adjusting a few paths (in config.rb).\n\n\t\tTo
+  deploy or install an application you just need to copy a few files into place, right?\n\t\tWell,
+  the folders need to be there first of course, oh and the permissions need to be
+  set,\n\t\tand I guess we need the right users set up before file ownerships can
+  be set correctly,\n\t\twhich means we need groups before that ... ok, so there is
+  more to it than copying a few files.\n\n\t\tThere are also system-wide settings
+  that may need to be modified to support an application,\n\t\tsuch as environment
+  variables in /etc/profile, /etc/sudoers,\n\t\tstartup scripts in /etc/rc.conf.local,
+  and /var/cron/tabs/* cron jobs.\n\t\tPromotion does not modify these sensitive files,
+  but it does say what's missing or needs to be changed.\n\n\t\tPromotion handles
+  all of this based on an XML deployment descriptor for each application,\n\t\tallowing
+  rapid, reliable redeployment with a single line command. It also manages database\n\t\tschema
+  migration.\n"
 email: dev.promotion@finalstep.com.au
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README
-files: 
+files:
 - bin/promote
 - bin/evolve
 - bin/devolve
@@ -76,41 +53,32 @@ files:
 - README
 homepage: http://rubygems.org/gems/promotion
 licenses: []
-
-post_install_message: "\n\n  To install the executables (promote, evolve, devolve, mkdeploy)\n  issue the following command:\n\
-  \t$ sudo ruby -rubygems -e \"require 'promotion/install'\"\n\n  "
-rdoc_options: 
+metadata: {}
+post_install_message: "\n\n  To install the executables (promote, evolve, devolve,
+  mkdeploy)\n  issue the following command:\n\t$ sudo ruby -rubygems -e \"require
+  'promotion/install'\"\n\n  "
+rdoc_options:
 - --title
 - Promotion
 - --main
 - README
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+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: promotion
-rubygems_version: 1.8.24
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
-summary: Promotion makes it possible to repeatedly deploy an application in a fast and reliable way.
+specification_version: 4
+summary: Promotion makes it possible to repeatedly deploy an application in a fast
+  and reliable way.
 test_files: []
-
-has_rdoc: "true"