Merge lp:~percona-toolkit-dev/percona-toolkit/remove-ptqa into lp:percona-toolkit/2.2

[Daniel Nichter]

[Daniel Nichter (daniel-nichter)]

review: Approve

=== modified file 'MANIFEST'
--- MANIFEST	2012-12-12 01:30:30 +0000
+++ MANIFEST	2013-03-13 21:03:23 +0000
@@ -22,7 +22,6 @@
 bin/pt-mysql-summary
 bin/pt-online-schema-change
 bin/pt-pmp
-bin/pt-query-advisor
 bin/pt-query-digest
 bin/pt-show-grants
 bin/pt-sift

=== removed file 'bin/pt-query-advisor'
--- bin/pt-query-advisor	2013-03-09 16:57:54 +0000
+++ bin/pt-query-advisor	1970-01-01 00:00:00 +0000
@@ -1,9483 +0,0 @@
-#!/usr/bin/env perl
-
-# This program is part of Percona Toolkit: http://www.percona.com/software/
-# See "COPYRIGHT, LICENSE, AND WARRANTY" at the end of this file for legal
-# notices and disclaimers.
-
-use strict;
-use warnings FATAL => 'all';
-
-# This tool is "fat-packed": most of its dependent modules are embedded
-# in this file.  Setting %INC to this file for each module makes Perl aware
-# of this so it will not try to load the module from @INC.  See the tool's
-# documentation for a full list of dependencies.
-BEGIN {
-   $INC{$_} = __FILE__ for map { (my $pkg = "$_.pm") =~ s!::!/!g; $pkg } (qw(
-      Percona::Toolkit
-      Lmo::Utils
-      Lmo::Meta
-      Lmo::Object
-      Lmo::Types
-      Lmo
-      DSNParser
-      OptionParser
-      Quoter
-      SlowLogParser
-      GeneralLogParser
-      QueryParser
-      QueryRewriter
-      Transformers
-      Daemon
-      Advisor
-      AdvisorRules
-      QueryAdvisorRules
-      PodParser
-      SQLParser
-      TableParser
-      ReportFormatter
-      HTTPMicro
-      VersionCheck
-   ));
-}
-
-# ###########################################################################
-# Percona::Toolkit package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Percona/Toolkit.pm
-#   t/lib/Percona/Toolkit.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Percona::Toolkit;
-our $VERSION = '2.1.8';
-
-1;
-}
-# ###########################################################################
-# End Percona::Toolkit package
-# ###########################################################################
-
-# ###########################################################################
-# Lmo::Utils package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Lmo/Utils.pm
-#   t/lib/Lmo/Utils.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Lmo::Utils;
-use strict;
-use warnings qw( FATAL all );
-require Exporter;
-our (@ISA, @EXPORT, @EXPORT_OK);
-
-BEGIN {
-   @ISA = qw(Exporter);
-   @EXPORT = @EXPORT_OK = qw(_install_coderef _unimport_coderefs _glob_for _stash_for);
-}
-
-{
-   no strict 'refs';
-   sub _glob_for {
-      return \*{shift()}
-   }
-
-   sub _stash_for {
-      return \%{ shift() . "::" };
-   }
-}
-
-sub _install_coderef {
-   my ($to, $code) = @_;
-
-   return *{ _glob_for $to } = $code;
-}
-
-sub _unimport_coderefs {
-   my ($target, @names) = @_;
-   return unless @names;
-   my $stash = _stash_for($target);
-   foreach my $name (@names) {
-      if ($stash->{$name} and defined(&{$stash->{$name}})) {
-         delete $stash->{$name};
-      }
-   }
-}
-
-1;
-}
-# ###########################################################################
-# End Lmo::Utils package
-# ###########################################################################
-
-# ###########################################################################
-# Lmo::Meta package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Lmo/Meta.pm
-#   t/lib/Lmo/Meta.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Lmo::Meta;
-use strict;
-use warnings qw( FATAL all );
-
-my %metadata_for;
-
-sub new {
-   my $class = shift;
-   return bless { @_ }, $class
-}
-
-sub metadata_for {
-   my $self    = shift;
-   my ($class) = @_;
-
-   return $metadata_for{$class} ||= {};
-}
-
-sub class { shift->{class} }
-
-sub attributes {
-   my $self = shift;
-   return keys %{$self->metadata_for($self->class)}
-}
-
-sub attributes_for_new {
-   my $self = shift;
-   my @attributes;
-
-   my $class_metadata = $self->metadata_for($self->class);
-   while ( my ($attr, $meta) = each %$class_metadata ) {
-      if ( exists $meta->{init_arg} ) {
-         push @attributes, $meta->{init_arg}
-               if defined $meta->{init_arg};
-      }
-      else {
-         push @attributes, $attr;
-      }
-   }
-   return @attributes;
-}
-
-1;
-}
-# ###########################################################################
-# End Lmo::Meta package
-# ###########################################################################
-
-# ###########################################################################
-# Lmo::Object package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Lmo/Object.pm
-#   t/lib/Lmo/Object.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Lmo::Object;
-
-use strict;
-use warnings qw( FATAL all );
-
-use Carp ();
-use Scalar::Util qw(blessed);
-
-use Lmo::Meta;
-use Lmo::Utils qw(_glob_for);
-
-sub new {
-   my $class = shift;
-   my $args  = $class->BUILDARGS(@_);
-
-   my $class_metadata = Lmo::Meta->metadata_for($class);
-
-   my @args_to_delete;
-   while ( my ($attr, $meta) = each %$class_metadata ) {
-      next unless exists $meta->{init_arg};
-      my $init_arg = $meta->{init_arg};
-
-      if ( defined $init_arg ) {
-         $args->{$attr} = delete $args->{$init_arg};
-      }
-      else {
-         push @args_to_delete, $attr;
-      }
-   }
-
-   delete $args->{$_} for @args_to_delete;
-
-   for my $attribute ( keys %$args ) {
-      if ( my $coerce = $class_metadata->{$attribute}{coerce} ) {
-         $args->{$attribute} = $coerce->($args->{$attribute});
-      }
-      if ( my $isa_check = $class_metadata->{$attribute}{isa} ) {
-         my ($check_name, $check_sub) = @$isa_check;
-         $check_sub->($args->{$attribute});
-      }
-   }
-
-   while ( my ($attribute, $meta) = each %$class_metadata ) {
-      next unless $meta->{required};
-      Carp::confess("Attribute ($attribute) is required for $class")
-         if ! exists $args->{$attribute}
-   }
-
-   my $self = bless $args, $class;
-
-   my @build_subs;
-   my $linearized_isa = mro::get_linear_isa($class);
-
-   for my $isa_class ( @$linearized_isa ) {
-      unshift @build_subs, *{ _glob_for "${isa_class}::BUILD" }{CODE};
-   }
-   my @args = %$args;
-   for my $sub (grep { defined($_) && exists &$_ } @build_subs) {
-      $sub->( $self, @args);
-   }
-   return $self;
-}
-
-sub BUILDARGS {
-   shift; # No need for the classname
-   if ( @_ == 1 && ref($_[0]) ) {
-      Carp::confess("Single parameters to new() must be a HASH ref, not $_[0]")
-         unless ref($_[0]) eq ref({});
-      return {%{$_[0]}} # We want a new reference, always
-   }
-   else {
-      return { @_ };
-   }
-}
-
-sub meta {
-   my $class = shift;
-   $class    = Scalar::Util::blessed($class) || $class;
-   return Lmo::Meta->new(class => $class);
-}
-
-
-1;
-}
-# ###########################################################################
-# End Lmo::Object package
-# ###########################################################################
-
-# ###########################################################################
-# Lmo::Types package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Lmo/Types.pm
-#   t/lib/Lmo/Types.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Lmo::Types;
-
-use strict;
-use warnings qw( FATAL all );
-
-use Carp ();
-use Scalar::Util qw(looks_like_number blessed);
-
-
-our %TYPES = (
-   Bool   => sub { !$_[0] || (defined $_[0] && looks_like_number($_[0]) && $_[0] == 1) },
-   Num    => sub { defined $_[0] && looks_like_number($_[0]) },
-   Int    => sub { defined $_[0] && looks_like_number($_[0]) && $_[0] == int($_[0]) },
-   Str    => sub { defined $_[0] },
-   Object => sub { defined $_[0] && blessed($_[0]) },
-   FileHandle => sub { local $@; require IO::Handle; fileno($_[0]) && $_[0]->opened },
-
-   map {
-      my $type = /R/ ? $_ : uc $_;
-      $_ . "Ref" => sub { ref $_[0] eq $type }
-   } qw(Array Code Hash Regexp Glob Scalar)
-);
-
-sub check_type_constaints {
-   my ($attribute, $type_check, $check_name, $val) = @_;
-   ( ref($type_check) eq 'CODE'
-      ? $type_check->($val)
-      : (ref $val eq $type_check
-         || ($val && $val eq $type_check)
-         || (exists $TYPES{$type_check} && $TYPES{$type_check}->($val)))
-   )
-   || Carp::confess(
-        qq<Attribute ($attribute) does not pass the type constraint because: >
-      . qq<Validation failed for '$check_name' with value >
-      . (defined $val ? Lmo::Dumper($val) : 'undef') )
-}
-
-sub _nested_constraints {
-   my ($attribute, $aggregate_type, $type) = @_;
-
-   my $inner_types;
-   if ( $type =~ /\A(ArrayRef|Maybe)\[(.*)\]\z/ ) {
-      $inner_types = _nested_constraints($1, $2);
-   }
-   else {
-      $inner_types = $TYPES{$type};
-   }
-
-   if ( $aggregate_type eq 'ArrayRef' ) {
-      return sub {
-         my ($val) = @_;
-         return unless ref($val) eq ref([]);
-
-         if ($inner_types) {
-            for my $value ( @{$val} ) {
-               return unless $inner_types->($value)
-            }
-         }
-         else {
-            for my $value ( @{$val} ) {
-               return unless $value && ($value eq $type
-                        || (Scalar::Util::blessed($value) && $value->isa($type)));
-            }
-         }
-         return 1;
-      };
-   }
-   elsif ( $aggregate_type eq 'Maybe' ) {
-      return sub {
-         my ($value) = @_;
-         return 1 if ! defined($value);
-         if ($inner_types) {
-            return unless $inner_types->($value)
-         }
-         else {
-            return unless $value eq $type
-                        || (Scalar::Util::blessed($value) && $value->isa($type));
-         }
-         return 1;
-      }
-   }
-   else {
-      Carp::confess("Nested aggregate types are only implemented for ArrayRefs and Maybe");
-   }
-}
-
-1;
-}
-# ###########################################################################
-# End Lmo::Types package
-# ###########################################################################
-
-# ###########################################################################
-# Lmo package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Lmo.pm
-#   t/lib/Lmo.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-BEGIN {
-$INC{"Lmo.pm"} = __FILE__;
-package Lmo;
-our $VERSION = '0.30_Percona'; # Forked from 0.30 of Mo.
-
-
-use strict;
-use warnings qw( FATAL all );
-
-use Carp ();
-use Scalar::Util qw(looks_like_number blessed);
-
-use Lmo::Meta;
-use Lmo::Object;
-use Lmo::Types;
-
-use Lmo::Utils;
-
-my %export_for;
-sub import {
-   warnings->import(qw(FATAL all));
-   strict->import();
-
-   my $caller     = scalar caller(); # Caller's package
-   my %exports = (
-      extends  => \&extends,
-      has      => \&has,
-      with     => \&with,
-      override => \&override,
-      confess  => \&Carp::confess,
-   );
-
-   $export_for{$caller} = \%exports;
-
-   for my $keyword ( keys %exports ) {
-      _install_coderef "${caller}::$keyword" => $exports{$keyword};
-   }
-
-   if ( !@{ *{ _glob_for "${caller}::ISA" }{ARRAY} || [] } ) {
-      @_ = "Lmo::Object";
-      goto *{ _glob_for "${caller}::extends" }{CODE};
-   }
-}
-
-sub extends {
-   my $caller = scalar caller();
-   for my $class ( @_ ) {
-      _load_module($class);
-   }
-   _set_package_isa($caller, @_);
-   _set_inherited_metadata($caller);
-}
-
-sub _load_module {
-   my ($class) = @_;
-   
-   (my $file = $class) =~ s{::|'}{/}g;
-   $file .= '.pm';
-   { local $@; eval { require "$file" } } # or warn $@;
-   return;
-}
-
-sub with {
-   my $package = scalar caller();
-   require Role::Tiny;
-   for my $role ( @_ ) {
-      _load_module($role);
-      _role_attribute_metadata($package, $role);
-   }
-   Role::Tiny->apply_roles_to_package($package, @_);
-}
-
-sub _role_attribute_metadata {
-   my ($package, $role) = @_;
-
-   my $package_meta = Lmo::Meta->metadata_for($package);
-   my $role_meta    = Lmo::Meta->metadata_for($role);
-
-   %$package_meta = (%$role_meta, %$package_meta);
-}
-
-sub has {
-   my $names  = shift;
-   my $caller = scalar caller();
-
-   my $class_metadata = Lmo::Meta->metadata_for($caller);
-   
-   for my $attribute ( ref $names ? @$names : $names ) {
-      my %args   = @_;
-      my $method = ($args{is} || '') eq 'ro'
-         ? sub {
-            Carp::confess("Cannot assign a value to a read-only accessor at reader ${caller}::${attribute}")
-               if $#_;
-            return $_[0]{$attribute};
-         }
-         : sub {
-            return $#_
-                  ? $_[0]{$attribute} = $_[1]
-                  : $_[0]{$attribute};
-         };
-
-      $class_metadata->{$attribute} = ();
-
-      if ( my $type_check = $args{isa} ) {
-         my $check_name = $type_check;
-         
-         if ( my ($aggregate_type, $inner_type) = $type_check =~ /\A(ArrayRef|Maybe)\[(.*)\]\z/ ) {
-            $type_check = Lmo::Types::_nested_constraints($attribute, $aggregate_type, $inner_type);
-         }
-         
-         my $check_sub = sub {
-            my ($new_val) = @_;
-            Lmo::Types::check_type_constaints($attribute, $type_check, $check_name, $new_val);
-         };
-         
-         $class_metadata->{$attribute}{isa} = [$check_name, $check_sub];
-         my $orig_method = $method;
-         $method = sub {
-            $check_sub->($_[1]) if $#_;
-            goto &$orig_method;
-         };
-      }
-
-      if ( my $builder = $args{builder} ) {
-         my $original_method = $method;
-         $method = sub {
-               $#_
-                  ? goto &$original_method
-                  : ! exists $_[0]{$attribute}
-                     ? $_[0]{$attribute} = $_[0]->$builder
-                     : goto &$original_method
-         };
-      }
-
-      if ( my $code = $args{default} ) {
-         Carp::confess("${caller}::${attribute}'s default is $code, but should be a coderef")
-               unless ref($code) eq 'CODE';
-         my $original_method = $method;
-         $method = sub {
-               $#_
-                  ? goto &$original_method
-                  : ! exists $_[0]{$attribute}
-                     ? $_[0]{$attribute} = $_[0]->$code
-                     : goto &$original_method
-         };
-      }
-
-      if ( my $role = $args{does} ) {
-         my $original_method = $method;
-         $method = sub {
-            if ( $#_ ) {
-               Carp::confess(qq<Attribute ($attribute) doesn't consume a '$role' role">)
-                  unless Scalar::Util::blessed($_[1]) && eval { $_[1]->does($role) }
-            }
-            goto &$original_method
-         };
-      }
-
-      if ( my $coercion = $args{coerce} ) {
-         $class_metadata->{$attribute}{coerce} = $coercion;
-         my $original_method = $method;
-         $method = sub {
-            if ( $#_ ) {
-               return $original_method->($_[0], $coercion->($_[1]))
-            }
-            goto &$original_method;
-         }
-      }
-
-      _install_coderef "${caller}::$attribute" => $method;
-
-      if ( $args{required} ) {
-         $class_metadata->{$attribute}{required} = 1;
-      }
-
-      if ($args{clearer}) {
-         _install_coderef "${caller}::$args{clearer}"
-            => sub { delete shift->{$attribute} }
-      }
-
-      if ($args{predicate}) {
-         _install_coderef "${caller}::$args{predicate}"
-            => sub { exists shift->{$attribute} }
-      }
-
-      if ($args{handles}) {
-         _has_handles($caller, $attribute, \%args);
-      }
-
-      if (exists $args{init_arg}) {
-         $class_metadata->{$attribute}{init_arg} = $args{init_arg};
-      }
-   }
-}
-
-sub _has_handles {
-   my ($caller, $attribute, $args) = @_;
-   my $handles = $args->{handles};
-
-   my $ref = ref $handles;
-   my $kv;
-   if ( $ref eq ref [] ) {
-         $kv = { map { $_,$_ } @{$handles} };
-   }
-   elsif ( $ref eq ref {} ) {
-         $kv = $handles;
-   }
-   elsif ( $ref eq ref qr// ) {
-         Carp::confess("Cannot delegate methods based on a Regexp without a type constraint (isa)")
-            unless $args->{isa};
-         my $target_class = $args->{isa};
-         $kv = {
-            map   { $_, $_     }
-            grep  { $_ =~ $handles }
-            grep  { !exists $Lmo::Object::{$_} && $target_class->can($_) }
-            grep  { !$export_for{$target_class}->{$_} }
-            keys %{ _stash_for $target_class }
-         };
-   }
-   else {
-         Carp::confess("handles for $ref not yet implemented");
-   }
-
-   while ( my ($method, $target) = each %{$kv} ) {
-         my $name = _glob_for "${caller}::$method";
-         Carp::confess("You cannot overwrite a locally defined method ($method) with a delegation")
-            if defined &$name;
-
-         my ($target, @curried_args) = ref($target) ? @$target : $target;
-         *$name = sub {
-            my $self        = shift;
-            my $delegate_to = $self->$attribute();
-            my $error = "Cannot delegate $method to $target because the value of $attribute";
-            Carp::confess("$error is not defined") unless $delegate_to;
-            Carp::confess("$error is not an object (got '$delegate_to')")
-               unless Scalar::Util::blessed($delegate_to) || (!ref($delegate_to) && $delegate_to->can($target));
-            return $delegate_to->$target(@curried_args, @_);
-         }
-   }
-}
-
-sub _set_package_isa {
-   my ($package, @new_isa) = @_;
-   my $package_isa  = \*{ _glob_for "${package}::ISA" };
-   @{*$package_isa} = @new_isa;
-}
-
-sub _set_inherited_metadata {
-   my $class = shift;
-   my $class_metadata = Lmo::Meta->metadata_for($class);
-   my $linearized_isa = mro::get_linear_isa($class);
-   my %new_metadata;
-
-   for my $isa_class (reverse @$linearized_isa) {
-      my $isa_metadata = Lmo::Meta->metadata_for($isa_class);
-      %new_metadata = (
-         %new_metadata,
-         %$isa_metadata,
-      );
-   }
-   %$class_metadata = %new_metadata;
-}
-
-sub unimport {
-   my $caller = scalar caller();
-   my $target = caller;
-  _unimport_coderefs($target, keys %{$export_for{$caller}});
-}
-
-sub Dumper {
-   require Data::Dumper;
-   local $Data::Dumper::Indent    = 0;
-   local $Data::Dumper::Sortkeys  = 0;
-   local $Data::Dumper::Quotekeys = 0;
-   local $Data::Dumper::Terse     = 1;
-
-   Data::Dumper::Dumper(@_)
-}
-
-BEGIN {
-   if ($] >= 5.010) {
-      { local $@; require mro; }
-   }
-   else {
-      local $@;
-      eval {
-         require MRO::Compat;
-      } or do {
-         *mro::get_linear_isa = *mro::get_linear_isa_dfs = sub {
-            no strict 'refs';
-
-            my $classname = shift;
-
-            my @lin = ($classname);
-            my %stored;
-            foreach my $parent (@{"$classname\::ISA"}) {
-               my $plin = mro::get_linear_isa_dfs($parent);
-               foreach (@$plin) {
-                     next if exists $stored{$_};
-                     push(@lin, $_);
-                     $stored{$_} = 1;
-               }
-            }
-            return \@lin;
-         };
-      }
-   }
-}
-
-sub override {
-   my ($methods, $code) = @_;
-   my $caller          = scalar caller;
-
-   for my $method ( ref($methods) ? @$methods : $methods ) {
-      my $full_method     = "${caller}::${method}";
-      *{_glob_for $full_method} = $code;
-   }
-}
-
-}
-1;
-}
-# ###########################################################################
-# End Lmo package
-# ###########################################################################
-
-# ###########################################################################
-# DSNParser package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/DSNParser.pm
-#   t/lib/DSNParser.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package DSNParser;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use Data::Dumper;
-$Data::Dumper::Indent    = 0;
-$Data::Dumper::Quotekeys = 0;
-
-my $dsn_sep = qr/(?<!\\),/;
-
-eval {
-   require DBI;
-};
-my $have_dbi = $EVAL_ERROR ? 0 : 1;
-
-sub new {
-   my ( $class, %args ) = @_;
-   foreach my $arg ( qw(opts) ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my $self = {
-      opts => {}  # h, P, u, etc.  Should come from DSN OPTIONS section in POD.
-   };
-   foreach my $opt ( @{$args{opts}} ) {
-      if ( !$opt->{key} || !$opt->{desc} ) {
-         die "Invalid DSN option: ", Dumper($opt);
-      }
-      PTDEBUG && _d('DSN option:',
-         join(', ',
-            map { "$_=" . (defined $opt->{$_} ? ($opt->{$_} || '') : 'undef') }
-               keys %$opt
-         )
-      );
-      $self->{opts}->{$opt->{key}} = {
-         dsn  => $opt->{dsn},
-         desc => $opt->{desc},
-         copy => $opt->{copy} || 0,
-      };
-   }
-   return bless $self, $class;
-}
-
-sub prop {
-   my ( $self, $prop, $value ) = @_;
-   if ( @_ > 2 ) {
-      PTDEBUG && _d('Setting', $prop, 'property');
-      $self->{$prop} = $value;
-   }
-   return $self->{$prop};
-}
-
-sub parse {
-   my ( $self, $dsn, $prev, $defaults ) = @_;
-   if ( !$dsn ) {
-      PTDEBUG && _d('No DSN to parse');
-      return;
-   }
-   PTDEBUG && _d('Parsing', $dsn);
-   $prev     ||= {};
-   $defaults ||= {};
-   my %given_props;
-   my %final_props;
-   my $opts = $self->{opts};
-
-   foreach my $dsn_part ( split($dsn_sep, $dsn) ) {
-      $dsn_part =~ s/\\,/,/g;
-      if ( my ($prop_key, $prop_val) = $dsn_part =~  m/^(.)=(.*)$/ ) {
-         $given_props{$prop_key} = $prop_val;
-      }
-      else {
-         PTDEBUG && _d('Interpreting', $dsn_part, 'as h=', $dsn_part);
-         $given_props{h} = $dsn_part;
-      }
-   }
-
-   foreach my $key ( keys %$opts ) {
-      PTDEBUG && _d('Finding value for', $key);
-      $final_props{$key} = $given_props{$key};
-      if (   !defined $final_props{$key}
-           && defined $prev->{$key} && $opts->{$key}->{copy} )
-      {
-         $final_props{$key} = $prev->{$key};
-         PTDEBUG && _d('Copying value for', $key, 'from previous DSN');
-      }
-      if ( !defined $final_props{$key} ) {
-         $final_props{$key} = $defaults->{$key};
-         PTDEBUG && _d('Copying value for', $key, 'from defaults');
-      }
-   }
-
-   foreach my $key ( keys %given_props ) {
-      die "Unknown DSN option '$key' in '$dsn'.  For more details, "
-            . "please use the --help option, or try 'perldoc $PROGRAM_NAME' "
-            . "for complete documentation."
-         unless exists $opts->{$key};
-   }
-   if ( (my $required = $self->prop('required')) ) {
-      foreach my $key ( keys %$required ) {
-         die "Missing required DSN option '$key' in '$dsn'.  For more details, "
-               . "please use the --help option, or try 'perldoc $PROGRAM_NAME' "
-               . "for complete documentation."
-            unless $final_props{$key};
-      }
-   }
-
-   return \%final_props;
-}
-
-sub parse_options {
-   my ( $self, $o ) = @_;
-   die 'I need an OptionParser object' unless ref $o eq 'OptionParser';
-   my $dsn_string
-      = join(',',
-          map  { "$_=".$o->get($_); }
-          grep { $o->has($_) && $o->get($_) }
-          keys %{$self->{opts}}
-        );
-   PTDEBUG && _d('DSN string made from options:', $dsn_string);
-   return $self->parse($dsn_string);
-}
-
-sub as_string {
-   my ( $self, $dsn, $props ) = @_;
-   return $dsn unless ref $dsn;
-   my @keys = $props ? @$props : sort keys %$dsn;
-   return join(',',
-      map  { "$_=" . ($_ eq 'p' ? '...' : $dsn->{$_}) }
-      grep {
-         exists $self->{opts}->{$_}
-         && exists $dsn->{$_}
-         && defined $dsn->{$_}
-      } @keys);
-}
-
-sub usage {
-   my ( $self ) = @_;
-   my $usage
-      = "DSN syntax is key=value[,key=value...]  Allowable DSN keys:\n\n"
-      . "  KEY  COPY  MEANING\n"
-      . "  ===  ====  =============================================\n";
-   my %opts = %{$self->{opts}};
-   foreach my $key ( sort keys %opts ) {
-      $usage .= "  $key    "
-             .  ($opts{$key}->{copy} ? 'yes   ' : 'no    ')
-             .  ($opts{$key}->{desc} || '[No description]')
-             . "\n";
-   }
-   $usage .= "\n  If the DSN is a bareword, the word is treated as the 'h' key.\n";
-   return $usage;
-}
-
-sub get_cxn_params {
-   my ( $self, $info ) = @_;
-   my $dsn;
-   my %opts = %{$self->{opts}};
-   my $driver = $self->prop('dbidriver') || '';
-   if ( $driver eq 'Pg' ) {
-      $dsn = 'DBI:Pg:dbname=' . ( $info->{D} || '' ) . ';'
-         . join(';', map  { "$opts{$_}->{dsn}=$info->{$_}" }
-                     grep { defined $info->{$_} }
-                     qw(h P));
-   }
-   else {
-      $dsn = 'DBI:mysql:' . ( $info->{D} || '' ) . ';'
-         . join(';', map  { "$opts{$_}->{dsn}=$info->{$_}" }
-                     grep { defined $info->{$_} }
-                     qw(F h P S A))
-         . ';mysql_read_default_group=client'
-         . ($info->{L} ? ';mysql_local_infile=1' : '');
-   }
-   PTDEBUG && _d($dsn);
-   return ($dsn, $info->{u}, $info->{p});
-}
-
-sub fill_in_dsn {
-   my ( $self, $dbh, $dsn ) = @_;
-   my $vars = $dbh->selectall_hashref('SHOW VARIABLES', 'Variable_name');
-   my ($user, $db) = $dbh->selectrow_array('SELECT USER(), DATABASE()');
-   $user =~ s/@.*//;
-   $dsn->{h} ||= $vars->{hostname}->{Value};
-   $dsn->{S} ||= $vars->{'socket'}->{Value};
-   $dsn->{P} ||= $vars->{port}->{Value};
-   $dsn->{u} ||= $user;
-   $dsn->{D} ||= $db;
-}
-
-sub get_dbh {
-   my ( $self, $cxn_string, $user, $pass, $opts ) = @_;
-   $opts ||= {};
-   my $defaults = {
-      AutoCommit         => 0,
-      RaiseError         => 1,
-      PrintError         => 0,
-      ShowErrorStatement => 1,
-      mysql_enable_utf8 => ($cxn_string =~ m/charset=utf8/i ? 1 : 0),
-   };
-   @{$defaults}{ keys %$opts } = values %$opts;
-   if (delete $defaults->{L}) { # L for LOAD DATA LOCAL INFILE, our own extension
-      $defaults->{mysql_local_infile} = 1;
-   }
-
-   if ( $opts->{mysql_use_result} ) {
-      $defaults->{mysql_use_result} = 1;
-   }
-
-   if ( !$have_dbi ) {
-      die "Cannot connect to MySQL because the Perl DBI module is not "
-         . "installed or not found.  Run 'perl -MDBI' to see the directories "
-         . "that Perl searches for DBI.  If DBI is not installed, try:\n"
-         . "  Debian/Ubuntu  apt-get install libdbi-perl\n"
-         . "  RHEL/CentOS    yum install perl-DBI\n"
-         . "  OpenSolaris    pkg install pkg:/SUNWpmdbi\n";
-
-   }
-
-   my $dbh;
-   my $tries = 2;
-   while ( !$dbh && $tries-- ) {
-      PTDEBUG && _d($cxn_string, ' ', $user, ' ', $pass, 
-         join(', ', map { "$_=>$defaults->{$_}" } keys %$defaults ));
-
-      $dbh = eval { DBI->connect($cxn_string, $user, $pass, $defaults) };
-
-      if ( !$dbh && $EVAL_ERROR ) {
-         if ( $EVAL_ERROR =~ m/locate DBD\/mysql/i ) {
-            die "Cannot connect to MySQL because the Perl DBD::mysql module is "
-               . "not installed or not found.  Run 'perl -MDBD::mysql' to see "
-               . "the directories that Perl searches for DBD::mysql.  If "
-               . "DBD::mysql is not installed, try:\n"
-               . "  Debian/Ubuntu  apt-get install libdbd-mysql-perl\n"
-               . "  RHEL/CentOS    yum install perl-DBD-MySQL\n"
-               . "  OpenSolaris    pgk install pkg:/SUNWapu13dbd-mysql\n";
-         }
-         elsif ( $EVAL_ERROR =~ m/not a compiled character set|character set utf8/ ) {
-            PTDEBUG && _d('Going to try again without utf8 support');
-            delete $defaults->{mysql_enable_utf8};
-         }
-         if ( !$tries ) {
-            die $EVAL_ERROR;
-         }
-      }
-   }
-
-   if ( $cxn_string =~ m/mysql/i ) {
-      my $sql;
-
-      $sql = 'SELECT @@SQL_MODE';
-      PTDEBUG && _d($dbh, $sql);
-      my ($sql_mode) = eval { $dbh->selectrow_array($sql) };
-      if ( $EVAL_ERROR ) {
-         die "Error getting the current SQL_MODE: $EVAL_ERROR";
-      }
-
-      if ( my ($charset) = $cxn_string =~ m/charset=([\w]+)/ ) {
-         $sql = qq{/*!40101 SET NAMES "$charset"*/};
-         PTDEBUG && _d($dbh, $sql);
-         eval { $dbh->do($sql) };
-         if ( $EVAL_ERROR ) {
-            die "Error setting NAMES to $charset: $EVAL_ERROR";
-         }
-         PTDEBUG && _d('Enabling charset for STDOUT');
-         if ( $charset eq 'utf8' ) {
-            binmode(STDOUT, ':utf8')
-               or die "Can't binmode(STDOUT, ':utf8'): $OS_ERROR";
-         }
-         else {
-            binmode(STDOUT) or die "Can't binmode(STDOUT): $OS_ERROR";
-         }
-      }
-
-      if ( my $vars = $self->prop('set-vars') ) {
-         $self->set_vars($dbh, $vars);
-      }
-
-      $sql = 'SET @@SQL_QUOTE_SHOW_CREATE = 1'
-            . '/*!40101, @@SQL_MODE=\'NO_AUTO_VALUE_ON_ZERO'
-            . ($sql_mode ? ",$sql_mode" : '')
-            . '\'*/';
-      PTDEBUG && _d($dbh, $sql);
-      eval { $dbh->do($sql) };
-      if ( $EVAL_ERROR ) {
-         die "Error setting SQL_QUOTE_SHOW_CREATE, SQL_MODE"
-           . ($sql_mode ? " and $sql_mode" : '')
-           . ": $EVAL_ERROR";
-      }
-   }
-
-   PTDEBUG && _d('DBH info: ',
-      $dbh,
-      Dumper($dbh->selectrow_hashref(
-         'SELECT DATABASE(), CONNECTION_ID(), VERSION()/*!50038 , @@hostname*/')),
-      'Connection info:',      $dbh->{mysql_hostinfo},
-      'Character set info:',   Dumper($dbh->selectall_arrayref(
-                     "SHOW VARIABLES LIKE 'character_set%'", { Slice => {}})),
-      '$DBD::mysql::VERSION:', $DBD::mysql::VERSION,
-      '$DBI::VERSION:',        $DBI::VERSION,
-   );
-
-   return $dbh;
-}
-
-sub get_hostname {
-   my ( $self, $dbh ) = @_;
-   if ( my ($host) = ($dbh->{mysql_hostinfo} || '') =~ m/^(\w+) via/ ) {
-      return $host;
-   }
-   my ( $hostname, $one ) = $dbh->selectrow_array(
-      'SELECT /*!50038 @@hostname, */ 1');
-   return $hostname;
-}
-
-sub disconnect {
-   my ( $self, $dbh ) = @_;
-   PTDEBUG && $self->print_active_handles($dbh);
-   $dbh->disconnect;
-}
-
-sub print_active_handles {
-   my ( $self, $thing, $level ) = @_;
-   $level ||= 0;
-   printf("# Active %sh: %s %s %s\n", ($thing->{Type} || 'undef'), "\t" x $level,
-      $thing, (($thing->{Type} || '') eq 'st' ? $thing->{Statement} || '' : ''))
-      or die "Cannot print: $OS_ERROR";
-   foreach my $handle ( grep {defined} @{ $thing->{ChildHandles} } ) {
-      $self->print_active_handles( $handle, $level + 1 );
-   }
-}
-
-sub copy {
-   my ( $self, $dsn_1, $dsn_2, %args ) = @_;
-   die 'I need a dsn_1 argument' unless $dsn_1;
-   die 'I need a dsn_2 argument' unless $dsn_2;
-   my %new_dsn = map {
-      my $key = $_;
-      my $val;
-      if ( $args{overwrite} ) {
-         $val = defined $dsn_1->{$key} ? $dsn_1->{$key} : $dsn_2->{$key};
-      }
-      else {
-         $val = defined $dsn_2->{$key} ? $dsn_2->{$key} : $dsn_1->{$key};
-      }
-      $key => $val;
-   } keys %{$self->{opts}};
-   return \%new_dsn;
-}
-
-sub set_vars {
-   my ($self, $dbh, $vars) = @_;
-
-   return unless $vars;
-
-   foreach my $var ( sort keys %$vars ) {
-      my $val = $vars->{$var}->{val};
-
-      (my $quoted_var = $var) =~ s/_/\\_/;
-      my ($var_exists, $current_val);
-      eval {
-         ($var_exists, $current_val) = $dbh->selectrow_array(
-            "SHOW VARIABLES LIKE '$quoted_var'");
-      };
-      my $e = $EVAL_ERROR;
-      if ( $e ) {
-         PTDEBUG && _d($e);
-      }
-
-      if ( $vars->{$var}->{default} && !$var_exists ) {
-         PTDEBUG && _d('Not setting default var', $var,
-            'because it does not exist');
-         next;
-      }
-
-      if ( $current_val && $current_val eq $val ) {
-         PTDEBUG && _d('Not setting var', $var, 'because its value',
-            'is already', $val);
-         next;
-      }
-
-      my $sql = "SET SESSION $var=$val";
-      PTDEBUG && _d($dbh, $sql);
-      eval { $dbh->do($sql) };
-      if ( my $set_error = $EVAL_ERROR ) {
-         chomp($set_error);
-         $set_error =~ s/ at \S+ line \d+//;
-         my $msg = "Error setting $var: $set_error";
-         if ( $current_val ) {
-            $msg .= "  The current value for $var is $current_val.  "
-                  . "If the variable is read only (not dynamic), specify "
-                  . "--set-vars $var=$current_val to avoid this warning, "
-                  . "else manually set the variable and restart MySQL.";
-         }
-         warn $msg . "\n\n";
-      }
-   }
-
-   return; 
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End DSNParser package
-# ###########################################################################
-
-# ###########################################################################
-# OptionParser package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/OptionParser.pm
-#   t/lib/OptionParser.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package OptionParser;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use List::Util qw(max);
-use Getopt::Long;
-use Data::Dumper;
-
-my $POD_link_re = '[LC]<"?([^">]+)"?>';
-
-sub new {
-   my ( $class, %args ) = @_;
-   my @required_args = qw();
-   foreach my $arg ( @required_args ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-
-   my ($program_name) = $PROGRAM_NAME =~ m/([.A-Za-z-]+)$/;
-   $program_name ||= $PROGRAM_NAME;
-   my $home = $ENV{HOME} || $ENV{HOMEPATH} || $ENV{USERPROFILE} || '.';
-
-   my %attributes = (
-      'type'       => 1,
-      'short form' => 1,
-      'group'      => 1,
-      'default'    => 1,
-      'cumulative' => 1,
-      'negatable'  => 1,
-   );
-
-   my $self = {
-      head1             => 'OPTIONS',        # These args are used internally
-      skip_rules        => 0,                # to instantiate another Option-
-      item              => '--(.*)',         # Parser obj that parses the
-      attributes        => \%attributes,     # DSN OPTIONS section.  Tools
-      parse_attributes  => \&_parse_attribs, # don't tinker with these args.
-
-      %args,
-
-      strict            => 1,  # disabled by a special rule
-      program_name      => $program_name,
-      opts              => {},
-      got_opts          => 0,
-      short_opts        => {},
-      defaults          => {},
-      groups            => {},
-      allowed_groups    => {},
-      errors            => [],
-      rules             => [],  # desc of rules for --help
-      mutex             => [],  # rule: opts are mutually exclusive
-      atleast1          => [],  # rule: at least one opt is required
-      disables          => {},  # rule: opt disables other opts 
-      defaults_to       => {},  # rule: opt defaults to value of other opt
-      DSNParser         => undef,
-      default_files     => [
-         "/etc/percona-toolkit/percona-toolkit.conf",
-         "/etc/percona-toolkit/$program_name.conf",
-         "$home/.percona-toolkit.conf",
-         "$home/.$program_name.conf",
-      ],
-      types             => {
-         string => 's', # standard Getopt type
-         int    => 'i', # standard Getopt type
-         float  => 'f', # standard Getopt type
-         Hash   => 'H', # hash, formed from a comma-separated list
-         hash   => 'h', # hash as above, but only if a value is given
-         Array  => 'A', # array, similar to Hash
-         array  => 'a', # array, similar to hash
-         DSN    => 'd', # DSN
-         size   => 'z', # size with kMG suffix (powers of 2^10)
-         time   => 'm', # time, with an optional suffix of s/h/m/d
-      },
-   };
-
-   return bless $self, $class;
-}
-
-sub get_specs {
-   my ( $self, $file ) = @_;
-   $file ||= $self->{file} || __FILE__;
-   my @specs = $self->_pod_to_specs($file);
-   $self->_parse_specs(@specs);
-
-   open my $fh, "<", $file or die "Cannot open $file: $OS_ERROR";
-   my $contents = do { local $/ = undef; <$fh> };
-   close $fh;
-   if ( $contents =~ m/^=head1 DSN OPTIONS/m ) {
-      PTDEBUG && _d('Parsing DSN OPTIONS');
-      my $dsn_attribs = {
-         dsn  => 1,
-         copy => 1,
-      };
-      my $parse_dsn_attribs = sub {
-         my ( $self, $option, $attribs ) = @_;
-         map {
-            my $val = $attribs->{$_};
-            if ( $val ) {
-               $val    = $val eq 'yes' ? 1
-                       : $val eq 'no'  ? 0
-                       :                 $val;
-               $attribs->{$_} = $val;
-            }
-         } keys %$attribs;
-         return {
-            key => $option,
-            %$attribs,
-         };
-      };
-      my $dsn_o = new OptionParser(
-         description       => 'DSN OPTIONS',
-         head1             => 'DSN OPTIONS',
-         dsn               => 0,         # XXX don't infinitely recurse!
-         item              => '\* (.)',  # key opts are a single character
-         skip_rules        => 1,         # no rules before opts
-         attributes        => $dsn_attribs,
-         parse_attributes  => $parse_dsn_attribs,
-      );
-      my @dsn_opts = map {
-         my $opts = {
-            key  => $_->{spec}->{key},
-            dsn  => $_->{spec}->{dsn},
-            copy => $_->{spec}->{copy},
-            desc => $_->{desc},
-         };
-         $opts;
-      } $dsn_o->_pod_to_specs($file);
-      $self->{DSNParser} = DSNParser->new(opts => \@dsn_opts);
-   }
-
-   if ( $contents =~ m/^=head1 VERSION\n\n^(.+)$/m ) {
-      $self->{version} = $1;
-      PTDEBUG && _d($self->{version});
-   }
-
-   return;
-}
-
-sub DSNParser {
-   my ( $self ) = @_;
-   return $self->{DSNParser};
-};
-
-sub get_defaults_files {
-   my ( $self ) = @_;
-   return @{$self->{default_files}};
-}
-
-sub _pod_to_specs {
-   my ( $self, $file ) = @_;
-   $file ||= $self->{file} || __FILE__;
-   open my $fh, '<', $file or die "Cannot open $file: $OS_ERROR";
-
-   my @specs = ();
-   my @rules = ();
-   my $para;
-
-   local $INPUT_RECORD_SEPARATOR = '';
-   while ( $para = <$fh> ) {
-      next unless $para =~ m/^=head1 $self->{head1}/;
-      last;
-   }
-
-   while ( $para = <$fh> ) {
-      last if $para =~ m/^=over/;
-      next if $self->{skip_rules};
-      chomp $para;
-      $para =~ s/\s+/ /g;
-      $para =~ s/$POD_link_re/$1/go;
-      PTDEBUG && _d('Option rule:', $para);
-      push @rules, $para;
-   }
-
-   die "POD has no $self->{head1} section" unless $para;
-
-   do {
-      if ( my ($option) = $para =~ m/^=item $self->{item}/ ) {
-         chomp $para;
-         PTDEBUG && _d($para);
-         my %attribs;
-
-         $para = <$fh>; # read next paragraph, possibly attributes
-
-         if ( $para =~ m/: / ) { # attributes
-            $para =~ s/\s+\Z//g;
-            %attribs = map {
-                  my ( $attrib, $val) = split(/: /, $_);
-                  die "Unrecognized attribute for --$option: $attrib"
-                     unless $self->{attributes}->{$attrib};
-                  ($attrib, $val);
-               } split(/; /, $para);
-            if ( $attribs{'short form'} ) {
-               $attribs{'short form'} =~ s/-//;
-            }
-            $para = <$fh>; # read next paragraph, probably short help desc
-         }
-         else {
-            PTDEBUG && _d('Option has no attributes');
-         }
-
-         $para =~ s/\s+\Z//g;
-         $para =~ s/\s+/ /g;
-         $para =~ s/$POD_link_re/$1/go;
-
-         $para =~ s/\.(?:\n.*| [A-Z].*|\Z)//s;
-         PTDEBUG && _d('Short help:', $para);
-
-         die "No description after option spec $option" if $para =~ m/^=item/;
-
-         if ( my ($base_option) =  $option =~ m/^\[no\](.*)/ ) {
-            $option = $base_option;
-            $attribs{'negatable'} = 1;
-         }
-
-         push @specs, {
-            spec  => $self->{parse_attributes}->($self, $option, \%attribs), 
-            desc  => $para
-               . (defined $attribs{default} ? " (default $attribs{default})" : ''),
-            group => ($attribs{'group'} ? $attribs{'group'} : 'default'),
-         };
-      }
-      while ( $para = <$fh> ) {
-         last unless $para;
-         if ( $para =~ m/^=head1/ ) {
-            $para = undef; # Can't 'last' out of a do {} block.
-            last;
-         }
-         last if $para =~ m/^=item /;
-      }
-   } while ( $para );
-
-   die "No valid specs in $self->{head1}" unless @specs;
-
-   close $fh;
-   return @specs, @rules;
-}
-
-sub _parse_specs {
-   my ( $self, @specs ) = @_;
-   my %disables; # special rule that requires deferred checking
-
-   foreach my $opt ( @specs ) {
-      if ( ref $opt ) { # It's an option spec, not a rule.
-         PTDEBUG && _d('Parsing opt spec:',
-            map { ($_, '=>', $opt->{$_}) } keys %$opt);
-
-         my ( $long, $short ) = $opt->{spec} =~ m/^([\w-]+)(?:\|([^!+=]*))?/;
-         if ( !$long ) {
-            die "Cannot parse long option from spec $opt->{spec}";
-         }
-         $opt->{long} = $long;
-
-         die "Duplicate long option --$long" if exists $self->{opts}->{$long};
-         $self->{opts}->{$long} = $opt;
-
-         if ( length $long == 1 ) {
-            PTDEBUG && _d('Long opt', $long, 'looks like short opt');
-            $self->{short_opts}->{$long} = $long;
-         }
-
-         if ( $short ) {
-            die "Duplicate short option -$short"
-               if exists $self->{short_opts}->{$short};
-            $self->{short_opts}->{$short} = $long;
-            $opt->{short} = $short;
-         }
-         else {
-            $opt->{short} = undef;
-         }
-
-         $opt->{is_negatable}  = $opt->{spec} =~ m/!/        ? 1 : 0;
-         $opt->{is_cumulative} = $opt->{spec} =~ m/\+/       ? 1 : 0;
-         $opt->{is_required}   = $opt->{desc} =~ m/required/ ? 1 : 0;
-
-         $opt->{group} ||= 'default';
-         $self->{groups}->{ $opt->{group} }->{$long} = 1;
-
-         $opt->{value} = undef;
-         $opt->{got}   = 0;
-
-         my ( $type ) = $opt->{spec} =~ m/=(.)/;
-         $opt->{type} = $type;
-         PTDEBUG && _d($long, 'type:', $type);
-
-
-         $opt->{spec} =~ s/=./=s/ if ( $type && $type =~ m/[HhAadzm]/ );
-
-         if ( (my ($def) = $opt->{desc} =~ m/default\b(?: ([^)]+))?/) ) {
-            $self->{defaults}->{$long} = defined $def ? $def : 1;
-            PTDEBUG && _d($long, 'default:', $def);
-         }
-
-         if ( $long eq 'config' ) {
-            $self->{defaults}->{$long} = join(',', $self->get_defaults_files());
-         }
-
-         if ( (my ($dis) = $opt->{desc} =~ m/(disables .*)/) ) {
-            $disables{$long} = $dis;
-            PTDEBUG && _d('Deferring check of disables rule for', $opt, $dis);
-         }
-
-         $self->{opts}->{$long} = $opt;
-      }
-      else { # It's an option rule, not a spec.
-         PTDEBUG && _d('Parsing rule:', $opt); 
-         push @{$self->{rules}}, $opt;
-         my @participants = $self->_get_participants($opt);
-         my $rule_ok = 0;
-
-         if ( $opt =~ m/mutually exclusive|one and only one/ ) {
-            $rule_ok = 1;
-            push @{$self->{mutex}}, \@participants;
-            PTDEBUG && _d(@participants, 'are mutually exclusive');
-         }
-         if ( $opt =~ m/at least one|one and only one/ ) {
-            $rule_ok = 1;
-            push @{$self->{atleast1}}, \@participants;
-            PTDEBUG && _d(@participants, 'require at least one');
-         }
-         if ( $opt =~ m/default to/ ) {
-            $rule_ok = 1;
-            $self->{defaults_to}->{$participants[0]} = $participants[1];
-            PTDEBUG && _d($participants[0], 'defaults to', $participants[1]);
-         }
-         if ( $opt =~ m/restricted to option groups/ ) {
-            $rule_ok = 1;
-            my ($groups) = $opt =~ m/groups ([\w\s\,]+)/;
-            my @groups = split(',', $groups);
-            %{$self->{allowed_groups}->{$participants[0]}} = map {
-               s/\s+//;
-               $_ => 1;
-            } @groups;
-         }
-         if( $opt =~ m/accepts additional command-line arguments/ ) {
-            $rule_ok = 1;
-            $self->{strict} = 0;
-            PTDEBUG && _d("Strict mode disabled by rule");
-         }
-
-         die "Unrecognized option rule: $opt" unless $rule_ok;
-      }
-   }
-
-   foreach my $long ( keys %disables ) {
-      my @participants = $self->_get_participants($disables{$long});
-      $self->{disables}->{$long} = \@participants;
-      PTDEBUG && _d('Option', $long, 'disables', @participants);
-   }
-
-   return; 
-}
-
-sub _get_participants {
-   my ( $self, $str ) = @_;
-   my @participants;
-   foreach my $long ( $str =~ m/--(?:\[no\])?([\w-]+)/g ) {
-      die "Option --$long does not exist while processing rule $str"
-         unless exists $self->{opts}->{$long};
-      push @participants, $long;
-   }
-   PTDEBUG && _d('Participants for', $str, ':', @participants);
-   return @participants;
-}
-
-sub opts {
-   my ( $self ) = @_;
-   my %opts = %{$self->{opts}};
-   return %opts;
-}
-
-sub short_opts {
-   my ( $self ) = @_;
-   my %short_opts = %{$self->{short_opts}};
-   return %short_opts;
-}
-
-sub set_defaults {
-   my ( $self, %defaults ) = @_;
-   $self->{defaults} = {};
-   foreach my $long ( keys %defaults ) {
-      die "Cannot set default for nonexistent option $long"
-         unless exists $self->{opts}->{$long};
-      $self->{defaults}->{$long} = $defaults{$long};
-      PTDEBUG && _d('Default val for', $long, ':', $defaults{$long});
-   }
-   return;
-}
-
-sub get_defaults {
-   my ( $self ) = @_;
-   return $self->{defaults};
-}
-
-sub get_groups {
-   my ( $self ) = @_;
-   return $self->{groups};
-}
-
-sub _set_option {
-   my ( $self, $opt, $val ) = @_;
-   my $long = exists $self->{opts}->{$opt}       ? $opt
-            : exists $self->{short_opts}->{$opt} ? $self->{short_opts}->{$opt}
-            : die "Getopt::Long gave a nonexistent option: $opt";
-
-   $opt = $self->{opts}->{$long};
-   if ( $opt->{is_cumulative} ) {
-      $opt->{value}++;
-   }
-   else {
-      $opt->{value} = $val;
-   }
-   $opt->{got} = 1;
-   PTDEBUG && _d('Got option', $long, '=', $val);
-}
-
-sub get_opts {
-   my ( $self ) = @_; 
-
-   foreach my $long ( keys %{$self->{opts}} ) {
-      $self->{opts}->{$long}->{got} = 0;
-      $self->{opts}->{$long}->{value}
-         = exists $self->{defaults}->{$long}       ? $self->{defaults}->{$long}
-         : $self->{opts}->{$long}->{is_cumulative} ? 0
-         : undef;
-   }
-   $self->{got_opts} = 0;
-
-   $self->{errors} = [];
-
-   if ( @ARGV && $ARGV[0] eq "--config" ) {
-      shift @ARGV;
-      $self->_set_option('config', shift @ARGV);
-   }
-   if ( $self->has('config') ) {
-      my @extra_args;
-      foreach my $filename ( split(',', $self->get('config')) ) {
-         eval {
-            push @extra_args, $self->_read_config_file($filename);
-         };
-         if ( $EVAL_ERROR ) {
-            if ( $self->got('config') ) {
-               die $EVAL_ERROR;
-            }
-            elsif ( PTDEBUG ) {
-               _d($EVAL_ERROR);
-            }
-         }
-      }
-      unshift @ARGV, @extra_args;
-   }
-
-   Getopt::Long::Configure('no_ignore_case', 'bundling');
-   GetOptions(
-      map    { $_->{spec} => sub { $self->_set_option(@_); } }
-      grep   { $_->{long} ne 'config' } # --config is handled specially above.
-      values %{$self->{opts}}
-   ) or $self->save_error('Error parsing options');
-
-   if ( exists $self->{opts}->{version} && $self->{opts}->{version}->{got} ) {
-      if ( $self->{version} ) {
-         print $self->{version}, "\n";
-      }
-      else {
-         print "Error parsing version.  See the VERSION section of the tool's documentation.\n";
-      }
-      exit 1;
-   }
-
-   if ( @ARGV && $self->{strict} ) {
-      $self->save_error("Unrecognized command-line options @ARGV");
-   }
-
-   foreach my $mutex ( @{$self->{mutex}} ) {
-      my @set = grep { $self->{opts}->{$_}->{got} } @$mutex;
-      if ( @set > 1 ) {
-         my $err = join(', ', map { "--$self->{opts}->{$_}->{long}" }
-                      @{$mutex}[ 0 .. scalar(@$mutex) - 2] )
-                 . ' and --'.$self->{opts}->{$mutex->[-1]}->{long}
-                 . ' are mutually exclusive.';
-         $self->save_error($err);
-      }
-   }
-
-   foreach my $required ( @{$self->{atleast1}} ) {
-      my @set = grep { $self->{opts}->{$_}->{got} } @$required;
-      if ( @set == 0 ) {
-         my $err = join(', ', map { "--$self->{opts}->{$_}->{long}" }
-                      @{$required}[ 0 .. scalar(@$required) - 2] )
-                 .' or --'.$self->{opts}->{$required->[-1]}->{long};
-         $self->save_error("Specify at least one of $err");
-      }
-   }
-
-   $self->_check_opts( keys %{$self->{opts}} );
-   $self->{got_opts} = 1;
-   return;
-}
-
-sub _check_opts {
-   my ( $self, @long ) = @_;
-   my $long_last = scalar @long;
-   while ( @long ) {
-      foreach my $i ( 0..$#long ) {
-         my $long = $long[$i];
-         next unless $long;
-         my $opt  = $self->{opts}->{$long};
-         if ( $opt->{got} ) {
-            if ( exists $self->{disables}->{$long} ) {
-               my @disable_opts = @{$self->{disables}->{$long}};
-               map { $self->{opts}->{$_}->{value} = undef; } @disable_opts;
-               PTDEBUG && _d('Unset options', @disable_opts,
-                  'because', $long,'disables them');
-            }
-
-            if ( exists $self->{allowed_groups}->{$long} ) {
-
-               my @restricted_groups = grep {
-                  !exists $self->{allowed_groups}->{$long}->{$_}
-               } keys %{$self->{groups}};
-
-               my @restricted_opts;
-               foreach my $restricted_group ( @restricted_groups ) {
-                  RESTRICTED_OPT:
-                  foreach my $restricted_opt (
-                     keys %{$self->{groups}->{$restricted_group}} )
-                  {
-                     next RESTRICTED_OPT if $restricted_opt eq $long;
-                     push @restricted_opts, $restricted_opt
-                        if $self->{opts}->{$restricted_opt}->{got};
-                  }
-               }
-
-               if ( @restricted_opts ) {
-                  my $err;
-                  if ( @restricted_opts == 1 ) {
-                     $err = "--$restricted_opts[0]";
-                  }
-                  else {
-                     $err = join(', ',
-                               map { "--$self->{opts}->{$_}->{long}" }
-                               grep { $_ } 
-                               @restricted_opts[0..scalar(@restricted_opts) - 2]
-                            )
-                          . ' or --'.$self->{opts}->{$restricted_opts[-1]}->{long};
-                  }
-                  $self->save_error("--$long is not allowed with $err");
-               }
-            }
-
-         }
-         elsif ( $opt->{is_required} ) { 
-            $self->save_error("Required option --$long must be specified");
-         }
-
-         $self->_validate_type($opt);
-         if ( $opt->{parsed} ) {
-            delete $long[$i];
-         }
-         else {
-            PTDEBUG && _d('Temporarily failed to parse', $long);
-         }
-      }
-
-      die "Failed to parse options, possibly due to circular dependencies"
-         if @long == $long_last;
-      $long_last = @long;
-   }
-
-   return;
-}
-
-sub _validate_type {
-   my ( $self, $opt ) = @_;
-   return unless $opt;
-
-   if ( !$opt->{type} ) {
-      $opt->{parsed} = 1;
-      return;
-   }
-
-   my $val = $opt->{value};
-
-   if ( $val && $opt->{type} eq 'm' ) {  # type time
-      PTDEBUG && _d('Parsing option', $opt->{long}, 'as a time value');
-      my ( $prefix, $num, $suffix ) = $val =~ m/([+-]?)(\d+)([a-z])?$/;
-      if ( !$suffix ) {
-         my ( $s ) = $opt->{desc} =~ m/\(suffix (.)\)/;
-         $suffix = $s || 's';
-         PTDEBUG && _d('No suffix given; using', $suffix, 'for',
-            $opt->{long}, '(value:', $val, ')');
-      }
-      if ( $suffix =~ m/[smhd]/ ) {
-         $val = $suffix eq 's' ? $num            # Seconds
-              : $suffix eq 'm' ? $num * 60       # Minutes
-              : $suffix eq 'h' ? $num * 3600     # Hours
-              :                  $num * 86400;   # Days
-         $opt->{value} = ($prefix || '') . $val;
-         PTDEBUG && _d('Setting option', $opt->{long}, 'to', $val);
-      }
-      else {
-         $self->save_error("Invalid time suffix for --$opt->{long}");
-      }
-   }
-   elsif ( $val && $opt->{type} eq 'd' ) {  # type DSN
-      PTDEBUG && _d('Parsing option', $opt->{long}, 'as a DSN');
-      my $prev = {};
-      my $from_key = $self->{defaults_to}->{ $opt->{long} };
-      if ( $from_key ) {
-         PTDEBUG && _d($opt->{long}, 'DSN copies from', $from_key, 'DSN');
-         if ( $self->{opts}->{$from_key}->{parsed} ) {
-            $prev = $self->{opts}->{$from_key}->{value};
-         }
-         else {
-            PTDEBUG && _d('Cannot parse', $opt->{long}, 'until',
-               $from_key, 'parsed');
-            return;
-         }
-      }
-      my $defaults = $self->{DSNParser}->parse_options($self);
-      $opt->{value} = $self->{DSNParser}->parse($val, $prev, $defaults);
-   }
-   elsif ( $val && $opt->{type} eq 'z' ) {  # type size
-      PTDEBUG && _d('Parsing option', $opt->{long}, 'as a size value');
-      $self->_parse_size($opt, $val);
-   }
-   elsif ( $opt->{type} eq 'H' || (defined $val && $opt->{type} eq 'h') ) {
-      $opt->{value} = { map { $_ => 1 } split(/(?<!\\),\s*/, ($val || '')) };
-   }
-   elsif ( $opt->{type} eq 'A' || (defined $val && $opt->{type} eq 'a') ) {
-      $opt->{value} = [ split(/(?<!\\),\s*/, ($val || '')) ];
-   }
-   else {
-      PTDEBUG && _d('Nothing to validate for option',
-         $opt->{long}, 'type', $opt->{type}, 'value', $val);
-   }
-
-   $opt->{parsed} = 1;
-   return;
-}
-
-sub get {
-   my ( $self, $opt ) = @_;
-   my $long = (length $opt == 1 ? $self->{short_opts}->{$opt} : $opt);
-   die "Option $opt does not exist"
-      unless $long && exists $self->{opts}->{$long};
-   return $self->{opts}->{$long}->{value};
-}
-
-sub got {
-   my ( $self, $opt ) = @_;
-   my $long = (length $opt == 1 ? $self->{short_opts}->{$opt} : $opt);
-   die "Option $opt does not exist"
-      unless $long && exists $self->{opts}->{$long};
-   return $self->{opts}->{$long}->{got};
-}
-
-sub has {
-   my ( $self, $opt ) = @_;
-   my $long = (length $opt == 1 ? $self->{short_opts}->{$opt} : $opt);
-   return defined $long ? exists $self->{opts}->{$long} : 0;
-}
-
-sub set {
-   my ( $self, $opt, $val ) = @_;
-   my $long = (length $opt == 1 ? $self->{short_opts}->{$opt} : $opt);
-   die "Option $opt does not exist"
-      unless $long && exists $self->{opts}->{$long};
-   $self->{opts}->{$long}->{value} = $val;
-   return;
-}
-
-sub save_error {
-   my ( $self, $error ) = @_;
-   push @{$self->{errors}}, $error;
-   return;
-}
-
-sub errors {
-   my ( $self ) = @_;
-   return $self->{errors};
-}
-
-sub usage {
-   my ( $self ) = @_;
-   warn "No usage string is set" unless $self->{usage}; # XXX
-   return "Usage: " . ($self->{usage} || '') . "\n";
-}
-
-sub descr {
-   my ( $self ) = @_;
-   warn "No description string is set" unless $self->{description}; # XXX
-   my $descr  = ($self->{description} || $self->{program_name} || '')
-              . "  For more details, please use the --help option, "
-              . "or try 'perldoc $PROGRAM_NAME' "
-              . "for complete documentation.";
-   $descr = join("\n", $descr =~ m/(.{0,80})(?:\s+|$)/g)
-      unless $ENV{DONT_BREAK_LINES};
-   $descr =~ s/ +$//mg;
-   return $descr;
-}
-
-sub usage_or_errors {
-   my ( $self, $file, $return ) = @_;
-   $file ||= $self->{file} || __FILE__;
-
-   if ( !$self->{description} || !$self->{usage} ) {
-      PTDEBUG && _d("Getting description and usage from SYNOPSIS in", $file);
-      my %synop = $self->_parse_synopsis($file);
-      $self->{description} ||= $synop{description};
-      $self->{usage}       ||= $synop{usage};
-      PTDEBUG && _d("Description:", $self->{description},
-         "\nUsage:", $self->{usage});
-   }
-
-   if ( $self->{opts}->{help}->{got} ) {
-      print $self->print_usage() or die "Cannot print usage: $OS_ERROR";
-      exit 0 unless $return;
-   }
-   elsif ( scalar @{$self->{errors}} ) {
-      print $self->print_errors() or die "Cannot print errors: $OS_ERROR";
-      exit 1 unless $return;
-   }
-
-   return;
-}
-
-sub print_errors {
-   my ( $self ) = @_;
-   my $usage = $self->usage() . "\n";
-   if ( (my @errors = @{$self->{errors}}) ) {
-      $usage .= join("\n  * ", 'Errors in command-line arguments:', @errors)
-              . "\n";
-   }
-   return $usage . "\n" . $self->descr();
-}
-
-sub print_usage {
-   my ( $self ) = @_;
-   die "Run get_opts() before print_usage()" unless $self->{got_opts};
-   my @opts = values %{$self->{opts}};
-
-   my $maxl = max(
-      map {
-         length($_->{long})               # option long name
-         + ($_->{is_negatable} ? 4 : 0)   # "[no]" if opt is negatable
-         + ($_->{type} ? 2 : 0)           # "=x" where x is the opt type
-      }
-      @opts);
-
-   my $maxs = max(0,
-      map {
-         length($_)
-         + ($self->{opts}->{$_}->{is_negatable} ? 4 : 0)
-         + ($self->{opts}->{$_}->{type} ? 2 : 0)
-      }
-      values %{$self->{short_opts}});
-
-   my $lcol = max($maxl, ($maxs + 3));
-   my $rcol = 80 - $lcol - 6;
-   my $rpad = ' ' x ( 80 - $rcol );
-
-   $maxs = max($lcol - 3, $maxs);
-
-   my $usage = $self->descr() . "\n" . $self->usage();
-
-   my @groups = reverse sort grep { $_ ne 'default'; } keys %{$self->{groups}};
-   push @groups, 'default';
-
-   foreach my $group ( reverse @groups ) {
-      $usage .= "\n".($group eq 'default' ? 'Options' : $group).":\n\n";
-      foreach my $opt (
-         sort { $a->{long} cmp $b->{long} }
-         grep { $_->{group} eq $group }
-         @opts )
-      {
-         my $long  = $opt->{is_negatable} ? "[no]$opt->{long}" : $opt->{long};
-         my $short = $opt->{short};
-         my $desc  = $opt->{desc};
-
-         $long .= $opt->{type} ? "=$opt->{type}" : "";
-
-         if ( $opt->{type} && $opt->{type} eq 'm' ) {
-            my ($s) = $desc =~ m/\(suffix (.)\)/;
-            $s    ||= 's';
-            $desc =~ s/\s+\(suffix .\)//;
-            $desc .= ".  Optional suffix s=seconds, m=minutes, h=hours, "
-                   . "d=days; if no suffix, $s is used.";
-         }
-         $desc = join("\n$rpad", grep { $_ } $desc =~ m/(.{0,$rcol}(?!\W))(?:\s+|(?<=\W)|$)/g);
-         $desc =~ s/ +$//mg;
-         if ( $short ) {
-            $usage .= sprintf("  --%-${maxs}s -%s  %s\n", $long, $short, $desc);
-         }
-         else {
-            $usage .= sprintf("  --%-${lcol}s  %s\n", $long, $desc);
-         }
-      }
-   }
-
-   $usage .= "\nOption types: s=string, i=integer, f=float, h/H/a/A=comma-separated list, d=DSN, z=size, m=time\n";
-
-   if ( (my @rules = @{$self->{rules}}) ) {
-      $usage .= "\nRules:\n\n";
-      $usage .= join("\n", map { "  $_" } @rules) . "\n";
-   }
-   if ( $self->{DSNParser} ) {
-      $usage .= "\n" . $self->{DSNParser}->usage();
-   }
-   $usage .= "\nOptions and values after processing arguments:\n\n";
-   foreach my $opt ( sort { $a->{long} cmp $b->{long} } @opts ) {
-      my $val   = $opt->{value};
-      my $type  = $opt->{type} || '';
-      my $bool  = $opt->{spec} =~ m/^[\w-]+(?:\|[\w-])?!?$/;
-      $val      = $bool              ? ( $val ? 'TRUE' : 'FALSE' )
-                : !defined $val      ? '(No value)'
-                : $type eq 'd'       ? $self->{DSNParser}->as_string($val)
-                : $type =~ m/H|h/    ? join(',', sort keys %$val)
-                : $type =~ m/A|a/    ? join(',', @$val)
-                :                    $val;
-      $usage .= sprintf("  --%-${lcol}s  %s\n", $opt->{long}, $val);
-   }
-   return $usage;
-}
-
-sub prompt_noecho {
-   shift @_ if ref $_[0] eq __PACKAGE__;
-   my ( $prompt ) = @_;
-   local $OUTPUT_AUTOFLUSH = 1;
-   print $prompt
-      or die "Cannot print: $OS_ERROR";
-   my $response;
-   eval {
-      require Term::ReadKey;
-      Term::ReadKey::ReadMode('noecho');
-      chomp($response = <STDIN>);
-      Term::ReadKey::ReadMode('normal');
-      print "\n"
-         or die "Cannot print: $OS_ERROR";
-   };
-   if ( $EVAL_ERROR ) {
-      die "Cannot read response; is Term::ReadKey installed? $EVAL_ERROR";
-   }
-   return $response;
-}
-
-sub _read_config_file {
-   my ( $self, $filename ) = @_;
-   open my $fh, "<", $filename or die "Cannot open $filename: $OS_ERROR\n";
-   my @args;
-   my $prefix = '--';
-   my $parse  = 1;
-
-   LINE:
-   while ( my $line = <$fh> ) {
-      chomp $line;
-      next LINE if $line =~ m/^\s*(?:\#|\;|$)/;
-      $line =~ s/\s+#.*$//g;
-      $line =~ s/^\s+|\s+$//g;
-      if ( $line eq '--' ) {
-         $prefix = '';
-         $parse  = 0;
-         next LINE;
-      }
-      if ( $parse
-         && (my($opt, $arg) = $line =~ m/^\s*([^=\s]+?)(?:\s*=\s*(.*?)\s*)?$/)
-      ) {
-         push @args, grep { defined $_ } ("$prefix$opt", $arg);
-      }
-      elsif ( $line =~ m/./ ) {
-         push @args, $line;
-      }
-      else {
-         die "Syntax error in file $filename at line $INPUT_LINE_NUMBER";
-      }
-   }
-   close $fh;
-   return @args;
-}
-
-sub read_para_after {
-   my ( $self, $file, $regex ) = @_;
-   open my $fh, "<", $file or die "Can't open $file: $OS_ERROR";
-   local $INPUT_RECORD_SEPARATOR = '';
-   my $para;
-   while ( $para = <$fh> ) {
-      next unless $para =~ m/^=pod$/m;
-      last;
-   }
-   while ( $para = <$fh> ) {
-      next unless $para =~ m/$regex/;
-      last;
-   }
-   $para = <$fh>;
-   chomp($para);
-   close $fh or die "Can't close $file: $OS_ERROR";
-   return $para;
-}
-
-sub clone {
-   my ( $self ) = @_;
-
-   my %clone = map {
-      my $hashref  = $self->{$_};
-      my $val_copy = {};
-      foreach my $key ( keys %$hashref ) {
-         my $ref = ref $hashref->{$key};
-         $val_copy->{$key} = !$ref           ? $hashref->{$key}
-                           : $ref eq 'HASH'  ? { %{$hashref->{$key}} }
-                           : $ref eq 'ARRAY' ? [ @{$hashref->{$key}} ]
-                           : $hashref->{$key};
-      }
-      $_ => $val_copy;
-   } qw(opts short_opts defaults);
-
-   foreach my $scalar ( qw(got_opts) ) {
-      $clone{$scalar} = $self->{$scalar};
-   }
-
-   return bless \%clone;     
-}
-
-sub _parse_size {
-   my ( $self, $opt, $val ) = @_;
-
-   if ( lc($val || '') eq 'null' ) {
-      PTDEBUG && _d('NULL size for', $opt->{long});
-      $opt->{value} = 'null';
-      return;
-   }
-
-   my %factor_for = (k => 1_024, M => 1_048_576, G => 1_073_741_824);
-   my ($pre, $num, $factor) = $val =~ m/^([+-])?(\d+)([kMG])?$/;
-   if ( defined $num ) {
-      if ( $factor ) {
-         $num *= $factor_for{$factor};
-         PTDEBUG && _d('Setting option', $opt->{y},
-            'to num', $num, '* factor', $factor);
-      }
-      $opt->{value} = ($pre || '') . $num;
-   }
-   else {
-      $self->save_error("Invalid size for --$opt->{long}: $val");
-   }
-   return;
-}
-
-sub _parse_attribs {
-   my ( $self, $option, $attribs ) = @_;
-   my $types = $self->{types};
-   return $option
-      . ($attribs->{'short form'} ? '|' . $attribs->{'short form'}   : '' )
-      . ($attribs->{'negatable'}  ? '!'                              : '' )
-      . ($attribs->{'cumulative'} ? '+'                              : '' )
-      . ($attribs->{'type'}       ? '=' . $types->{$attribs->{type}} : '' );
-}
-
-sub _parse_synopsis {
-   my ( $self, $file ) = @_;
-   $file ||= $self->{file} || __FILE__;
-   PTDEBUG && _d("Parsing SYNOPSIS in", $file);
-
-   local $INPUT_RECORD_SEPARATOR = '';  # read paragraphs
-   open my $fh, "<", $file or die "Cannot open $file: $OS_ERROR";
-   my $para;
-   1 while defined($para = <$fh>) && $para !~ m/^=head1 SYNOPSIS/;
-   die "$file does not contain a SYNOPSIS section" unless $para;
-   my @synop;
-   for ( 1..2 ) {  # 1 for the usage, 2 for the description
-      my $para = <$fh>;
-      push @synop, $para;
-   }
-   close $fh;
-   PTDEBUG && _d("Raw SYNOPSIS text:", @synop);
-   my ($usage, $desc) = @synop;
-   die "The SYNOPSIS section in $file is not formatted properly"
-      unless $usage && $desc;
-
-   $usage =~ s/^\s*Usage:\s+(.+)/$1/;
-   chomp $usage;
-
-   $desc =~ s/\n/ /g;
-   $desc =~ s/\s{2,}/ /g;
-   $desc =~ s/\. ([A-Z][a-z])/.  $1/g;
-   $desc =~ s/\s+$//;
-
-   return (
-      description => $desc,
-      usage       => $usage,
-   );
-};
-
-sub set_vars {
-   my ($self, $file) = @_;
-   $file ||= $self->{file} || __FILE__;
-
-   my %user_vars;
-   my $user_vars = $self->has('set-vars') ? $self->get('set-vars') : undef;
-   if ( $user_vars ) {
-      foreach my $var_val ( @$user_vars ) {
-         my ($var, $val) = $var_val =~ m/([^\s=]+)=(\S+)/;
-         die "Invalid --set-vars value: $var_val\n" unless $var && $val;
-         $user_vars{$var} = {
-            val     => $val,
-            default => 0,
-         };
-      }
-   }
-
-   my %default_vars;
-   my $default_vars = $self->read_para_after($file, qr/MAGIC_set_vars/);
-   if ( $default_vars ) {
-      %default_vars = map {
-         my $var_val = $_;
-         my ($var, $val) = $var_val =~ m/([^\s=]+)=(\S+)/;
-         die "Invalid --set-vars value: $var_val\n" unless $var && $val;
-         $var => {
-            val     => $val,
-            default => 1,
-         };
-      } split("\n", $default_vars);
-   }
-
-   my %vars = (
-      %default_vars, # first the tool's defaults
-      %user_vars,    # then the user's which overwrite the defaults
-   );
-   PTDEBUG && _d('--set-vars:', Dumper(\%vars));
-   return \%vars;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-if ( PTDEBUG ) {
-   print '# ', $^X, ' ', $], "\n";
-   if ( my $uname = `uname -a` ) {
-      $uname =~ s/\s+/ /g;
-      print "# $uname\n";
-   }
-   print '# Arguments: ',
-      join(' ', map { my $a = "_[$_]_"; $a =~ s/\n/\n# /g; $a; } @ARGV), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End OptionParser package
-# ###########################################################################
-
-# ###########################################################################
-# Quoter package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Quoter.pm
-#   t/lib/Quoter.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Quoter;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use Data::Dumper;
-$Data::Dumper::Indent    = 1;
-$Data::Dumper::Sortkeys  = 1;
-$Data::Dumper::Quotekeys = 0;
-
-sub new {
-   my ( $class, %args ) = @_;
-   return bless {}, $class;
-}
-
-sub quote {
-   my ( $self, @vals ) = @_;
-   foreach my $val ( @vals ) {
-      $val =~ s/`/``/g;
-   }
-   return join('.', map { '`' . $_ . '`' } @vals);
-}
-
-sub quote_val {
-   my ( $self, $val, %args ) = @_;
-
-   return 'NULL' unless defined $val;          # undef = NULL
-   return "''" if $val eq '';                  # blank string = ''
-   return $val if $val =~ m/^0x[0-9a-fA-F]+$/  # quote hex data
-                  && !$args{is_char};          # unless is_char is true
-
-   $val =~ s/(['\\])/\\$1/g;
-   return "'$val'";
-}
-
-sub split_unquote {
-   my ( $self, $db_tbl, $default_db ) = @_;
-   my ( $db, $tbl ) = split(/[.]/, $db_tbl);
-   if ( !$tbl ) {
-      $tbl = $db;
-      $db  = $default_db;
-   }
-   for ($db, $tbl) {
-      next unless $_;
-      s/\A`//;
-      s/`\z//;
-      s/``/`/g;
-   }
-   
-   return ($db, $tbl);
-}
-
-sub literal_like {
-   my ( $self, $like ) = @_;
-   return unless $like;
-   $like =~ s/([%_])/\\$1/g;
-   return "'$like'";
-}
-
-sub join_quote {
-   my ( $self, $default_db, $db_tbl ) = @_;
-   return unless $db_tbl;
-   my ($db, $tbl) = split(/[.]/, $db_tbl);
-   if ( !$tbl ) {
-      $tbl = $db;
-      $db  = $default_db;
-   }
-   $db  = "`$db`"  if $db  && $db  !~ m/^`/;
-   $tbl = "`$tbl`" if $tbl && $tbl !~ m/^`/;
-   return $db ? "$db.$tbl" : $tbl;
-}
-
-sub serialize_list {
-   my ( $self, @args ) = @_;
-   PTDEBUG && _d('Serializing', Dumper(\@args));
-   return unless @args;
-
-   my @parts;
-   foreach my $arg  ( @args ) {
-      if ( defined $arg ) {
-         $arg =~ s/,/\\,/g;      # escape commas
-         $arg =~ s/\\N/\\\\N/g;  # escape literal \N
-         push @parts, $arg;
-      }
-      else {
-         push @parts, '\N';
-      }
-   }
-
-   my $string = join(',', @parts);
-   PTDEBUG && _d('Serialized: <', $string, '>');
-   return $string;
-}
-
-sub deserialize_list {
-   my ( $self, $string ) = @_;
-   PTDEBUG && _d('Deserializing <', $string, '>');
-   die "Cannot deserialize an undefined string" unless defined $string;
-
-   my @parts;
-   foreach my $arg ( split(/(?<!\\),/, $string) ) {
-      if ( $arg eq '\N' ) {
-         $arg = undef;
-      }
-      else {
-         $arg =~ s/\\,/,/g;
-         $arg =~ s/\\\\N/\\N/g;
-      }
-      push @parts, $arg;
-   }
-
-   if ( !@parts ) {
-      my $n_empty_strings = $string =~ tr/,//;
-      $n_empty_strings++;
-      PTDEBUG && _d($n_empty_strings, 'empty strings');
-      map { push @parts, '' } 1..$n_empty_strings;
-   }
-   elsif ( $string =~ m/(?<!\\),$/ ) {
-      PTDEBUG && _d('Last value is an empty string');
-      push @parts, '';
-   }
-
-   PTDEBUG && _d('Deserialized', Dumper(\@parts));
-   return @parts;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End Quoter package
-# ###########################################################################
-
-# ###########################################################################
-# SlowLogParser package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/SlowLogParser.pm
-#   t/lib/SlowLogParser.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package SlowLogParser;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use Data::Dumper;
-$Data::Dumper::Indent    = 1;
-$Data::Dumper::Sortkeys  = 1;
-$Data::Dumper::Quotekeys = 0;
-
-sub new {
-   my ( $class ) = @_;
-   my $self = {
-      pending => [],
-   };
-   return bless $self, $class;
-}
-
-my $slow_log_ts_line = qr/^# Time: ([0-9: ]{15})/;
-my $slow_log_uh_line = qr/# User\@Host: ([^\[]+|\[[^[]+\]).*?@ (\S*) \[(.*)\]/;
-my $slow_log_hd_line = qr{
-      ^(?:
-      T[cC][pP]\s[pP]ort:\s+\d+ # case differs on windows/unix
-      |
-      [/A-Z].*mysqld,\sVersion.*(?:started\swith:|embedded\slibrary)
-      |
-      Time\s+Id\s+Command
-      ).*\n
-   }xm;
-
-sub parse_event {
-   my ( $self, %args ) = @_;
-   my @required_args = qw(next_event tell);
-   foreach my $arg ( @required_args ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my ($next_event, $tell) = @args{@required_args};
-
-   my $pending = $self->{pending};
-   local $INPUT_RECORD_SEPARATOR = ";\n#";
-   my $trimlen    = length($INPUT_RECORD_SEPARATOR);
-   my $pos_in_log = $tell->();
-   my $stmt;
-
-   EVENT:
-   while (
-         defined($stmt = shift @$pending)
-      or defined($stmt = $next_event->())
-   ) {
-      my @properties = ('cmd', 'Query', 'pos_in_log', $pos_in_log);
-      $pos_in_log = $tell->();
-
-      if ( $stmt =~ s/$slow_log_hd_line//go ){ # Throw away header lines in log
-         my @chunks = split(/$INPUT_RECORD_SEPARATOR/o, $stmt);
-         if ( @chunks > 1 ) {
-            PTDEBUG && _d("Found multiple chunks");
-            $stmt = shift @chunks;
-            unshift @$pending, @chunks;
-         }
-      }
-
-      $stmt = '#' . $stmt unless $stmt =~ m/\A#/;
-      $stmt =~ s/;\n#?\Z//;
-
-
-      my ($got_ts, $got_uh, $got_ac, $got_db, $got_set, $got_embed);
-      my $pos = 0;
-      my $len = length($stmt);
-      my $found_arg = 0;
-      LINE:
-      while ( $stmt =~ m/^(.*)$/mg ) { # /g is important, requires scalar match.
-         $pos     = pos($stmt);  # Be careful not to mess this up!
-         my $line = $1;          # Necessary for /g and pos() to work.
-         PTDEBUG && _d($line);
-
-         if ($line =~ m/^(?:#|use |SET (?:last_insert_id|insert_id|timestamp))/o) {
-
-            if ( !$got_ts && (my ( $time ) = $line =~ m/$slow_log_ts_line/o)) {
-               PTDEBUG && _d("Got ts", $time);
-               push @properties, 'ts', $time;
-               ++$got_ts;
-               if ( !$got_uh
-                  && ( my ( $user, $host, $ip ) = $line =~ m/$slow_log_uh_line/o )
-               ) {
-                  PTDEBUG && _d("Got user, host, ip", $user, $host, $ip);
-                  push @properties, 'user', $user, 'host', $host, 'ip', $ip;
-                  ++$got_uh;
-               }
-            }
-
-            elsif ( !$got_uh
-                  && ( my ( $user, $host, $ip ) = $line =~ m/$slow_log_uh_line/o )
-            ) {
-               PTDEBUG && _d("Got user, host, ip", $user, $host, $ip);
-               push @properties, 'user', $user, 'host', $host, 'ip', $ip;
-               ++$got_uh;
-            }
-
-            elsif (!$got_ac && $line =~ m/^# (?:administrator command:.*)$/) {
-               PTDEBUG && _d("Got admin command");
-               $line =~ s/^#\s+//;  # string leading "# ".
-               push @properties, 'cmd', 'Admin', 'arg', $line;
-               push @properties, 'bytes', length($properties[-1]);
-               ++$found_arg;
-               ++$got_ac;
-            }
-
-            elsif ( $line =~ m/^# +[A-Z][A-Za-z_]+: \S+/ ) { # Make the test cheap!
-               PTDEBUG && _d("Got some line with properties");
-
-               if ( $line =~ m/Schema:\s+\w+: / ) {
-                  PTDEBUG && _d('Removing empty Schema attrib');
-                  $line =~ s/Schema:\s+//;
-                  PTDEBUG && _d($line);
-               }
-
-               my @temp = $line =~ m/(\w+):\s+(\S+|\Z)/g;
-               push @properties, @temp;
-            }
-
-            elsif ( !$got_db && (my ( $db ) = $line =~ m/^use ([^;]+)/ ) ) {
-               PTDEBUG && _d("Got a default database:", $db);
-               push @properties, 'db', $db;
-               ++$got_db;
-            }
-
-            elsif (!$got_set && (my ($setting) = $line =~ m/^SET\s+([^;]*)/)) {
-               PTDEBUG && _d("Got some setting:", $setting);
-               push @properties, split(/,|\s*=\s*/, $setting);
-               ++$got_set;
-            }
-
-            if ( !$found_arg && $pos == $len ) {
-               PTDEBUG && _d("Did not find arg, looking for special cases");
-               local $INPUT_RECORD_SEPARATOR = ";\n";  # get next line
-               if ( defined(my $l = $next_event->()) ) {
-                  if ( $l =~ /^\s*[A-Z][a-z_]+: / ) {
-                     PTDEBUG && _d("Found NULL query before", $l);
-                     local $INPUT_RECORD_SEPARATOR = ";\n#";
-                     my $rest_of_event = $next_event->();
-                     push @{$self->{pending}}, $l . $rest_of_event;
-                     push @properties, 'cmd', 'Query', 'arg', '/* No query */';
-                     push @properties, 'bytes', 0;
-                     $found_arg++;
-                  }
-                  else {
-                     chomp $l;
-                     $l =~ s/^\s+//;
-                     PTDEBUG && _d("Found admin statement", $l);
-                     push @properties, 'cmd', 'Admin', 'arg', $l;
-                     push @properties, 'bytes', length($properties[-1]);
-                     $found_arg++;
-                  }
-               }
-               else {
-                  PTDEBUG && _d("I can't figure out what to do with this line");
-                  next EVENT;
-               }
-            }
-         }
-         else {
-            PTDEBUG && _d("Got the query/arg line");
-            my $arg = substr($stmt, $pos - length($line));
-            push @properties, 'arg', $arg, 'bytes', length($arg);
-            if ( $args{misc} && $args{misc}->{embed}
-               && ( my ($e) = $arg =~ m/($args{misc}->{embed})/)
-            ) {
-               push @properties, $e =~ m/$args{misc}->{capture}/g;
-            }
-            last LINE;
-         }
-      }
-
-      PTDEBUG && _d('Properties of event:', Dumper(\@properties));
-      my $event = { @properties };
-      if ( $args{stats} ) {
-         $args{stats}->{events_read}++;
-         $args{stats}->{events_parsed}++;
-      }
-      return $event;
-   } # EVENT
-
-   @$pending = ();
-   $args{oktorun}->(0) if $args{oktorun};
-   return;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End SlowLogParser package
-# ###########################################################################
-
-# ###########################################################################
-# GeneralLogParser package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/GeneralLogParser.pm
-#   t/lib/GeneralLogParser.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package GeneralLogParser;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use Data::Dumper;
-$Data::Dumper::Indent    = 1;
-$Data::Dumper::Sortkeys  = 1;
-$Data::Dumper::Quotekeys = 0;
-
-sub new {
-   my ( $class ) = @_;
-   my $self = {
-      pending => [],
-      db_for  => {},
-   };
-   return bless $self, $class;
-}
-
-my $genlog_line_1= qr{
-   \A
-   (?:(\d{6}\s+\d{1,2}:\d\d:\d\d))? # Timestamp
-   \s+
-   (?:\s*(\d+))                     # Thread ID
-   \s
-   (\w+)                            # Command
-   \s+
-   (.*)                             # Argument
-   \Z
-}xs;
-
-sub parse_event {
-   my ( $self, %args ) = @_;
-   my @required_args = qw(next_event tell);
-   foreach my $arg ( @required_args ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my ($next_event, $tell) = @args{@required_args};
-
-   my $pending = $self->{pending};
-   my $db_for  = $self->{db_for};
-   my $line;
-   my $pos_in_log = $tell->();
-   LINE:
-   while (
-         defined($line = shift @$pending)
-      or defined($line = $next_event->())
-   ) {
-      PTDEBUG && _d($line);
-      my ($ts, $thread_id, $cmd, $arg) = $line =~ m/$genlog_line_1/;
-      if ( !($thread_id && $cmd) ) {
-         PTDEBUG && _d('Not start of general log event');
-         next;
-      }
-      my @properties = ('pos_in_log', $pos_in_log, 'ts', $ts,
-         'Thread_id', $thread_id);
-
-      $pos_in_log = $tell->();
-
-      @$pending = ();
-      if ( $cmd eq 'Query' ) {
-         my $done = 0;
-         do {
-            $line = $next_event->();
-            if ( $line ) {
-               my (undef, $next_thread_id, $next_cmd)
-                  = $line =~ m/$genlog_line_1/;
-               if ( $next_thread_id && $next_cmd ) {
-                  PTDEBUG && _d('Event done');
-                  $done = 1;
-                  push @$pending, $line;
-               }
-               else {
-                  PTDEBUG && _d('More arg:', $line);
-                  $arg .= $line;
-               }
-            }
-            else {
-               PTDEBUG && _d('No more lines');
-               $done = 1;
-            }
-         } until ( $done );
-
-         chomp $arg;
-         push @properties, 'cmd', 'Query', 'arg', $arg;
-         push @properties, 'bytes', length($properties[-1]);
-         push @properties, 'db', $db_for->{$thread_id} if $db_for->{$thread_id};
-      }
-      else {
-         push @properties, 'cmd', 'Admin';
-
-         if ( $cmd eq 'Connect' ) {
-            if ( $arg =~ m/^Access denied/ ) {
-               $cmd = $arg;
-            }
-            else {
-               my ($user) = $arg =~ m/(\S+)/;
-               my ($db)   = $arg =~ m/on (\S+)/;
-               my $host;
-               ($user, $host) = split(/@/, $user);
-               PTDEBUG && _d('Connect', $user, '@', $host, 'on', $db);
-
-               push @properties, 'user', $user if $user;
-               push @properties, 'host', $host if $host;
-               push @properties, 'db',   $db   if $db;
-               $db_for->{$thread_id} = $db;
-            }
-         }
-         elsif ( $cmd eq 'Init' ) {
-            $cmd = 'Init DB';
-            $arg =~ s/^DB\s+//;
-            my ($db) = $arg =~ /(\S+)/;
-            PTDEBUG && _d('Init DB:', $db);
-            push @properties, 'db',   $db   if $db;
-            $db_for->{$thread_id} = $db;
-         }
-
-         push @properties, 'arg', "administrator command: $cmd";
-         push @properties, 'bytes', length($properties[-1]);
-      }
-
-      push @properties, 'Query_time', 0;
-
-      PTDEBUG && _d('Properties of event:', Dumper(\@properties));
-      my $event = { @properties };
-      if ( $args{stats} ) {
-         $args{stats}->{events_read}++;
-         $args{stats}->{events_parsed}++;
-      }
-      return $event;
-   } # LINE
-
-   @{$self->{pending}} = ();
-   $args{oktorun}->(0) if $args{oktorun};
-   return;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End GeneralLogParser package
-# ###########################################################################
-
-# ###########################################################################
-# QueryParser package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/QueryParser.pm
-#   t/lib/QueryParser.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package QueryParser;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-our $tbl_ident = qr/(?:`[^`]+`|\w+)(?:\.(?:`[^`]+`|\w+))?/;
-our $tbl_regex = qr{
-         \b(?:FROM|JOIN|(?<!KEY\s)UPDATE|INTO) # Words that precede table names
-         \b\s*
-         \(?                                   # Optional paren around tables
-         ($tbl_ident
-            (?: (?:\s+ (?:AS\s+)? \w+)?, \s*$tbl_ident )*
-         )
-      }xio;
-our $has_derived = qr{
-      \b(?:FROM|JOIN|,)
-      \s*\(\s*SELECT
-   }xi;
-
-our $data_def_stmts = qr/(?:CREATE|ALTER|TRUNCATE|DROP|RENAME)/i;
-
-our $data_manip_stmts = qr/(?:INSERT|UPDATE|DELETE|REPLACE)/i;
-
-sub new {
-   my ( $class ) = @_;
-   bless {}, $class;
-}
-
-sub get_tables {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   PTDEBUG && _d('Getting tables for', $query);
-
-   my ( $ddl_stmt ) = $query =~ m/^\s*($data_def_stmts)\b/i;
-   if ( $ddl_stmt ) {
-      PTDEBUG && _d('Special table type:', $ddl_stmt);
-      $query =~ s/IF\s+(?:NOT\s+)?EXISTS//i;
-      if ( $query =~ m/$ddl_stmt DATABASE\b/i ) {
-         PTDEBUG && _d('Query alters a database, not a table');
-         return ();
-      }
-      if ( $ddl_stmt =~ m/CREATE/i && $query =~ m/$ddl_stmt\b.+?\bSELECT\b/i ) {
-         my ($select) = $query =~ m/\b(SELECT\b.+)/is;
-         PTDEBUG && _d('CREATE TABLE ... SELECT:', $select);
-         return $self->get_tables($select);
-      }
-      my ($tbl) = $query =~ m/TABLE\s+($tbl_ident)(\s+.*)?/i;
-      PTDEBUG && _d('Matches table:', $tbl);
-      return ($tbl);
-   }
-
-   $query =~ s/ (?:LOW_PRIORITY|IGNORE|STRAIGHT_JOIN)//ig;
-
-   if ( $query =~ s/^\s*LOCK TABLES\s+//i ) {
-      PTDEBUG && _d('Special table type: LOCK TABLES');
-      $query =~ s/\s+(?:READ(?:\s+LOCAL)?|WRITE)\s*//gi;
-      PTDEBUG && _d('Locked tables:', $query);
-      $query = "FROM $query";
-   }
-
-   $query =~ s/\\["']//g;                # quoted strings
-   $query =~ s/".*?"/?/sg;               # quoted strings
-   $query =~ s/'.*?'/?/sg;               # quoted strings
-
-   my @tables;
-   foreach my $tbls ( $query =~ m/$tbl_regex/gio ) {
-      PTDEBUG && _d('Match tables:', $tbls);
-
-      next if $tbls =~ m/\ASELECT\b/i;
-
-      foreach my $tbl ( split(',', $tbls) ) {
-         $tbl =~ s/\s*($tbl_ident)(\s+.*)?/$1/gio;
-
-         if ( $tbl !~ m/[a-zA-Z]/ ) {
-            PTDEBUG && _d('Skipping suspicious table name:', $tbl);
-            next;
-         }
-
-         push @tables, $tbl;
-      }
-   }
-   return @tables;
-}
-
-sub has_derived_table {
-   my ( $self, $query ) = @_;
-   my $match = $query =~ m/$has_derived/;
-   PTDEBUG && _d($query, 'has ' . ($match ? 'a' : 'no') . ' derived table');
-   return $match;
-}
-
-sub get_aliases {
-   my ( $self, $query, $list ) = @_;
-
-   my $result = {
-      DATABASE => {},
-      TABLE    => {},
-   };
-   return $result unless $query;
-
-   $query =~ s/ (?:LOW_PRIORITY|IGNORE|STRAIGHT_JOIN)//ig;
-
-   $query =~ s/ (?:INNER|OUTER|CROSS|LEFT|RIGHT|NATURAL)//ig;
-
-   my @tbl_refs;
-   my ($tbl_refs, $from) = $query =~ m{
-      (
-         (FROM|INTO|UPDATE)\b\s*   # Keyword before table refs
-         .+?                       # Table refs
-      )
-      (?:\s+|\z)                   # If the query does not end with the table
-      (?:WHERE|ORDER|LIMIT|HAVING|SET|VALUES|\z) # Keyword after table refs
-   }ix;
-
-   if ( $tbl_refs ) {
-
-      if ( $query =~ m/^(?:INSERT|REPLACE)/i ) {
-         $tbl_refs =~ s/\([^\)]+\)\s*//;
-      }
-
-      PTDEBUG && _d('tbl refs:', $tbl_refs);
-
-      my $before_tbl = qr/(?:,|JOIN|\s|$from)+/i;
-
-      my $after_tbl  = qr/(?:,|JOIN|ON|USING|\z)/i;
-
-      $tbl_refs =~ s/ = /=/g;
-
-      while (
-         $tbl_refs =~ m{
-            $before_tbl\b\s*
-               ( ($tbl_ident) (?:\s+ (?:AS\s+)? (\w+))? )
-            \s*$after_tbl
-         }xgio )
-      {
-         my ( $tbl_ref, $db_tbl, $alias ) = ($1, $2, $3);
-         PTDEBUG && _d('Match table:', $tbl_ref);
-         push @tbl_refs, $tbl_ref;
-         $alias = $self->trim_identifier($alias);
-
-         if ( $tbl_ref =~ m/^AS\s+\w+/i ) {
-            PTDEBUG && _d('Subquery', $tbl_ref);
-            $result->{TABLE}->{$alias} = undef;
-            next;
-         }
-
-         my ( $db, $tbl ) = $db_tbl =~ m/^(?:(.*?)\.)?(.*)/;
-         $db  = $self->trim_identifier($db);
-         $tbl = $self->trim_identifier($tbl);
-         $result->{TABLE}->{$alias || $tbl} = $tbl;
-         $result->{DATABASE}->{$tbl}        = $db if $db;
-      }
-   }
-   else {
-      PTDEBUG && _d("No tables ref in", $query);
-   }
-
-   if ( $list ) {
-      return \@tbl_refs;
-   }
-   else {
-      return $result;
-   }
-}
-
-sub split {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   $query = $self->clean_query($query);
-   PTDEBUG && _d('Splitting', $query);
-
-   my $verbs = qr{SELECT|INSERT|UPDATE|DELETE|REPLACE|UNION|CREATE}i;
-
-   my @split_statements = grep { $_ } split(m/\b($verbs\b(?!(?:\s*\()))/io, $query);
-
-   my @statements;
-   if ( @split_statements == 1 ) {
-      push @statements, $query;
-   }
-   else {
-      for ( my $i = 0; $i <= $#split_statements; $i += 2 ) {
-         push @statements, $split_statements[$i].$split_statements[$i+1];
-
-         if ( $statements[-2] && $statements[-2] =~ m/on duplicate key\s+$/i ) {
-            $statements[-2] .= pop @statements;
-         }
-      }
-   }
-
-   PTDEBUG && _d('statements:', map { $_ ? "<$_>" : 'none' } @statements);
-   return @statements;
-}
-
-sub clean_query {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   $query =~ s!/\*.*?\*/! !g;  # Remove /* comment blocks */
-   $query =~ s/^\s+//;         # Remove leading spaces
-   $query =~ s/\s+$//;         # Remove trailing spaces
-   $query =~ s/\s{2,}/ /g;     # Remove extra spaces
-   return $query;
-}
-
-sub split_subquery {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   $query = $self->clean_query($query);
-   $query =~ s/;$//;
-
-   my @subqueries;
-   my $sqno = 0;  # subquery number
-   my $pos  = 0;
-   while ( $query =~ m/(\S+)(?:\s+|\Z)/g ) {
-      $pos = pos($query);
-      my $word = $1;
-      PTDEBUG && _d($word, $sqno);
-      if ( $word =~ m/^\(?SELECT\b/i ) {
-         my $start_pos = $pos - length($word) - 1;
-         if ( $start_pos ) {
-            $sqno++;
-            PTDEBUG && _d('Subquery', $sqno, 'starts at', $start_pos);
-            $subqueries[$sqno] = {
-               start_pos => $start_pos,
-               end_pos   => 0,
-               len       => 0,
-               words     => [$word],
-               lp        => 1, # left parentheses
-               rp        => 0, # right parentheses
-               done      => 0,
-            };
-         }
-         else {
-            PTDEBUG && _d('Main SELECT at pos 0');
-         }
-      }
-      else {
-         next unless $sqno;  # next unless we're in a subquery
-         PTDEBUG && _d('In subquery', $sqno);
-         my $sq = $subqueries[$sqno];
-         if ( $sq->{done} ) {
-            PTDEBUG && _d('This subquery is done; SQL is for',
-               ($sqno - 1 ? "subquery $sqno" : "the main SELECT"));
-            next;
-         }
-         push @{$sq->{words}}, $word;
-         my $lp = ($word =~ tr/\(//) || 0;
-         my $rp = ($word =~ tr/\)//) || 0;
-         PTDEBUG && _d('parentheses left', $lp, 'right', $rp);
-         if ( ($sq->{lp} + $lp) - ($sq->{rp} + $rp) == 0 ) {
-            my $end_pos = $pos - 1;
-            PTDEBUG && _d('Subquery', $sqno, 'ends at', $end_pos);
-            $sq->{end_pos} = $end_pos;
-            $sq->{len}     = $end_pos - $sq->{start_pos};
-         }
-      }
-   }
-
-   for my $i ( 1..$#subqueries ) {
-      my $sq = $subqueries[$i];
-      next unless $sq;
-      $sq->{sql} = join(' ', @{$sq->{words}});
-      substr $query,
-         $sq->{start_pos} + 1,  # +1 for (
-         $sq->{len} - 1,        # -1 for )
-         "__subquery_$i";
-   }
-
-   return $query, map { $_->{sql} } grep { defined $_ } @subqueries;
-}
-
-sub query_type {
-   my ( $self, $query, $qr ) = @_;
-   my ($type, undef) = $qr->distill_verbs($query);
-   my $rw;
-   if ( $type =~ m/^SELECT\b/ ) {
-      $rw = 'read';
-   }
-   elsif ( $type =~ m/^$data_manip_stmts\b/
-           || $type =~ m/^$data_def_stmts\b/  ) {
-      $rw = 'write'
-   }
-
-   return {
-      type => $type,
-      rw   => $rw,
-   }
-}
-
-sub get_columns {
-   my ( $self, $query ) = @_;
-   my $cols = [];
-   return $cols unless $query;
-   my $cols_def;
-
-   if ( $query =~ m/^SELECT/i ) {
-      $query =~ s/
-         ^SELECT\s+
-           (?:ALL
-              |DISTINCT
-              |DISTINCTROW
-              |HIGH_PRIORITY
-              |STRAIGHT_JOIN
-              |SQL_SMALL_RESULT
-              |SQL_BIG_RESULT
-              |SQL_BUFFER_RESULT
-              |SQL_CACHE
-              |SQL_NO_CACHE
-              |SQL_CALC_FOUND_ROWS
-           )\s+
-      /SELECT /xgi;
-      ($cols_def) = $query =~ m/^SELECT\s+(.+?)\s+FROM/i;
-   }
-   elsif ( $query =~ m/^(?:INSERT|REPLACE)/i ) {
-      ($cols_def) = $query =~ m/\(([^\)]+)\)\s*VALUE/i;
-   }
-
-   PTDEBUG && _d('Columns:', $cols_def);
-   if ( $cols_def ) {
-      @$cols = split(',', $cols_def);
-      map {
-         my $col = $_;
-         $col = s/^\s+//g;
-         $col = s/\s+$//g;
-         $col;
-      } @$cols;
-   }
-
-   return $cols;
-}
-
-sub parse {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   my $parsed = {};
-
-   $query =~ s/\n/ /g;
-   $query = $self->clean_query($query);
-
-   $parsed->{query}   = $query,
-   $parsed->{tables}  = $self->get_aliases($query, 1);
-   $parsed->{columns} = $self->get_columns($query);
-
-   my ($type) = $query =~ m/^(\w+)/;
-   $parsed->{type} = lc $type;
-
-
-   $parsed->{sub_queries} = [];
-
-   return $parsed;
-}
-
-sub extract_tables {
-   my ( $self, %args ) = @_;
-   my $query      = $args{query};
-   my $default_db = $args{default_db};
-   my $q          = $self->{Quoter} || $args{Quoter};
-   return unless $query;
-   PTDEBUG && _d('Extracting tables');
-   my @tables;
-   my %seen;
-   foreach my $db_tbl ( $self->get_tables($query) ) {
-      next unless $db_tbl;
-      next if $seen{$db_tbl}++; # Unique-ify for issue 337.
-      my ( $db, $tbl ) = $q->split_unquote($db_tbl);
-      push @tables, [ $db || $default_db, $tbl ];
-   }
-   return @tables;
-}
-
-sub trim_identifier {
-   my ($self, $str) = @_;
-   return unless defined $str;
-   $str =~ s/`//g;
-   $str =~ s/^\s+//;
-   $str =~ s/\s+$//;
-   return $str;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End QueryParser package
-# ###########################################################################
-
-# ###########################################################################
-# QueryRewriter package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/QueryRewriter.pm
-#   t/lib/QueryRewriter.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package QueryRewriter;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-our $verbs   = qr{^SHOW|^FLUSH|^COMMIT|^ROLLBACK|^BEGIN|SELECT|INSERT
-                  |UPDATE|DELETE|REPLACE|^SET|UNION|^START|^LOCK}xi;
-my $quote_re = qr/"(?:(?!(?<!\\)").)*"|'(?:(?!(?<!\\)').)*'/; # Costly!
-my $bal;
-$bal         = qr/
-                  \(
-                  (?:
-                     (?> [^()]+ )    # Non-parens without backtracking
-                     |
-                     (??{ $bal })    # Group with matching parens
-                  )*
-                  \)
-                 /x;
-
-my $olc_re = qr/(?:--|#)[^'"\r\n]*(?=[\r\n]|\Z)/;  # One-line comments
-my $mlc_re = qr#/\*[^!].*?\*/#sm;                  # But not /*!version */
-my $vlc_re = qr#/\*.*?[0-9+].*?\*/#sm;             # For SHOW + /*!version */
-my $vlc_rf = qr#^(SHOW).*?/\*![0-9+].*?\*/#sm;     # Variation for SHOW
-
-
-sub new {
-   my ( $class, %args ) = @_;
-   my $self = { %args };
-   return bless $self, $class;
-}
-
-sub strip_comments {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   $query =~ s/$olc_re//go;
-   $query =~ s/$mlc_re//go;
-   if ( $query =~ m/$vlc_rf/i ) { # contains show + version
-      $query =~ s/$vlc_re//go;
-   }
-   return $query;
-}
-
-sub shorten {
-   my ( $self, $query, $length ) = @_;
-   $query =~ s{
-      \A(
-         (?:INSERT|REPLACE)
-         (?:\s+LOW_PRIORITY|DELAYED|HIGH_PRIORITY|IGNORE)?
-         (?:\s\w+)*\s+\S+\s+VALUES\s*\(.*?\)
-      )
-      \s*,\s*\(.*?(ON\s+DUPLICATE|\Z)}
-      {$1 /*... omitted ...*/$2}xsi;
-
-   return $query unless $query =~ m/IN\s*\(\s*(?!select)/i;
-
-   my $last_length  = 0;
-   my $query_length = length($query);
-   while (
-      $length          > 0
-      && $query_length > $length
-      && $query_length < ( $last_length || $query_length + 1 )
-   ) {
-      $last_length = $query_length;
-      $query =~ s{
-         (\bIN\s*\()    # The opening of an IN list
-         ([^\)]+)       # Contents of the list, assuming no item contains paren
-         (?=\))           # Close of the list
-      }
-      {
-         $1 . __shorten($2)
-      }gexsi;
-   }
-
-   return $query;
-}
-
-sub __shorten {
-   my ( $snippet ) = @_;
-   my @vals = split(/,/, $snippet);
-   return $snippet unless @vals > 20;
-   my @keep = splice(@vals, 0, 20);  # Remove and save the first 20 items
-   return
-      join(',', @keep)
-      . "/*... omitted "
-      . scalar(@vals)
-      . " items ...*/";
-}
-
-sub fingerprint {
-   my ( $self, $query ) = @_;
-
-   $query =~ m#\ASELECT /\*!40001 SQL_NO_CACHE \*/ \* FROM `# # mysqldump query
-      && return 'mysqldump';
-   $query =~ m#/\*\w+\.\w+:[0-9]/[0-9]\*/#     # pt-table-checksum, etc query
-      && return 'percona-toolkit';
-   $query =~ m/\Aadministrator command: /
-      && return $query;
-   $query =~ m/\A\s*(call\s+\S+)\(/i
-      && return lc($1); # Warning! $1 used, be careful.
-   if ( my ($beginning) = $query =~ m/\A((?:INSERT|REPLACE)(?: IGNORE)?\s+INTO.+?VALUES\s*\(.*?\))\s*,\s*\(/is ) {
-      $query = $beginning; # Shorten multi-value INSERT statements ASAP
-   }
-  
-   $query =~ s/$olc_re//go;
-   $query =~ s/$mlc_re//go;
-   $query =~ s/\Ause \S+\Z/use ?/i       # Abstract the DB in USE
-      && return $query;
-
-   $query =~ s/\\["']//g;                # quoted strings
-   $query =~ s/".*?"/?/sg;               # quoted strings
-   $query =~ s/'.*?'/?/sg;               # quoted strings
-
-   if ( $self->{match_md5_checksums} ) { 
-      $query =~ s/([._-])[a-f0-9]{32}/$1?/g;
-   }
-
-   if ( !$self->{match_embedded_numbers} ) {
-      $query =~ s/[0-9+-][0-9a-f.xb+-]*/?/g;
-   }
-   else {
-      $query =~ s/\b[0-9+-][0-9a-f.xb+-]*/?/g;
-   }
-
-   if ( $self->{match_md5_checksums} ) {
-      $query =~ s/[xb+-]\?/?/g;                
-   }
-   else {
-      $query =~ s/[xb.+-]\?/?/g;
-   }
-
-   $query =~ s/\A\s+//;                  # Chop off leading whitespace
-   chomp $query;                         # Kill trailing whitespace
-   $query =~ tr[ \n\t\r\f][ ]s;          # Collapse whitespace
-   $query = lc $query;
-   $query =~ s/\bnull\b/?/g;             # Get rid of NULLs
-   $query =~ s{                          # Collapse IN and VALUES lists
-               \b(in|values?)(?:[\s,]*\([\s?,]*\))+
-              }
-              {$1(?+)}gx;
-   $query =~ s{                          # Collapse UNION
-               \b(select\s.*?)(?:(\sunion(?:\sall)?)\s\1)+
-              }
-              {$1 /*repeat$2*/}xg;
-   $query =~ s/\blimit \?(?:, ?\?| offset \?)?/limit ?/; # LIMIT
-
-   if ( $query =~ m/\bORDER BY /gi ) {  # Find, anchor on ORDER BY clause
-      1 while $query =~ s/\G(.+?)\s+ASC/$1/gi && pos $query;
-   }
-
-   return $query;
-}
-
-sub distill_verbs {
-   my ( $self, $query ) = @_;
-
-   $query =~ m/\A\s*call\s+(\S+)\(/i && return "CALL $1";
-   $query =~ m/\A\s*use\s+/          && return "USE";
-   $query =~ m/\A\s*UNLOCK TABLES/i  && return "UNLOCK";
-   $query =~ m/\A\s*xa\s+(\S+)/i     && return "XA_$1";
-
-   if ( $query =~ m/\Aadministrator command:/ ) {
-      $query =~ s/administrator command:/ADMIN/;
-      $query = uc $query;
-      return $query;
-   }
-
-   $query = $self->strip_comments($query);
-
-   if ( $query =~ m/\A\s*SHOW\s+/i ) {
-      PTDEBUG && _d($query);
-
-      $query = uc $query;
-      $query =~ s/\s+(?:GLOBAL|SESSION|FULL|STORAGE|ENGINE)\b/ /g;
-      $query =~ s/\s+COUNT[^)]+\)//g;
-
-      $query =~ s/\s+(?:FOR|FROM|LIKE|WHERE|LIMIT|IN)\b.+//ms;
-
-      $query =~ s/\A(SHOW(?:\s+\S+){1,2}).*\Z/$1/s;
-      $query =~ s/\s+/ /g;
-      PTDEBUG && _d($query);
-      return $query;
-   }
-
-   eval $QueryParser::data_def_stmts;
-   eval $QueryParser::tbl_ident;
-   my ( $dds ) = $query =~ /^\s*($QueryParser::data_def_stmts)\b/i;
-   if ( $dds) {
-      my ( $obj ) = $query =~ m/$dds.+(DATABASE|TABLE)\b/i;
-      $obj = uc $obj if $obj;
-      PTDEBUG && _d('Data def statment:', $dds, 'obj:', $obj);
-      my ($db_or_tbl)
-         = $query =~ m/(?:TABLE|DATABASE)\s+($QueryParser::tbl_ident)(\s+.*)?/i;
-      PTDEBUG && _d('Matches db or table:', $db_or_tbl);
-      return uc($dds . ($obj ? " $obj" : '')), $db_or_tbl;
-   }
-
-   my @verbs = $query =~ m/\b($verbs)\b/gio;
-   @verbs    = do {
-      my $last = '';
-      grep { my $pass = $_ ne $last; $last = $_; $pass } map { uc } @verbs;
-   };
-
-   if ( ($verbs[0] || '') eq 'SELECT' && @verbs > 1 ) {
-      PTDEBUG && _d("False-positive verbs after SELECT:", @verbs[1..$#verbs]);
-      my $union = grep { $_ eq 'UNION' } @verbs;
-      @verbs    = $union ? qw(SELECT UNION) : qw(SELECT);
-   }
-
-   my $verb_str = join(q{ }, @verbs);
-   return $verb_str;
-}
-
-sub __distill_tables {
-   my ( $self, $query, $table, %args ) = @_;
-   my $qp = $args{QueryParser} || $self->{QueryParser};
-   die "I need a QueryParser argument" unless $qp;
-
-   my @tables = map {
-      $_ =~ s/`//g;
-      $_ =~ s/(_?)[0-9]+/$1?/g;
-      $_;
-   } grep { defined $_ } $qp->get_tables($query);
-
-   push @tables, $table if $table;
-
-   @tables = do {
-      my $last = '';
-      grep { my $pass = $_ ne $last; $last = $_; $pass } @tables;
-   };
-
-   return @tables;
-}
-
-sub distill {
-   my ( $self, $query, %args ) = @_;
-
-   if ( $args{generic} ) {
-      my ($cmd, $arg) = $query =~ m/^(\S+)\s+(\S+)/;
-      return '' unless $cmd;
-      $query = (uc $cmd) . ($arg ? " $arg" : '');
-   }
-   else {
-      my ($verbs, $table)  = $self->distill_verbs($query, %args);
-
-      if ( $verbs && $verbs =~ m/^SHOW/ ) {
-         my %alias_for = qw(
-            SCHEMA   DATABASE
-            KEYS     INDEX
-            INDEXES  INDEX
-         );
-         map { $verbs =~ s/$_/$alias_for{$_}/ } keys %alias_for;
-         $query = $verbs;
-      }
-      else {
-         my @tables = $self->__distill_tables($query, $table, %args);
-         $query     = join(q{ }, $verbs, @tables); 
-      } 
-   }
-
-   if ( $args{trf} ) {
-      $query = $args{trf}->($query, %args);
-   }
-
-   return $query;
-}
-
-sub convert_to_select {
-   my ( $self, $query ) = @_;
-   return unless $query;
-
-   return if $query =~ m/=\s*\(\s*SELECT /i;
-
-   $query =~ s{
-                 \A.*?
-                 update(?:\s+(?:low_priority|ignore))?\s+(.*?)
-                 \s+set\b(.*?)
-                 (?:\s*where\b(.*?))?
-                 (limit\s*[0-9]+(?:\s*,\s*[0-9]+)?)?
-                 \Z
-              }
-              {__update_to_select($1, $2, $3, $4)}exsi
-      || $query =~ s{
-                    \A.*?
-                    (?:insert(?:\s+ignore)?|replace)\s+
-                    .*?\binto\b(.*?)\(([^\)]+)\)\s*
-                    values?\s*(\(.*?\))\s*
-                    (?:\blimit\b|on\s+duplicate\s+key.*)?\s*
-                    \Z
-                 }
-                 {__insert_to_select($1, $2, $3)}exsi
-      || $query =~ s{
-                    \A.*?
-                    (?:insert(?:\s+ignore)?|replace)\s+
-                    (?:.*?\binto)\b(.*?)\s*
-                    set\s+(.*?)\s*
-                    (?:\blimit\b|on\s+duplicate\s+key.*)?\s*
-                    \Z
-                 }
-                 {__insert_to_select_with_set($1, $2)}exsi
-      || $query =~ s{
-                    \A.*?
-                    delete\s+(.*?)
-                    \bfrom\b(.*)
-                    \Z
-                 }
-                 {__delete_to_select($1, $2)}exsi;
-   $query =~ s/\s*on\s+duplicate\s+key\s+update.*\Z//si;
-   $query =~ s/\A.*?(?=\bSELECT\s*\b)//ism;
-   return $query;
-}
-
-sub convert_select_list {
-   my ( $self, $query ) = @_;
-   $query =~ s{
-               \A\s*select(.*?)\bfrom\b
-              }
-              {$1 =~ m/\*/ ? "select 1 from" : "select isnull(coalesce($1)) from"}exi;
-   return $query;
-}
-
-sub __delete_to_select {
-   my ( $delete, $join ) = @_;
-   if ( $join =~ m/\bjoin\b/ ) {
-      return "select 1 from $join";
-   }
-   return "select * from $join";
-}
-
-sub __insert_to_select {
-   my ( $tbl, $cols, $vals ) = @_;
-   PTDEBUG && _d('Args:', @_);
-   my @cols = split(/,/, $cols);
-   PTDEBUG && _d('Cols:', @cols);
-   $vals =~ s/^\(|\)$//g; # Strip leading/trailing parens
-   my @vals = $vals =~ m/($quote_re|[^,]*${bal}[^,]*|[^,]+)/g;
-   PTDEBUG && _d('Vals:', @vals);
-   if ( @cols == @vals ) {
-      return "select * from $tbl where "
-         . join(' and ', map { "$cols[$_]=$vals[$_]" } (0..$#cols));
-   }
-   else {
-      return "select * from $tbl limit 1";
-   }
-}
-
-sub __insert_to_select_with_set {
-   my ( $from, $set ) = @_;
-   $set =~ s/,/ and /g;
-   return "select * from $from where $set ";
-}
-
-sub __update_to_select {
-   my ( $from, $set, $where, $limit ) = @_;
-   return "select $set from $from "
-      . ( $where ? "where $where" : '' )
-      . ( $limit ? " $limit "      : '' );
-}
-
-sub wrap_in_derived {
-   my ( $self, $query ) = @_;
-   return unless $query;
-   return $query =~ m/\A\s*select/i
-      ? "select 1 from ($query) as x limit 1"
-      : $query;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End QueryRewriter package
-# ###########################################################################
-
-# ###########################################################################
-# Transformers package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Transformers.pm
-#   t/lib/Transformers.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Transformers;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use Time::Local qw(timegm timelocal);
-use Digest::MD5 qw(md5_hex);
-use B qw();
-
-BEGIN {
-   require Exporter;
-   our @ISA         = qw(Exporter);
-   our %EXPORT_TAGS = ();
-   our @EXPORT      = ();
-   our @EXPORT_OK   = qw(
-      micro_t
-      percentage_of
-      secs_to_time
-      time_to_secs
-      shorten
-      ts
-      parse_timestamp
-      unix_timestamp
-      any_unix_timestamp
-      make_checksum
-      crc32
-      encode_json
-   );
-}
-
-our $mysql_ts  = qr/(\d\d)(\d\d)(\d\d) +(\d+):(\d+):(\d+)(\.\d+)?/;
-our $proper_ts = qr/(\d\d\d\d)-(\d\d)-(\d\d)[T ](\d\d):(\d\d):(\d\d)(\.\d+)?/;
-our $n_ts      = qr/(\d{1,5})([shmd]?)/; # Limit \d{1,5} because \d{6} looks
-
-sub micro_t {
-   my ( $t, %args ) = @_;
-   my $p_ms = defined $args{p_ms} ? $args{p_ms} : 0;  # precision for ms vals
-   my $p_s  = defined $args{p_s}  ? $args{p_s}  : 0;  # precision for s vals
-   my $f;
-
-   $t = 0 if $t < 0;
-
-   $t = sprintf('%.17f', $t) if $t =~ /e/;
-
-   $t =~ s/\.(\d{1,6})\d*/\.$1/;
-
-   if ($t > 0 && $t <= 0.000999) {
-      $f = ($t * 1000000) . 'us';
-   }
-   elsif ($t >= 0.001000 && $t <= 0.999999) {
-      $f = sprintf("%.${p_ms}f", $t * 1000);
-      $f = ($f * 1) . 'ms'; # * 1 to remove insignificant zeros
-   }
-   elsif ($t >= 1) {
-      $f = sprintf("%.${p_s}f", $t);
-      $f = ($f * 1) . 's'; # * 1 to remove insignificant zeros
-   }
-   else {
-      $f = 0;  # $t should = 0 at this point
-   }
-
-   return $f;
-}
-
-sub percentage_of {
-   my ( $is, $of, %args ) = @_;
-   my $p   = $args{p} || 0; # float precision
-   my $fmt = $p ? "%.${p}f" : "%d";
-   return sprintf $fmt, ($is * 100) / ($of ||= 1);
-}
-
-sub secs_to_time {
-   my ( $secs, $fmt ) = @_;
-   $secs ||= 0;
-   return '00:00' unless $secs;
-
-   $fmt ||= $secs >= 86_400 ? 'd'
-          : $secs >= 3_600  ? 'h'
-          :                   'm';
-
-   return
-      $fmt eq 'd' ? sprintf(
-         "%d+%02d:%02d:%02d",
-         int($secs / 86_400),
-         int(($secs % 86_400) / 3_600),
-         int(($secs % 3_600) / 60),
-         $secs % 60)
-      : $fmt eq 'h' ? sprintf(
-         "%02d:%02d:%02d",
-         int(($secs % 86_400) / 3_600),
-         int(($secs % 3_600) / 60),
-         $secs % 60)
-      : sprintf(
-         "%02d:%02d",
-         int(($secs % 3_600) / 60),
-         $secs % 60);
-}
-
-sub time_to_secs {
-   my ( $val, $default_suffix ) = @_;
-   die "I need a val argument" unless defined $val;
-   my $t = 0;
-   my ( $prefix, $num, $suffix ) = $val =~ m/([+-]?)(\d+)([a-z])?$/;
-   $suffix = $suffix || $default_suffix || 's';
-   if ( $suffix =~ m/[smhd]/ ) {
-      $t = $suffix eq 's' ? $num * 1        # Seconds
-         : $suffix eq 'm' ? $num * 60       # Minutes
-         : $suffix eq 'h' ? $num * 3600     # Hours
-         :                  $num * 86400;   # Days
-
-      $t *= -1 if $prefix && $prefix eq '-';
-   }
-   else {
-      die "Invalid suffix for $val: $suffix";
-   }
-   return $t;
-}
-
-sub shorten {
-   my ( $num, %args ) = @_;
-   my $p = defined $args{p} ? $args{p} : 2;     # float precision
-   my $d = defined $args{d} ? $args{d} : 1_024; # divisor
-   my $n = 0;
-   my @units = ('', qw(k M G T P E Z Y));
-   while ( $num >= $d && $n < @units - 1 ) {
-      $num /= $d;
-      ++$n;
-   }
-   return sprintf(
-      $num =~ m/\./ || $n
-         ? "%.${p}f%s"
-         : '%d',
-      $num, $units[$n]);
-}
-
-sub ts {
-   my ( $time, $gmt ) = @_;
-   my ( $sec, $min, $hour, $mday, $mon, $year )
-      = $gmt ? gmtime($time) : localtime($time);
-   $mon  += 1;
-   $year += 1900;
-   my $val = sprintf("%d-%02d-%02dT%02d:%02d:%02d",
-      $year, $mon, $mday, $hour, $min, $sec);
-   if ( my ($us) = $time =~ m/(\.\d+)$/ ) {
-      $us = sprintf("%.6f", $us);
-      $us =~ s/^0\././;
-      $val .= $us;
-   }
-   return $val;
-}
-
-sub parse_timestamp {
-   my ( $val ) = @_;
-   if ( my($y, $m, $d, $h, $i, $s, $f)
-         = $val =~ m/^$mysql_ts$/ )
-   {
-      return sprintf "%d-%02d-%02d %02d:%02d:"
-                     . (defined $f ? '%09.6f' : '%02d'),
-                     $y + 2000, $m, $d, $h, $i, (defined $f ? $s + $f : $s);
-   }
-   elsif ( $val =~ m/^$proper_ts$/ ) {
-      return $val;
-   }
-   return $val;
-}
-
-sub unix_timestamp {
-   my ( $val, $gmt ) = @_;
-   if ( my($y, $m, $d, $h, $i, $s, $us) = $val =~ m/^$proper_ts$/ ) {
-      $val = $gmt
-         ? timegm($s, $i, $h, $d, $m - 1, $y)
-         : timelocal($s, $i, $h, $d, $m - 1, $y);
-      if ( defined $us ) {
-         $us = sprintf('%.6f', $us);
-         $us =~ s/^0\././;
-         $val .= $us;
-      }
-   }
-   return $val;
-}
-
-sub any_unix_timestamp {
-   my ( $val, $callback ) = @_;
-
-   if ( my ($n, $suffix) = $val =~ m/^$n_ts$/ ) {
-      $n = $suffix eq 's' ? $n            # Seconds
-         : $suffix eq 'm' ? $n * 60       # Minutes
-         : $suffix eq 'h' ? $n * 3600     # Hours
-         : $suffix eq 'd' ? $n * 86400    # Days
-         :                  $n;           # default: Seconds
-      PTDEBUG && _d('ts is now - N[shmd]:', $n);
-      return time - $n;
-   }
-   elsif ( $val =~ m/^\d{9,}/ ) {
-      PTDEBUG && _d('ts is already a unix timestamp');
-      return $val;
-   }
-   elsif ( my ($ymd, $hms) = $val =~ m/^(\d{6})(?:\s+(\d+:\d+:\d+))?/ ) {
-      PTDEBUG && _d('ts is MySQL slow log timestamp');
-      $val .= ' 00:00:00' unless $hms;
-      return unix_timestamp(parse_timestamp($val));
-   }
-   elsif ( ($ymd, $hms) = $val =~ m/^(\d{4}-\d\d-\d\d)(?:[T ](\d+:\d+:\d+))?/) {
-      PTDEBUG && _d('ts is properly formatted timestamp');
-      $val .= ' 00:00:00' unless $hms;
-      return unix_timestamp($val);
-   }
-   else {
-      PTDEBUG && _d('ts is MySQL expression');
-      return $callback->($val) if $callback && ref $callback eq 'CODE';
-   }
-
-   PTDEBUG && _d('Unknown ts type:', $val);
-   return;
-}
-
-sub make_checksum {
-   my ( $val ) = @_;
-   my $checksum = uc substr(md5_hex($val), -16);
-   PTDEBUG && _d($checksum, 'checksum for', $val);
-   return $checksum;
-}
-
-sub crc32 {
-   my ( $string ) = @_;
-   return unless $string;
-   my $poly = 0xEDB88320;
-   my $crc  = 0xFFFFFFFF;
-   foreach my $char ( split(//, $string) ) {
-      my $comp = ($crc ^ ord($char)) & 0xFF;
-      for ( 1 .. 8 ) {
-         $comp = $comp & 1 ? $poly ^ ($comp >> 1) : $comp >> 1;
-      }
-      $crc = (($crc >> 8) & 0x00FFFFFF) ^ $comp;
-   }
-   return $crc ^ 0xFFFFFFFF;
-}
-
-my $got_json = eval { require JSON };
-sub encode_json {
-   return JSON::encode_json(@_) if $got_json;
-   my ( $data ) = @_;
-   return (object_to_json($data) || '');
-}
-
-
-sub object_to_json {
-   my ($obj) = @_;
-   my $type  = ref($obj);
-
-   if($type eq 'HASH'){
-      return hash_to_json($obj);
-   }
-   elsif($type eq 'ARRAY'){
-      return array_to_json($obj);
-   }
-   else {
-      return value_to_json($obj);
-   }
-}
-
-sub hash_to_json {
-   my ($obj) = @_;
-   my @res;
-   for my $k ( sort { $a cmp $b } keys %$obj ) {
-      push @res, string_to_json( $k )
-         .  ":"
-         . ( object_to_json( $obj->{$k} ) || value_to_json( $obj->{$k} ) );
-   }
-   return '{' . ( @res ? join( ",", @res ) : '' )  . '}';
-}
-
-sub array_to_json {
-   my ($obj) = @_;
-   my @res;
-
-   for my $v (@$obj) {
-      push @res, object_to_json($v) || value_to_json($v);
-   }
-
-   return '[' . ( @res ? join( ",", @res ) : '' ) . ']';
-}
-
-sub value_to_json {
-   my ($value) = @_;
-
-   return 'null' if(!defined $value);
-
-   my $b_obj = B::svref_2object(\$value);  # for round trip problem
-   my $flags = $b_obj->FLAGS;
-   return $value # as is 
-      if $flags & ( B::SVp_IOK | B::SVp_NOK ) and !( $flags & B::SVp_POK ); # SvTYPE is IV or NV?
-
-   my $type = ref($value);
-
-   if( !$type ) {
-      return string_to_json($value);
-   }
-   else {
-      return 'null';
-   }
-
-}
-
-my %esc = (
-   "\n" => '\n',
-   "\r" => '\r',
-   "\t" => '\t',
-   "\f" => '\f',
-   "\b" => '\b',
-   "\"" => '\"',
-   "\\" => '\\\\',
-   "\'" => '\\\'',
-);
-
-sub string_to_json {
-   my ($arg) = @_;
-
-   $arg =~ s/([\x22\x5c\n\r\t\f\b])/$esc{$1}/g;
-   $arg =~ s/\//\\\//g;
-   $arg =~ s/([\x00-\x08\x0b\x0e-\x1f])/'\\u00' . unpack('H2', $1)/eg;
-
-   utf8::upgrade($arg);
-   utf8::encode($arg);
-
-   return '"' . $arg . '"';
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End Transformers package
-# ###########################################################################
-
-# ###########################################################################
-# Daemon package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Daemon.pm
-#   t/lib/Daemon.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Daemon;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-use POSIX qw(setsid);
-
-sub new {
-   my ( $class, %args ) = @_;
-   foreach my $arg ( qw(o) ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my $o = $args{o};
-   my $self = {
-      o        => $o,
-      log_file => $o->has('log') ? $o->get('log') : undef,
-      PID_file => $o->has('pid') ? $o->get('pid') : undef,
-   };
-
-   check_PID_file(undef, $self->{PID_file});
-
-   PTDEBUG && _d('Daemonized child will log to', $self->{log_file});
-   return bless $self, $class;
-}
-
-sub daemonize {
-   my ( $self ) = @_;
-
-   PTDEBUG && _d('About to fork and daemonize');
-   defined (my $pid = fork()) or die "Cannot fork: $OS_ERROR";
-   if ( $pid ) {
-      PTDEBUG && _d('Parent PID', $PID, 'exiting after forking child PID',$pid);
-      exit;
-   }
-
-   PTDEBUG && _d('Daemonizing child PID', $PID);
-   $self->{PID_owner} = $PID;
-   $self->{child}     = 1;
-
-   POSIX::setsid() or die "Cannot start a new session: $OS_ERROR";
-   chdir '/'       or die "Cannot chdir to /: $OS_ERROR";
-
-   $self->_make_PID_file();
-
-   $OUTPUT_AUTOFLUSH = 1;
-
-   PTDEBUG && _d('Redirecting STDIN to /dev/null');
-   close STDIN;
-   open  STDIN, '/dev/null'
-      or die "Cannot reopen STDIN to /dev/null: $OS_ERROR";
-
-   if ( $self->{log_file} ) {
-      PTDEBUG && _d('Redirecting STDOUT and STDERR to', $self->{log_file});
-      close STDOUT;
-      open  STDOUT, '>>', $self->{log_file}
-         or die "Cannot open log file $self->{log_file}: $OS_ERROR";
-
-      close STDERR;
-      open  STDERR, ">&STDOUT"
-         or die "Cannot dupe STDERR to STDOUT: $OS_ERROR"; 
-   }
-   else {
-      if ( -t STDOUT ) {
-         PTDEBUG && _d('No log file and STDOUT is a terminal;',
-            'redirecting to /dev/null');
-         close STDOUT;
-         open  STDOUT, '>', '/dev/null'
-            or die "Cannot reopen STDOUT to /dev/null: $OS_ERROR";
-      }
-      if ( -t STDERR ) {
-         PTDEBUG && _d('No log file and STDERR is a terminal;',
-            'redirecting to /dev/null');
-         close STDERR;
-         open  STDERR, '>', '/dev/null'
-            or die "Cannot reopen STDERR to /dev/null: $OS_ERROR";
-      }
-   }
-
-   return;
-}
-
-sub check_PID_file {
-   my ( $self, $file ) = @_;
-   my $PID_file = $self ? $self->{PID_file} : $file;
-   PTDEBUG && _d('Checking PID file', $PID_file);
-   if ( $PID_file && -f $PID_file ) {
-      my $pid;
-      eval {
-         chomp($pid = (slurp_file($PID_file) || ''));
-      };
-      if ( $EVAL_ERROR ) {
-         die "The PID file $PID_file already exists but it cannot be read: "
-            . $EVAL_ERROR;
-      }
-      PTDEBUG && _d('PID file exists; it contains PID', $pid);
-      if ( $pid ) {
-         my $pid_is_alive = kill 0, $pid;
-         if ( $pid_is_alive ) {
-            die "The PID file $PID_file already exists "
-               . " and the PID that it contains, $pid, is running";
-         }
-         else {
-            warn "Overwriting PID file $PID_file because the PID that it "
-               . "contains, $pid, is not running";
-         }
-      }
-      else {
-         die "The PID file $PID_file already exists but it does not "
-            . "contain a PID";
-      }
-   }
-   else {
-      PTDEBUG && _d('No PID file');
-   }
-   return;
-}
-
-sub make_PID_file {
-   my ( $self ) = @_;
-   if ( exists $self->{child} ) {
-      die "Do not call Daemon::make_PID_file() for daemonized scripts";
-   }
-   $self->_make_PID_file();
-   $self->{PID_owner} = $PID;
-   return;
-}
-
-sub _make_PID_file {
-   my ( $self ) = @_;
-
-   my $PID_file = $self->{PID_file};
-   if ( !$PID_file ) {
-      PTDEBUG && _d('No PID file to create');
-      return;
-   }
-
-   $self->check_PID_file();
-
-   open my $PID_FH, '>', $PID_file
-      or die "Cannot open PID file $PID_file: $OS_ERROR";
-   print $PID_FH $PID
-      or die "Cannot print to PID file $PID_file: $OS_ERROR";
-   close $PID_FH
-      or die "Cannot close PID file $PID_file: $OS_ERROR";
-
-   PTDEBUG && _d('Created PID file:', $self->{PID_file});
-   return;
-}
-
-sub _remove_PID_file {
-   my ( $self ) = @_;
-   if ( $self->{PID_file} && -f $self->{PID_file} ) {
-      unlink $self->{PID_file}
-         or warn "Cannot remove PID file $self->{PID_file}: $OS_ERROR";
-      PTDEBUG && _d('Removed PID file');
-   }
-   else {
-      PTDEBUG && _d('No PID to remove');
-   }
-   return;
-}
-
-sub DESTROY {
-   my ( $self ) = @_;
-
-   $self->_remove_PID_file() if ($self->{PID_owner} || 0) == $PID;
-
-   return;
-}
-
-sub slurp_file {
-   my ($file) = @_;
-   return unless $file;
-   open my $fh, "<", $file or die "Cannot open $file: $OS_ERROR";
-   return do { local $/; <$fh> };
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End Daemon package
-# ###########################################################################
-
-# ###########################################################################
-# Advisor package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/Advisor.pm
-#   t/lib/Advisor.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package Advisor;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-sub new {
-   my ( $class, %args ) = @_;
-   foreach my $arg ( qw(match_type) ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-
-   my $self = {
-      %args,
-      rules          => [],  # Rules from all advisor modules.
-      rule_index_for => {},  # Maps rules by ID to their array index in $rules.
-      rule_info      => {},  # ID, severity, description, etc. for each rule.
-   };
-
-   return bless $self, $class;
-}
-
-sub load_rules {
-   my ( $self, $advisor ) = @_;
-   return unless $advisor;
-   PTDEBUG && _d('Loading rules from', ref $advisor);
-
-   my $i = scalar @{$self->{rules}};
-
-   RULE:
-   foreach my $rule ( $advisor->get_rules() ) {
-      my $id = $rule->{id};
-      if ( $self->{ignore_rules}->{"$id"} ) {
-         PTDEBUG && _d("Ignoring rule", $id);
-         next RULE;
-      }
-      die "Rule $id already exists and cannot be redefined"
-         if defined $self->{rule_index_for}->{$id};
-      push @{$self->{rules}}, $rule;
-      $self->{rule_index_for}->{$id} = $i++;
-   }
-
-   return;
-}
-
-sub load_rule_info {
-   my ( $self, $advisor ) = @_;
-   return unless $advisor;
-   PTDEBUG && _d('Loading rule info from', ref $advisor);
-   my $rules = $self->{rules};
-   foreach my $rule ( @$rules ) {
-      my $id = $rule->{id};
-      if ( $self->{ignore_rules}->{"$id"} ) {
-         die "Rule $id was loaded but should be ignored";
-      }
-      my $rule_info = $advisor->get_rule_info($id);
-      next unless $rule_info;
-      die "Info for rule $id already exists and cannot be redefined"
-         if $self->{rule_info}->{$id};
-      $self->{rule_info}->{$id} = $rule_info;
-   }
-   return;
-}
-
-
-sub run_rules {
-   my ( $self, %args ) = @_;
-   my @matched_rules;
-   my @matched_pos;
-   my $rules      = $self->{rules};
-   my $match_type = lc $self->{match_type};
-   foreach my $rule ( @$rules ) {
-      eval {
-         my $match = $rule->{code}->(%args);
-         if ( $match_type eq 'pos' ) {
-            if ( defined $match ) {
-               PTDEBUG && _d('Matches rule', $rule->{id}, 'near pos', $match);
-               push @matched_rules, $rule->{id};
-               push @matched_pos,   $match;
-            }
-         }
-         elsif ( $match_type eq 'bool' ) {
-            if ( $match ) {
-               PTDEBUG && _d("Matches rule", $rule->{id});
-               push @matched_rules, $rule->{id};
-            }
-         }
-      };
-      if ( $EVAL_ERROR ) {
-         warn "Code for rule $rule->{id} caused an error: $EVAL_ERROR";
-      }
-   }
-   return \@matched_rules, \@matched_pos;
-};
-
-
-sub get_rule_info {
-   my ( $self, $id ) = @_;
-   return unless $id;
-   return $self->{rule_info}->{$id};
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End Advisor package
-# ###########################################################################
-
-# ###########################################################################
-# AdvisorRules package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/AdvisorRules.pm
-#   t/lib/AdvisorRules.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package AdvisorRules;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-sub new {
-   my ( $class, %args ) = @_;
-   foreach my $arg ( qw(PodParser) ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my $self = {
-      %args,
-      rules     => [],
-      rule_info => {},
-   };
-   return bless $self, $class;
-}
-
-sub load_rule_info {
-   my ( $self, %args ) = @_;
-   foreach my $arg ( qw(file section ) ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my $rules = $args{rules} || $self->{rules};
-   my $p     = $self->{PodParser};
-
-   $p->parse_from_file($args{file});
-   my $rule_items = $p->get_items($args{section});
-   my %seen;
-   foreach my $rule_id ( keys %$rule_items ) {
-      my $rule = $rule_items->{$rule_id};
-      die "Rule $rule_id has no description" unless $rule->{desc};
-      die "Rule $rule_id has no severity"    unless $rule->{severity};
-      die "Rule $rule_id is already defined"
-         if exists $self->{rule_info}->{$rule_id};
-      $self->{rule_info}->{$rule_id} = {
-         id          => $rule_id,
-         severity    => $rule->{severity},
-         description => $rule->{desc},
-      };
-   }
-
-   foreach my $rule ( @$rules ) {
-      die "There is no info for rule $rule->{id} in $args{file}"
-         unless $self->{rule_info}->{ $rule->{id} };
-   }
-
-   return;
-}
-
-sub get_rule_info {
-   my ( $self, $id ) = @_;
-   return unless $id;
-   return $self->{rule_info}->{$id};
-}
-
-sub _reset_rule_info {
-   my ( $self ) = @_;
-   $self->{rule_info} = {};
-   return;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End AdvisorRules package
-# ###########################################################################
-
-# ###########################################################################
-# QueryAdvisorRules package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/QueryAdvisorRules.pm
-#   t/lib/QueryAdvisorRules.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package QueryAdvisorRules;
-use base 'AdvisorRules';
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-sub new {
-   my ( $class, %args ) = @_;
-   my $self = $class->SUPER::new(%args);
-   @{$self->{rules}} = $self->get_rules();
-   PTDEBUG && _d(scalar @{$self->{rules}}, "rules");
-   return $self;
-}
-
-sub get_rules {
-   return
-   {
-      id   => 'ALI.001',      # Implicit alias
-      code => sub {
-         my ( %args ) = @_;
-         my $event  = $args{event};
-         my $struct = $event->{query_struct};
-         my $tbls   = $struct->{from} || $struct->{into} || $struct->{tables};
-         return unless $tbls;
-         foreach my $tbl ( @$tbls ) {
-            return 0 if $tbl->{alias} && !$tbl->{explicit_alias};
-         }
-         my $cols = $struct->{columns};
-         return unless $cols;
-         foreach my $col ( @$cols ) {
-            return 0 if $col->{alias} && !$col->{explicit_alias};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'ALI.002',      # tbl.* alias
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         my $cols  = $event->{query_struct}->{columns};
-         return unless $cols;
-         foreach my $col ( @$cols ) {
-            return 0 if $col->{tbl} && $col->{col} eq '*' &&  $col->{alias};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'ALI.003',      # tbl AS tbl
-      code => sub {
-         my ( %args ) = @_;
-         my $event  = $args{event};
-         my $struct = $event->{query_struct};
-         my $tbls   = $struct->{from} || $struct->{into} || $struct->{tables};
-         return unless $tbls;
-         foreach my $tbl ( @$tbls ) {
-            return 0 if $tbl->{alias} && $tbl->{alias} eq $tbl->{tbl};
-         }
-         my $cols = $struct->{columns};
-         return unless $cols;
-         foreach my $col ( @$cols ) {
-            return 0 if $col->{alias} && $col->{alias} eq $col->{col};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'ARG.001',      # col = '%foo'
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         my $where = $event->{query_struct}->{where};
-         return unless $where && @$where;
-         foreach my $arg ( @$where ) {
-            return 0
-               if ($arg->{operator} || '') eq 'like'
-                  && $arg->{right_arg} =~ m/[\'\"][\%\_]./;
-         }
-         return;
-      },
-   },
-   {
-      id   => 'ARG.002',      # LIKE w/o wildcard
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};        
-         my $where = $event->{query_struct}->{where};
-         return unless $where && @$where;
-         foreach my $arg ( @$where ) {
-            return 0
-               if ($arg->{operator} || '') eq 'like'
-                  && $arg->{right_arg} !~ m/[%_]/;
-         }
-         return;
-      },
-   },
-   {
-      id   => 'CLA.001',      # SELECT w/o WHERE
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return unless ($event->{query_struct}->{type} || '') eq 'select';
-         return unless $event->{query_struct}->{from};
-         return 0 unless $event->{query_struct}->{where};
-         return;
-      },
-   },
-   {
-      id   => 'CLA.002',      # ORDER BY RAND()
-      code => sub {
-         my ( %args ) = @_;
-         my $event   = $args{event};
-         my $orderby = $event->{query_struct}->{order_by};
-         return unless $orderby;
-         foreach my $ident ( @$orderby ) {
-            return 0 if $ident->{function} && $ident->{function} eq 'RAND';
-         }
-         return;
-      },
-   },
-   {
-      id   => 'CLA.003',      # LIMIT w/ OFFSET
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return unless $event->{query_struct}->{limit};
-         return unless defined $event->{query_struct}->{limit}->{offset};
-         return 0;
-      },
-   },
-   {
-      id   => 'CLA.004',      # GROUP BY <number>
-      code => sub {
-         my ( %args ) = @_;
-         my $event   = $args{event};
-         my $groupby = $event->{query_struct}->{group_by};
-         return unless $groupby;
-         foreach my $ident ( @$groupby ) {
-            return 0 if exists $ident->{position};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'CLA.005',      # ORDER BY col where col=<constant>
-      code => sub {
-         my ( %args ) = @_;
-         my $event   = $args{event};
-         my $orderby = $event->{query_struct}->{order_by};
-         return unless $orderby;
-         my $where   = $event->{query_struct}->{where};
-         return unless $where;
-         my %orderby_col = map { lc $_->{column} => 1 }
-                           grep { $_->{column} }
-                           @$orderby;
-         foreach my $pred ( @$where ) {
-            my $val = $pred->{right_arg};
-            next unless $val;
-            return 0 if $val =~ m/^\d+$/ && $orderby_col{lc($pred->{left_arg} || '')};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'CLA.006',      # GROUP BY or ORDER BY different tables
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         my $groupby = $event->{query_struct}->{group_by};
-         my $orderby = $event->{query_struct}->{order_by};
-         return unless $groupby || $orderby;
-
-         my %groupby_tbls = map { $_->{table} => 1 }
-                            grep { $_->{table} }
-                            @$groupby;
-         return 0 if scalar keys %groupby_tbls > 1;
-         
-         my %orderby_tbls = map { $_->{table} => 1 }
-                            grep { $_->{table} }
-                            @$orderby;
-         return 0 if scalar keys %orderby_tbls > 1;
-
-         map { delete $groupby_tbls{$_} } keys %orderby_tbls;
-         return 0 if scalar keys %groupby_tbls;
-
-         return;
-      },
-   },
-   {
-      id   => 'CLA.007',      # ORDER BY ASC/DESC mix can't use index
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         my $order_by = $event->{query_struct}->{order_by}; 
-         return unless $order_by;
-         my ($asc, $desc) = (0, 0);
-         foreach my $col ( @$order_by ) {
-            if ( ($col->{sort} || 'ASC') eq 'ASC' ) {
-               $asc++;
-            }
-            else {
-               $desc++;
-            }
-            return 0 if $asc && $desc;
-         }
-         return;
-      },
-   },
-   {
-      id   => 'COL.001',      # SELECT *
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return unless ($event->{query_struct}->{type} || '') eq 'select';
-         my $cols = $event->{query_struct}->{columns};
-         return unless $cols;
-         foreach my $col ( @$cols ) {
-            return 0 if $col->{col} eq '*' && !$col->{func};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'COL.002',      # INSERT w/o (cols) def
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         my $type  = $event->{query_struct}->{type} || '';
-         return unless $type eq 'insert' || $type eq 'replace';
-         return 0 unless $event->{query_struct}->{columns};
-         return;
-      },
-   },
-   {
-      id   => 'LIT.001',      # IP as string
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         if ( $event->{arg} =~ m/['"]\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}/gc ) {
-            return (pos $event->{arg}) || 0;
-         }
-         return;
-      },
-   },
-   {
-      id   => 'LIT.002',      # Date not quoted
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         if ( $event->{arg} =~ m/(?<!['"\w-])\d{4}-\d{1,2}-\d{1,2}\b/gc ) {
-            return (pos $event->{arg}) || 0;
-         }
-         if ( $event->{arg} =~ m/(?<!['"\w\d-])\d{2}-\d{1,2}-\d{1,2}\b/gc ) {
-            return (pos $event->{arg}) || 0;
-         }
-         return;
-      },
-   },
-   {
-      id   => 'KWR.001',      # SQL_CALC_FOUND_ROWS
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return 0 if $event->{query_struct}->{keywords}->{sql_calc_found_rows};
-         return;
-      },
-   },
-   {
-      id   => 'JOI.001',      # comma and ansi joins
-      code => sub {
-         my ( %args ) = @_;
-         my $event  = $args{event};
-         my $struct = $event->{query_struct};
-         my $tbls   = $struct->{from} || $struct->{into} || $struct->{tables};
-         return unless $tbls;
-         my $comma_join = 0;
-         my $ansi_join  = 0;
-         foreach my $tbl ( @$tbls ) {
-            if ( $tbl->{join} ) {
-               if ( $tbl->{join}->{ansi} ) {
-                  $ansi_join = 1;
-               }
-               else {
-                  $comma_join = 1;
-               }
-            }
-            return 0 if $comma_join && $ansi_join;
-         }
-         return;
-      },
-   },
-   {
-      id   => 'RES.001',      # non-deterministic GROUP BY
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return unless ($event->{query_struct}->{type} || '') eq 'select';
-         my $groupby = $event->{query_struct}->{group_by};
-         return unless $groupby;
-         my %groupby_col = map { $_->{column} => 1 }
-                           grep { $_->{column} }
-                           @$groupby;
-         return unless scalar %groupby_col;
-         my $cols = [
-                      grep { _looks_like_column($_->{col}) }
-                      grep { ! exists $_->{func} }
-                      @{$event->{query_struct}->{columns}}
-                    ];
-         foreach my $col ( @$cols ) {
-            return 0 unless $groupby_col{ $col->{col} }
-                         || ($col->{alias} && $groupby_col{ $col->{alias} });
-         }
-         return;
-      },
-   },
-   {
-      id   => 'RES.002',      # non-deterministic LIMIT w/o ORDER BY
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return unless $event->{query_struct}->{limit};
-         return unless    $event->{query_struct}->{from}
-                         || $event->{query_struct}->{into}
-                         || $event->{query_struct}->{tables};
-         return 0 unless $event->{query_struct}->{order_by};
-         return;
-      },
-   },
-   {
-      id   => 'STA.001',      # != instead of <>
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         return 0 if $event->{arg} =~ m/!=/;
-         return;
-      },
-   },
-   {
-      id   => 'SUB.001',      # IN(<subquery>)
-      code => sub {
-         my ( %args ) = @_;
-         my $event = $args{event};
-         if ( $event->{arg} =~ m/\bIN\s*\(\s*SELECT\b/gi ) {
-            return pos $event->{arg};
-         }
-         return;
-      },
-   },
-   {
-      id   => 'JOI.002',      # table joined more than once, but not self-join
-      code => sub {
-         my ( %args ) = @_;
-         my $event  = $args{event};
-         my $struct = $event->{query_struct};
-         return unless $struct;
-         my $tbls   = $struct->{from} || $struct->{into} || $struct->{tables};
-         return unless $tbls;
-         my %tbl_cnt;
-         my $n_tbls = scalar @$tbls;
-
-         for my $i ( 0..($n_tbls-1) ) {
-            my $tbl      = $tbls->[$i];
-            my $tbl_name = lc $tbl->{tbl};
-
-            $tbl_cnt{$tbl_name}->{cnt}++;
-            $tbl_cnt{$tbl_name}->{ansi_join}++
-               if $tbl->{join} && $tbl->{join}->{ansi};
-            $tbl_cnt{$tbl_name}->{comma_join}++
-               if $tbl->{join} && !$tbl->{join}->{ansi};
-
-            if ( $tbl_cnt{$tbl_name}->{cnt} > 1 ) {
-               return 0
-                  if    $tbl_cnt{$tbl_name}->{ansi_join}
-                     && $tbl_cnt{$tbl_name}->{comma_join};
-            }
-         }
-         return;
-      },
-   },
-   {
-      id   => 'JOI.003',  # OUTER JOIN converted to INNER JOIN
-      code => sub {
-         my ( %args ) = @_;
-         my $event  = $args{event};
-         my $struct = $event->{query_struct};
-         return unless $struct;
-         my $tbls   = $struct->{from} || $struct->{into} || $struct->{tables};
-         return unless $tbls;
-         my $where  = $struct->{where};
-         return unless $where;
-
-         my %outer_tbls = map { $_->{tbl} => 1 } get_outer_tables($tbls);
-         PTDEBUG && _d("Outer tables:", keys %outer_tbls);
-         return unless %outer_tbls;
-
-         foreach my $pred ( @$where ) {
-            next unless $pred->{left_arg};  # skip constants like 1 in "WHERE 1"
-            my ($tbl, $col) = split /\./, $pred->{left_arg};
-            if ( $tbl && $col && $outer_tbls{$tbl} ) {
-               if ($pred->{operator} ne 'is' || $pred->{right_arg} !~ m/null/i)
-               {
-                  PTDEBUG && _d("Predicate prevents OUTER JOIN:",
-                     map { $pred->{$_} } qw(left_arg operator right_arg));
-                  return 0;
-               }
-            }
-         }
-
-         return;
-      }
-   },
-   {
-      id   => 'JOI.004',  # broken exclusion join
-      code => sub {
-         my ( %args ) = @_;
-         my $event  = $args{event};
-         my $struct = $event->{query_struct};
-         return unless $struct;
-         my $tbls   = $struct->{from} || $struct->{into} || $struct->{tables};
-         return unless $tbls;
-         my $where  = $struct->{where};
-         return unless $where;
-
-         my %outer_tbls;
-         my %outer_tbl_join_cols;
-         my @unknown_join_cols;
-         foreach my $outer_tbl ( get_outer_tables($tbls) ) {
-            $outer_tbls{$outer_tbl->{tbl}} = 1;
-
-            my $join = $outer_tbl->{join};
-            if ( !$join ) {
-               my ($inner_tbl) = grep { 
-                  exists $_->{join} 
-                  && $_->{join}->{to} eq $outer_tbl->{tbl}
-               } @$tbls;
-               $join = $inner_tbl->{join}; 
-               die "Cannot find join structure for $outer_tbl->{tbl}"
-                  unless $join;
-            }
-
-            if ( $join->{condition} eq 'using' ) {
-               %outer_tbl_join_cols = map { $_ => 1 } @{$join->{columns}};
-            }
-            else {
-               my $where = $join->{where};
-               die "Join structure for ON condition has no where structure"
-                  unless $where;
-               my @join_cols;
-               foreach my $pred ( @$where ) {
-                  next unless $pred->{operator} eq '=';
-                  push @join_cols, $pred->{left_arg}, $pred->{right_arg};
-               }
-               PTDEBUG && _d("Join columns:", @join_cols);
-               foreach my $join_col ( @join_cols ) {
-                  my ($tbl, $col) = split /\./, $join_col;
-                  if ( !$col ) {
-                     $col = $tbl;
-                     $tbl = determine_table_for_column(
-                        column      => $col,
-                        tbl_structs => $event->{tbl_structs},
-                     );
-                  }
-                  if ( !$tbl ) {
-                     PTDEBUG && _d("Cannot determine the table for join column",
-                        $col);
-                     push @unknown_join_cols, $col;
-                  }
-                  else {
-                     $outer_tbl_join_cols{$col} = 1
-                        if $tbl eq $outer_tbl->{tbl};
-                  }
-               }
-            }
-         }
-         PTDEBUG && _d("Outer table join columns:", keys %outer_tbl_join_cols);
-         PTDEBUG && _d("Unknown join columns:", @unknown_join_cols);
-
-         foreach my $pred ( @$where ) {
-            next unless $pred->{left_arg}; # skip constants like 1 in "WHERE 1"
-            next unless $pred->{operator} eq 'is'
-               && $pred->{right_arg} =~ m/NULL/i;
-
-            my ($tbl, $col) = split /\./, $pred->{left_arg};
-            if ( !$col ) {
-               $col = $tbl;
-               $tbl = determine_table_for_column(
-                  column      => $col,
-                  tbl_structs => $event->{tbl_structs},
-               );
-            }
-            next unless $tbl;               # can't check tbl if tbl is unknown
-            next unless $outer_tbls{$tbl};  # only want outer tbl cols
-
-            next if $outer_tbl_join_cols{$col};
-
-            return 0 unless grep { $col eq $_ } @unknown_join_cols;
-         }
-
-         return;  # rule does not match, as best as we can determine
-      }
-   },
-};
-
-
-sub get_outer_tables {
-   my ( $tbls ) = @_;
-   return unless $tbls;
-   my @outer_tbls;
-   my $n_tbls = scalar @$tbls;
-   for my $i( 0..($n_tbls-1) ) {
-      my $tbl = $tbls->[$i];
-      next unless $tbl->{join} && $tbl->{join}->{type} =~ m/left|right/i;
-      push @outer_tbls,
-         $tbl->{join}->{type} =~ m/left/i ? $tbl
-                                          : $tbls->[$i - 1];
-   }
-   return @outer_tbls;
-}
-
-
-sub determine_table_for_column {
-   my ( %args ) = @_;
-   my @required_args = qw(column);
-   foreach my $arg ( @required_args ) {
-      die "I need a $arg argument" unless $args{$arg};
-   }
-   my ($col) = @args{@required_args};
-
-   my $tbl_structs = $args{tbl_structs};
-   return unless $tbl_structs;
-
-   foreach my $db ( keys %$tbl_structs ) {
-      foreach my $tbl ( keys %{$tbl_structs->{$db}} ) {
-         if ( $tbl_structs->{$db}->{$tbl}->{is_col}->{$col} ) {
-            PTDEBUG && _d($col, "column belongs to", $db, $tbl);
-            return $tbl;
-         }
-      }
-   }
-
-   PTDEBUG && _d("Cannot determine table for column", $col);
-   return;
-}
-
-sub _looks_like_column {
-   my $col = shift;
-   return if $col eq '*' || uc($col) eq 'NULL';
-   return if $col =~ /\A(?:\b[0-9]+\b|\@{1,2}.+)/;
-   return $col;
-}
-
-sub _d {
-   my ($package, undef, $line) = caller 0;
-   @_ = map { (my $temp = $_) =~ s/\n/\n# /g; $temp; }
-        map { defined $_ ? $_ : 'undef' }
-        @_;
-   print STDERR "# $package:$line $PID ", join(' ', @_), "\n";
-}
-
-1;
-}
-# ###########################################################################
-# End QueryAdvisorRules package
-# ###########################################################################
-
-# ###########################################################################
-# PodParser package
-# This package is a copy without comments from the original.  The original
-# with comments and its test file can be found in the Bazaar repository at,
-#   lib/PodParser.pm
-#   t/lib/PodParser.t
-# See https://launchpad.net/percona-toolkit for more information.
-# ###########################################################################
-{
-package PodParser;
-
-use strict;
-use warnings FATAL => 'all';
-use English qw(-no_match_vars);
-use constant PTDEBUG => $ENV{PTDEBUG} || 0;
-
-my %parse_items_from = (
-   'OPTIONS'     => 1,
-   'DSN OPTIONS' => 1,
-   'RULES'       => 1,
-);
-
-my %item_pattern_for = (
-   'OPTIONS'     => qr/--(.*)/,
-   'DSN OPTIONS' => qr/\* (.)/,
-   'RULES'       => qr/(.*)/,
-);
-
-my %section_has_rules = (
-   'OPTIONS'     => 1,
-   'DSN OPTIONS' => 0,
-   'RULES'       => 0,
-);
-
-sub new {
-   my ( $class, %args ) = @_;
-   my $self = {
-      current_section => '',
-      current_item    => '',
-      items           => {},  # keyed off SECTION
-      magic           => {},  # keyed off SECTION->magic ident (without MAGIC_)
-      magic_ident     => '',  # set when next para is a magic para
-   };
-   return bless $self, $class;
-}
- 
-sub get_items {
-   my ( $self, $section ) = @_;
-   return $section ? $self->{items}->{$section} : $self->{items};
-}
-
-sub get_magic {
-   my ( $self, $section ) = @_;
-   return $section ? $self->{magic}->{$section} : $self->{magic};
-}
-
-sub parse_from_file {
-   my ( $self, $file ) = @_;
-   return unless $file;
-   PTDEBUG && _d('Parsing POD in', $file);
-   open my $fh, "<", $file or die "Cannot open $file: $OS_ERROR";
-   local $INPUT_RECORD_SEPARATOR = '';  # read paragraphs
-   my $para;
-
-   1 while defined($para = <$fh>) && $para !~ m/^=pod/;
-   die "$file does not contain =pod" unless $para;
-
-   while ( defined($para = <$fh>) && $para !~ m/^=cut/ ) {
-      if ( $para =~ m/^=(head|item|over|back)/ ) {
-         my ($cmd, $name) = $para =~ m/^=(\w+)(?:\s+(.+))?/;
-         $name ||= '';
-         PTDEBUG && _d('cmd:', $cmd, 'name:', $name);
-         $self->command($cmd, $name);
-      }
-      elsif ( $parse_items_from{$self->{current_section}} ) {
-         $self->textblock($para);
-      }
-   }
-
-   close $fh;
-}
-
-sub command {
-   my ( $self, $cmd, $name ) = @_;
-   
-   $name =~ s/\s+\Z//m;  # Remove \n and blank line after name.
-
-   if  ( $cmd eq 'head1' ) {
-      PTDEBUG && _d('In section', $name);
-      $self->{current_section} = $name;
-   }
-   elsif ( $cmd eq 'over' ) {
-      if ( $parse_items_from{$name} ) {
-         PTDEBUG && _d('Start items in', $self->{current_section});
-         $self->{items}->{$self->{current_section}} = {};
-      }
-   }
-   elsif ( $cmd eq 'item' && $parse_items_from{$self->{current_section}} ) {
-      my $pat = $item_pattern_for{ $self->{current_section} };
-      my ($item) = $name =~ m/$pat/;
-      if ( $item ) {
-         PTDEBUG && _d($self->{current_section}, 'item:', $item);
-         $self->{items}->{ $self->{current_section} }->{$item} = {
-            desc => '',  # every item should have a desc
-         };
-         $self->{current_item} = $item;
-      }
-      else {
-         warn "Item $name does not match $pat";
-      }
-   }
-   elsif ( $cmd eq 'back' ) {
-      if ( $parse_items_from{$self->{current_section}} ) {
-         PTDEBUG && _d('End items in', $self->{current_section});
-      }
-   }
-   else {
-      $self->{current_section} = '';
-   }
-   
-   return;
-}
-
-sub textblock {
-   my ( $self, $para ) = @_;
-
-   return unless $self->{current_section} && $self->{current_item};
-