ansible/library/ohai

#!/usr/bin/python
# -*- coding: utf-8 -*-

# (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/>.
#

DOCUMENTATION = '''
---
module: ohai
short_description: Returns inventory data from I(Ohai)
description:
     - Similar to the M(facter) module, this runs the I(Ohai) discovery program
       (U(http://wiki.opscode.com/display/chef/Ohai)) on the remote host and 
       returns JSON inventory data.
       I(Ohai) data is a bit more verbose and nested than I(facter).
version_added: "0.6"
options: {}
examples:
   - code: ansible webservers -m ohai --tree=/tmp/ohaidata
     description: "Retrieve I(ohai) data from all Web servers and store in one-file per host"
notes: []
requirements: [ "ohai" ]
author: Michael DeHaan
'''

def main():
    module = AnsibleModule(
        argument_spec = dict()
    )
    cmd = ["/usr/bin/env", "ohai"]
    rc, out, err = module.run_command(cmd, check_rc=True)
    module.exit_json(**json.loads(out))

# this is magic, see lib/ansible/module_common.py
#<<INCLUDE_ANSIBLE_MODULE_COMMON>>

main()
Port the ohai module over, while this is actually longer now, not transferring the args file makes this much faster. 2012-07-28 21:07:55 +00:00			`#!/usr/bin/python`
Add encoding lines to python modules such that they can take unicode options if they are fed them, since the AnsibleModule stuff no longer base64 encodes for simplicity and speed reasons. 2012-08-03 01:29:10 +00:00			`# -- coding: utf-8 --`
Added an 'ohai' module. Some weird JSON hackage to get it to work. 2012-02-24 07:04:50 +00:00
Relicensing to GPLv3, all previous committers ok'd on mailing list. 2012-02-29 00:08:09 +00: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/>.`
			`#`

DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`DOCUMENTATION = '''`
			`---`
			`module: ohai`
DOCUMENTATION strings 2012-11-21 17:49:30 +00:00			`short_description: Returns inventory data from I(Ohai)`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`description:`
DOCUMENTATION strings 2012-11-21 17:49:30 +00:00			`- Similar to the M(facter) module, this runs the I(Ohai) discovery program`
Jumbo DOCUMENTATION patch 2012-10-01 07:18:54 +00:00			`(U(http://wiki.opscode.com/display/chef/Ohai)) on the remote host and`
			`returns JSON inventory data.`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`I(Ohai) data is a bit more verbose and nested than I(facter).`
			`version_added: "0.6"`
Module documentation should have options sorted 2012-11-03 22:52:59 +00:00			`options: {}`
DOCUMENTATION for fetch,mount,ohai,easy_install - .rst now supresses default if none is set (looks better in HTML) - .rst now handles empty options list - Fixed postgresql_user and mysql_user because YAML contained colons - docs for facter 2012-09-30 10:21:35 +00:00			`examples:`
			`- code: ansible webservers -m ohai --tree=/tmp/ohaidata`
			`description: "Retrieve I(ohai) data from all Web servers and store in one-file per host"`
			`notes: []`
			`requirements: [ "ohai" ]`
			`author: Michael DeHaan`
			`'''`

Port the ohai module over, while this is actually longer now, not transferring the args file makes this much faster. 2012-07-28 21:07:55 +00:00			`def main():`
			`module = AnsibleModule(`
			`argument_spec = dict()`
			`)`
Update modules to use run_command in module_common.py This updates apt, apt_repository, command, cron, easy_install, facter, fireball, git, group, mount, ohai, pip, service, setup, subversion, supervisorctl, svr4pkg, user, and yum to take advantage of run_command in module_common.py. 2013-01-12 06:10:21 +00:00			`cmd = ["/usr/bin/env", "ohai"]`
Various cleanup to run_command * Rename fail_on_rc_non_zero to check_rc, much more succinct. * Simplify method defintion * Fix command module and drop shell=shell option; whether to use shell is determined by if args is a list. 2013-01-13 17:12:40 +00:00			`rc, out, err = module.run_command(cmd, check_rc=True)`
Update modules to use run_command in module_common.py This updates apt, apt_repository, command, cron, easy_install, facter, fireball, git, group, mount, ohai, pip, service, setup, subversion, supervisorctl, svr4pkg, user, and yum to take advantage of run_command in module_common.py. 2013-01-12 06:10:21 +00:00			`module.exit_json(**json.loads(out))`
Port the ohai module over, while this is actually longer now, not transferring the args file makes this much faster. 2012-07-28 21:07:55 +00:00
			`# this is magic, see lib/ansible/module_common.py`
			`#<<INCLUDE_ANSIBLE_MODULE_COMMON>>`

			`main()`