Merge commit '8ae71cc' into integration

Conflicts:
	bin/ansible
	bin/ansible-playbook
	lib/ansible/utils.py

bin/ansible

@@ -47,23 +47,12 @@ class Cli(object):
     def parse(self):
         ''' create an options parser for bin/ansible '''
         
-
+        parser = utils.base_parser(constants=C, runas_opts=True, async_opts=True,
-        options = {
+            output_opts=True, usage='%prog <host-pattern> [options]')
-            '-a' : dict(long='--args', dest='module_args', 
+        parser.add_option('-a', '--args', dest='module_args',
-                       help="module arguments", default=C.DEFAULT_MODULE_ARGS),
+            help="module arguments", default=C.DEFAULT_MODULE_ARGS)
-            '-m' : dict(long='--module-name', dest='module_name', 
+        parser.add_option('-m', '--module-name', dest='module_name',
-                       help="module name to execute", default=C.DEFAULT_MODULE_NAME)
+            help="module name to execute", default=C.DEFAULT_MODULE_NAME)
-        }        
-
-        parser = utils.make_parser(
-	    options,
-            usage='%prog <host-pattern> [options]',
-            runas_opts=True, 
-            async_opts=True,
-            output_opts=True, 
-            
-        )
-
 
         options, args = parser.parse_args()
         self.callbacks.options = options        

bin/ansible-playbook

@@ -32,14 +32,13 @@ def main(args):
     ''' run ansible-playbook operations '''
 
     # create parser for CLI options
-    usage = "%prog <playbook-file1 [playbook-file2...]> [options]"
+    usage = "%prog playbook.yml"
-    options = {
+    parser = utils.base_parser(constants=C, usage=usage)
-       '-e' : dict(long='--extra-vars', dest='extra_vars',
+    parser.add_option('-e', '--extra-vars', dest='extra_vars',
-                   help='pass in extra key=value variables from outside the playbook'),
+        help='arguments to pass to the inventory script')
-       '-O' : dict(long='--override-hosts', dest="override_hosts", default=None,
+    parser.add_option('-O', '--override-hosts', dest="override_hosts", default=None,
-                   help="run playbook against only hosts, ignorning the inventory file")
+        help="run playbook against these hosts regardless of inventory settings")
-    }
+
-    parser = utils.make_parser(options, constants=C, usage=usage)
     options, args = parser.parse_args(args)
 
     if len(args) == 0:

lib/ansible/utils.py

@@ -24,7 +24,7 @@ import re
 import jinja2
 import yaml
 import optparse
-
+from operator import methodcaller
 try:
     import json
 except ImportError:
@@ -273,72 +273,49 @@ def parse_kv(args):
             options[k]=v
     return options
 
