2013-02-01 23:11:38 +01:00
|
|
|
#!/usr/bin/env python
|
2012-03-15 02:49:27 +01:00
|
|
|
|
|
|
|
# (c) 2012, Michael DeHaan <michael.dehaan@gmail.com>
|
|
|
|
#
|
|
|
|
# This file is part of Ansible
|
|
|
|
#
|
|
|
|
# Ansible is free software: you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
|
|
# (at your option) any later version.
|
|
|
|
#
|
|
|
|
# Ansible is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
#
|
|
|
|
|
|
|
|
# this script is for testing modules without running through the
|
|
|
|
# entire guts of ansible, and is very helpful for when developing
|
|
|
|
# modules
|
|
|
|
#
|
|
|
|
# example:
|
2014-07-20 20:54:30 +02:00
|
|
|
# test-module -m ../library/commands/command -a "/bin/sleep 3"
|
|
|
|
# test-module -m ../library/system/service -a "name=httpd ensure=restarted"
|
|
|
|
# test-module -m ../library/system/service -a "name=httpd ensure=restarted" --debugger /usr/bin/pdb
|
2015-07-22 03:23:59 +02:00
|
|
|
# test-module -m ../library/file/lineinfile -a "dest=/etc/exports line='/srv/home hostname1(rw,sync)'" --check
|
2014-09-09 11:06:06 +02:00
|
|
|
# test-module -m ../library/commands/command -a "echo hello" -n -o "test_hello"
|
2012-03-15 02:49:27 +01:00
|
|
|
|
|
|
|
import sys
|
2012-07-24 01:28:43 +02:00
|
|
|
import base64
|
2012-03-15 02:49:27 +01:00
|
|
|
import os
|
|
|
|
import subprocess
|
|
|
|
import traceback
|
2012-07-23 18:04:28 +02:00
|
|
|
import optparse
|
2015-07-17 12:44:00 +02:00
|
|
|
import ansible.utils.vars as utils_vars
|
2015-10-26 22:23:09 +01:00
|
|
|
from ansible.parsing.dataloader import DataLoader
|
2015-07-02 20:16:33 +02:00
|
|
|
from ansible.parsing.utils.jsonify import jsonify
|
2015-07-02 20:57:57 +02:00
|
|
|
from ansible.parsing.splitter import parse_kv
|
2015-07-17 00:56:18 +02:00
|
|
|
import ansible.executor.module_common as module_common
|
2012-11-10 07:13:00 +01:00
|
|
|
import ansible.constants as C
|
2012-03-15 02:49:27 +01:00
|
|
|
|
|
|
|
try:
|
|
|
|
import json
|
|
|
|
except ImportError:
|
|
|
|
import simplejson as json
|
|
|
|
|
2012-07-23 18:04:28 +02:00
|
|
|
def parse():
|
|
|
|
"""parse command line
|
|
|
|
|
|
|
|
:return : (options, args)"""
|
|
|
|
parser = optparse.OptionParser()
|
|
|
|
|
2012-07-24 01:33:26 +02:00
|
|
|
parser.usage = "%prog -[options] (-h for help)"
|
2012-07-23 18:04:28 +02:00
|
|
|
|
2012-07-23 18:28:06 +02:00
|
|
|
parser.add_option('-m', '--module-path', dest='module_path',
|
2012-07-24 01:33:26 +02:00
|
|
|
help="REQUIRED: full path of module source to execute")
|
2012-07-23 18:04:28 +02:00
|
|
|
parser.add_option('-a', '--args', dest='module_args', default="",
|
2012-07-24 01:33:26 +02:00
|
|
|
help="module argument string")
|
2012-07-23 18:04:28 +02:00
|
|
|
parser.add_option('-D', '--debugger', dest='debugger',
|
|
|
|
help="path to python debugger (e.g. /usr/bin/pdb)")
|
2013-12-30 21:32:13 +01:00
|
|
|
parser.add_option('-I', '--interpreter', dest='interpreter',
|
2014-12-04 23:23:35 +01:00
|
|
|
help="path to interpreter to use for this module (e.g. ansible_python_interpreter=/usr/bin/python)",
|
2015-05-06 12:57:25 +02:00
|
|
|
metavar='INTERPRETER_TYPE=INTERPRETER_PATH',
|
|
|
|
default='python={}'.format(sys.executable))
|
2014-07-20 20:54:30 +02:00
|
|
|
parser.add_option('-c', '--check', dest='check', action='store_true',
|
|
|
|
help="run the module in check mode")
|
2014-09-09 11:06:06 +02:00
|
|
|
parser.add_option('-n', '--noexecute', dest='execute', action='store_false',
|
|
|
|
default=True, help="do not run the resulting module")
|
2015-07-22 03:23:59 +02:00
|
|
|
parser.add_option('-o', '--output', dest='filename',
|
2014-09-09 11:06:06 +02:00
|
|
|
help="Filename for resulting module",
|
|
|
|
default="~/.ansible_module_generated")
|
2012-07-23 18:04:28 +02:00
|
|
|
options, args = parser.parse_args()
|
2012-07-23 18:28:06 +02:00
|
|
|
if not options.module_path:
|
2012-07-23 18:04:28 +02:00
|
|
|
parser.print_help()
|
|
|
|
sys.exit(1)
|
|
|
|
else:
|
|
|
|
return options, args
|
|
|
|
|
2013-04-25 00:32:53 +02:00
|
|
|
def write_argsfile(argstring, json=False):
|
2012-07-24 01:28:43 +02:00
|
|
|
""" Write args to a file for old-style module's use. """
|
2012-07-23 18:04:28 +02:00
|
|
|
argspath = os.path.expanduser("~/.ansible_test_module_arguments")
|
|
|
|
argsfile = open(argspath, 'w')
|
2013-04-25 00:32:53 +02:00
|
|
|
if json:
|
2015-07-02 20:57:57 +02:00
|
|
|
args = parse_kv(argstring)
|
2015-07-02 20:16:33 +02:00
|
|
|
argstring = jsonify(args)
|
2012-07-23 18:04:28 +02:00
|
|
|
argsfile.write(argstring)
|
|
|
|
argsfile.close()
|
|
|
|
return argspath
|
|
|
|
|
2014-09-09 11:06:06 +02:00
|
|
|
def boilerplate_module(modfile, args, interpreter, check, destfile):
|
2012-07-24 01:28:43 +02:00
|
|
|
""" simulate what ansible does with new style modules """
|
|
|
|
|
2013-10-31 21:52:37 +01:00
|
|
|
#module_fh = open(modfile)
|
|
|
|
#module_data = module_fh.read()
|
|
|
|
#module_fh.close()
|
|
|
|
|
2015-07-17 00:56:18 +02:00
|
|
|
#replacer = module_common.ModuleReplacer()
|
2015-07-17 12:44:00 +02:00
|
|
|
loader = DataLoader()
|
2013-10-31 21:52:37 +01:00
|
|
|
|
|
|
|
#included_boilerplate = module_data.find(module_common.REPLACER) != -1 or module_data.find("import ansible.module_utils") != -1
|
|
|
|
|
|
|
|
complex_args = {}
|
2014-02-07 20:09:47 +01:00
|
|
|
if args.startswith("@"):
|
|
|
|
# Argument is a YAML file (JSON is a subset of YAML)
|
2015-07-17 12:44:00 +02:00
|
|
|
complex_args = utils_vars.combine_vars(complex_args, loader.load_from_file(args[1:]))
|
2014-02-07 20:09:47 +01:00
|
|
|
args=''
|
2014-04-10 21:14:42 +02:00
|
|
|
elif args.startswith("{"):
|
|
|
|
# Argument is a YAML document (not a file)
|
2015-07-17 12:44:00 +02:00
|
|
|
complex_args = utils_vars.combine_vars(complex_args, loader.load(args))
|
2014-04-10 21:14:42 +02:00
|
|
|
args=''
|
2014-02-07 20:09:47 +01:00
|
|
|
|
2015-08-01 05:40:07 +02:00
|
|
|
if args:
|
|
|
|
parsed_args = parse_kv(args)
|
|
|
|
complex_args = utils_vars.combine_vars(complex_args, parsed_args)
|
|
|
|
|
|
|
|
task_vars = {}
|
2013-12-30 21:32:13 +01:00
|
|
|
if interpreter:
|
|
|
|
if '=' not in interpreter:
|
2015-08-31 02:35:14 +02:00
|
|
|
print("interpreter must by in the form of ansible_python_interpreter=/usr/bin/python")
|
2013-12-30 21:32:13 +01:00
|
|
|
sys.exit(1)
|
|
|
|
interpreter_type, interpreter_path = interpreter.split('=')
|
|
|
|
if not interpreter_type.startswith('ansible_'):
|
|
|
|
interpreter_type = 'ansible_%s' % interpreter_type
|
|
|
|
if not interpreter_type.endswith('_interpreter'):
|
|
|
|
interpreter_type = '%s_interpreter' % interpreter_type
|
2015-08-01 05:40:07 +02:00
|
|
|
task_vars[interpreter_type] = interpreter_path
|
2014-07-20 20:54:30 +02:00
|
|
|
|
|
|
|
if check:
|
|
|
|
complex_args['CHECKMODE'] = True
|
|
|
|
|
2015-07-17 00:56:18 +02:00
|
|
|
(module_data, module_style, shebang) = module_common.modify_module(
|
2015-08-01 05:40:07 +02:00
|
|
|
modfile,
|
2013-10-31 21:52:37 +01:00
|
|
|
complex_args,
|
2015-08-01 05:40:07 +02:00
|
|
|
task_vars=task_vars
|
2013-10-31 21:52:37 +01:00
|
|
|
)
|
2013-04-25 00:32:53 +02:00
|
|
|
|
2014-09-09 11:06:06 +02:00
|
|
|
modfile2_path = os.path.expanduser(destfile)
|
2015-08-31 02:35:14 +02:00
|
|
|
print("* including generated source, if any, saving to: %s" % modfile2_path)
|
|
|
|
print("* this may offset any line numbers in tracebacks/debuggers!")
|
2013-10-31 21:52:37 +01:00
|
|
|
modfile2 = open(modfile2_path, 'w')
|
|
|
|
modfile2.write(module_data)
|
|
|
|
modfile2.close()
|
|
|
|
modfile = modfile2_path
|
2013-10-26 17:09:30 +02:00
|
|
|
|
2013-10-31 21:52:37 +01:00
|
|
|
return (modfile2_path, module_style)
|
2012-07-23 18:04:28 +02:00
|
|
|
|
2012-07-23 18:28:06 +02:00
|
|
|
def runtest( modfile, argspath):
|
|
|
|
"""Test run a module, piping it's output for reporting."""
|
2012-07-24 01:28:43 +02:00
|
|
|
|
2012-07-23 18:04:28 +02:00
|
|
|
os.system("chmod +x %s" % modfile)
|
2012-07-24 01:28:43 +02:00
|
|
|
|
|
|
|
invoke = "%s" % (modfile)
|
2015-08-31 02:35:14 +02:00
|
|
|
if argspath is not None:
|
2012-07-24 01:28:43 +02:00
|
|
|
invoke = "%s %s" % (modfile, argspath)
|
|
|
|
|
|
|
|
cmd = subprocess.Popen(invoke, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
|
2012-07-23 18:04:28 +02:00
|
|
|
(out, err) = cmd.communicate()
|
|
|
|
|
|
|
|
try:
|
2015-08-31 02:35:14 +02:00
|
|
|
print("***********************************")
|
|
|
|
print("RAW OUTPUT")
|
|
|
|
print(out)
|
|
|
|
print(err)
|
2015-07-02 20:16:33 +02:00
|
|
|
results = json.loads(out)
|
2012-07-23 18:04:28 +02:00
|
|
|
except:
|
2015-08-31 02:35:14 +02:00
|
|
|
print("***********************************")
|
|
|
|
print("INVALID OUTPUT FORMAT")
|
|
|
|
print(out)
|
2012-07-23 18:04:28 +02:00
|
|
|
traceback.print_exc()
|
|
|
|
sys.exit(1)
|
2012-03-16 02:53:14 +01:00
|
|
|
|
2015-08-31 02:35:14 +02:00
|
|
|
print("***********************************")
|
|
|
|
print("PARSED OUTPUT")
|
|
|
|
print(jsonify(results,format=True))
|
2012-03-15 02:49:27 +01:00
|
|
|
|
2012-07-23 18:28:06 +02:00
|
|
|
def rundebug(debugger, modfile, argspath):
|
|
|
|
"""Run interactively with console debugger."""
|
|
|
|
|
2012-07-24 01:28:43 +02:00
|
|
|
if argspath is not None:
|
|
|
|
subprocess.call("%s %s %s" % (debugger, modfile, argspath), shell=True)
|
|
|
|
else:
|
|
|
|
subprocess.call("%s %s" % (debugger, modfile), shell=True)
|
2012-07-23 18:28:06 +02:00
|
|
|
|
2015-08-31 02:35:14 +02:00
|
|
|
def main():
|
2012-07-23 18:28:06 +02:00
|
|
|
|
2012-07-24 01:28:43 +02:00
|
|
|
options, args = parse()
|
2014-09-09 11:06:06 +02:00
|
|
|
(modfile, module_style) = boilerplate_module(options.module_path, options.module_args, options.interpreter, options.check, options.filename)
|
2013-04-25 00:32:53 +02:00
|
|
|
|
2015-07-02 20:59:58 +02:00
|
|
|
argspath = None
|
2013-10-31 21:52:37 +01:00
|
|
|
if module_style != 'new':
|
|
|
|
if module_style == 'non_native_want_json':
|
2013-04-25 00:32:53 +02:00
|
|
|
argspath = write_argsfile(options.module_args, json=True)
|
2013-10-31 21:52:37 +01:00
|
|
|
elif module_style == 'old':
|
2013-10-30 15:50:16 +01:00
|
|
|
argspath = write_argsfile(options.module_args, json=False)
|
2013-10-31 21:52:37 +01:00
|
|
|
else:
|
|
|
|
raise Exception("internal error, unexpected module style: %s" % module_style)
|
2014-09-09 11:06:06 +02:00
|
|
|
if options.execute:
|
2015-07-22 03:23:59 +02:00
|
|
|
if options.debugger:
|
2014-09-09 11:06:06 +02:00
|
|
|
rundebug(options.debugger, modfile, argspath)
|
|
|
|
else:
|
|
|
|
runtest(modfile, argspath)
|
2015-08-31 02:35:14 +02:00
|
|
|
|
2012-07-23 18:04:28 +02:00
|
|
|
if __name__ == "__main__":
|
|
|
|
main()
|
2012-03-15 02:49:27 +01:00
|
|
|
|