lib,test: replace connection query() method with sync_exec{,_params}.

[mailshears.git] / lib / mv / mv_runner.rb

diff --git a/lib/mv/mv_runner.rb b/lib/mv/mv_runner.rb
index 0e5e909e268944c25f2003e82eceb84bcc5b7bda..6a4413b412ee8256b0988518f8659c59c0fec245 100644 (file)
--- a/lib/mv/mv_runner.rb
+++ b/lib/mv/mv_runner.rb
@@ -2,9 +2,23 @@ require 'common/domain'
 require 'common/errors'
 require 'common/runner'
 
+# Perform the moving (renaming) of users/domains using {MvPlugin}s.
+#
 class MvRunner
   include Runner
 
+  # Run *plugin* to move the user *src* to *dst*. The method
+  # signature includes the unused *cfg* for consistency with the
+  # runners that do need a {Configuration}.
+  #
+  # @param cfg [Configuration] unused.
+  #
+  # @param plugin [Class] plugin class that will perform the move.
+  #
+  # @param src [User] the source user to be moved.
+  #
+  # @param dst [User] the destination user being moved to.
+  #
   def run(cfg, plugin, src, dst)
 
     if src.is_a?(Domain) or dst.is_a?(Domain) then
@@ -17,38 +31,24 @@ class MvRunner
       plugin.mv_user(src, dst)
       dst_description = plugin.describe(dst)
 
-      msg  = "Moved user #{src} "
-
-      # Only append the extra description if it's useful.
-      if not src_description.nil? and
-         not src_description.empty? and
-         not src_description == src.to_s() then
-        msg += "(#{src_description}) "
-      end
-
-      msg += "to #{dst}"
-
-      # Only append the extra description if it's useful.
-      if not dst_description.nil? and
-         not dst_description.empty? and
-         not dst_description == dst.to_s() then
-        msg += " (#{dst_description})"
-      end
-
+      msg  = "Moved user "
+      msg += add_description(src, src_description)
+      msg += " to "
+      msg += add_description(dst, dst_description)
       msg += "."
       report(plugin, msg)
 
-    rescue NonexistentUserError => e
+    rescue NonexistentUserError
       # This means that the SOURCE user didn't exist, since a
       # nonexistent destination user is perfectly expected.
       report(plugin, "Source user #{src.to_s()} not found.")
-    rescue NonexistentDomainError => e
+    rescue NonexistentDomainError
       # This could mean that the source domain doesn't exist, but in
       # that case, we just report that the source user doesn't
       # exist. So a nonexistent domain refers to a nonexistent
       # DESTINATION domain.
       report(plugin, "Destination domain #{dst.domainpart()} not found.")
-    rescue UserAlreadyExistsError => e
+    rescue UserAlreadyExistsError
       report(plugin, "Destination user #{dst.to_s()} already exists.")
     end
   end