-def make_parser(add_options, constants=C, usage="", output_opts=False, runas_opts=False, async_opts=False):
+class SortedOptParser(optparse.OptionParser):
-    ''' create an options parser w/ common options for any ansible program '''
+    '''Optparser which sorts the options by opt before outputting --help'''
-
+    def format_help(self, formatter=None):
-    options = base_parser_options(
+        self.option_list.sort(key=methodcaller('get_opt_string'))
-        constants=constants, 
+        return optparse.OptionParser.format_help(self, formatter=None)
-        output_opts=output_opts, 
+
-        runas_opts=runas_opts,
+def base_parser(constants=C, usage="", output_opts=False, runas_opts=False, async_opts=False):
-        async_opts=async_opts
+    ''' create an options parser for any ansible script '''
-    )
+
-    options.update(add_options)
+    parser = SortedOptParser(usage)
-
+    parser.add_option('-D','--debug', default=False, action="store_true",
-    #NOTE: optparse deprecated in Python >= 2.7. 
+        help='enable standard error debugging of modules.')
-    parser = optparse.OptionParser()
+    parser.add_option('-f','--forks', dest='forks', default=constants.DEFAULT_FORKS, type='int',
-    parser.set_usage(usage)
+        help='number of parallel processes to use')
-    names = sorted(options.keys())
+    parser.add_option('-i', '--inventory-file', dest='inventory',
-    for n in names:
+       help='inventory host file', default=constants.DEFAULT_HOST_LIST)
-        data  = options[n].copy()
+    parser.add_option('-k', '--ask-pass', default=False, action='store_true',
-        long  = data['long']
+        help='ask for SSH password')
-        del data['long']
+    parser.add_option('-M', '--module-path', dest='module_path',
-        parser.add_option(n, long, **data)
+       help="path to module library", default=constants.DEFAULT_MODULE_PATH)
-    return parser
+    parser.add_option('-T', '--timeout', default=constants.DEFAULT_TIMEOUT, type='int',
-
+        dest='timeout', help='set the SSH timeout in seconds')
-def base_parser_options(constants=C, output_opts=False, runas_opts=False, async_opts=False):
+    parser.add_option('-p', '--port', default=constants.DEFAULT_REMOTE_PORT, type='int',
-    ''' creates common options for ansible programs '''
+        dest='remote_port', help='set the remote ssh port')
-
-    options = {
-        '-D': dict(long='--debug', default=False, action="store_true",
-                   help='show debug/verbose module output'),
-        '-f': dict(long='--forks', dest='forks', default=constants.DEFAULT_FORKS, type='int',
-                   help='number of parallel processes to use'),
-        '-i': dict(long='--inventory-file', dest='inventory',
-                   help='path to inventory host file', default=constants.DEFAULT_HOST_LIST),
-        '-k': dict(long='--ask-pass', default=False, action='store_true',
-                   help='ask for SSH password'),
-        '-M': dict(long='--module-path', dest='module_path',
-                   help="path to module library directory", default=constants.DEFAULT_MODULE_PATH),
-        '-T': dict(long='--timeout', default=constants.DEFAULT_TIMEOUT, type='int',
-                   dest='timeout', help='set the SSH connection timeout in seconds'),
-        '-p': dict(long='--port', default=constants.DEFAULT_REMOTE_PORT, type='int',
-                   dest='remote_port', help='use this remote SSH port'),
-    }
 
     if output_opts:
-        options.update({
+        parser.add_option('-o', '--one-line', dest='one_line', action='store_true',
-            '-o' : dict(long='--one-line', dest='one_line', action='store_true',
+            help='condense output')
-                        help='condense output'),
+        parser.add_option('-t', '--tree', dest='tree', default=None,
-            '-t' : dict(long='--tree', dest='tree', default=None,
+            help='log output to this directory')
-                        help='log results to this directory')
-        })
 
     if runas_opts:
-        options.update({
+        parser.add_option("-s", "--sudo", default=False, action="store_true",
-            '-s' : dict(long="--sudo", default=False, action="store_true",
+            dest='sudo', help="run operations with sudo (nopasswd)")
-                        dest='sudo', help="run operations with sudo (nopasswd)"),
+        parser.add_option('-u', '--user', default=constants.DEFAULT_REMOTE_USER,
-            '-u' : dict(long='--user', default=constants.DEFAULT_REMOTE_USER,
+            dest='remote_user', help='connect as this user')
-                        dest='remote_user', help='connect as this user'),
-        })
     
     if async_opts:
-        options.update({
+        parser.add_option('-P', '--poll', default=constants.DEFAULT_POLL_INTERVAL, type='int',
-            '-P' : dict(long='--poll', default=constants.DEFAULT_POLL_INTERVAL, type='int',
+            dest='poll_interval', help='set the poll interval if using -B')
-                        dest='poll_interval', help='set the poll interval if using -B'),
+        parser.add_option('-B', '--background', dest='seconds', type='int', default=0,
-            '-B' : dict(long='--background', dest='seconds', type='int', default=0,
+            help='run asynchronously, failing after X seconds')
-                        help='run asynchronously, failing after X seconds'),
-        })
 
-    return options
+    return parser