summaryrefslogtreecommitdiffstats
path: root/func/minion/modules/command.py
blob: b822121a48d6cca2811ce2df34ab4c009d633c0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# Copyright 2007, Red Hat, Inc
# James Bowes <jbowes@redhat.com>
# Steve 'Ashcrow' Milner <smilner@redhat.com>
#
# This software may be freely redistributed under the terms of the GNU
# general public license.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

"""
Abitrary command execution module for func.
"""

import func_module
from func.minion import sub_process

class Command(func_module.FuncModule):

    version = "0.0.1"
    api_version = "0.0.2"
    description = "Works with shell commands."

    def run(self, command, env=None):
        """
        Runs a command, returning the return code, stdout, and stderr as a tuple.
        NOT FOR USE WITH INTERACTIVE COMMANDS.
        """
        cmdref = sub_process.Popen(command, stdout=sub_process.PIPE,
                                   stderr=sub_process.PIPE, shell=True,
                                   close_fds=True, env=env)
        data = cmdref.communicate()
        return (cmdref.returncode, data[0], data[1])

    def exists(self, command):
        """
        Checks to see if a command exists on the target system(s).
        """
        import os

        if os.access(command, os.X_OK):
            return True
        return False

    def register_method_args(self):
        """
        The argument export method
        """
        #common type in both descriptions
        command = {
                'type':'string',
                'optional':False,
                'description':'The command that is going to be used',
                }

        return {
                'run':{
                    'args':{
                        'command':command
                        },
                    'description':'Run a specified command'
                    },
                'exists':{
                    'args':{
                        'command':command
                        },
                    'description':'Check if specific command exists'
                    }
                }