/usr/share/pyshared/gearman/admin_client.py is in python-gearman 2.0.2-2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | import logging
import time
from gearman import util
from gearman.connection_manager import GearmanConnectionManager
from gearman.admin_client_handler import GearmanAdminClientCommandHandler
from gearman.errors import ConnectionError, InvalidAdminClientState, ServerUnavailable
from gearman.protocol import GEARMAN_COMMAND_ECHO_RES, GEARMAN_COMMAND_ECHO_REQ, \
GEARMAN_SERVER_COMMAND_STATUS, GEARMAN_SERVER_COMMAND_VERSION, GEARMAN_SERVER_COMMAND_WORKERS, \
GEARMAN_SERVER_COMMAND_MAXQUEUE, GEARMAN_SERVER_COMMAND_SHUTDOWN
gearman_logger = logging.getLogger(__name__)
ECHO_STRING = "ping? pong!"
DEFAULT_ADMIN_CLIENT_TIMEOUT = 10.0
class GearmanAdminClient(GearmanConnectionManager):
"""GearmanAdminClient :: Interface to send/receive administrative commands to a Gearman server
This client acts as a BLOCKING client and each call will poll until it receives a satisfactory server response
http://gearman.org/index.php?id=protocol
See section 'Administrative Protocol'
"""
command_handler_class = GearmanAdminClientCommandHandler
def __init__(self, host_list=None, poll_timeout=DEFAULT_ADMIN_CLIENT_TIMEOUT):
super(GearmanAdminClient, self).__init__(host_list=host_list)
self.poll_timeout = poll_timeout
self.current_connection = util.unlist(self.connection_list)
self.current_handler = None
def establish_admin_connection(self):
try:
self.establish_connection(self.current_connection)
except ConnectionError:
raise ServerUnavailable('Found no valid connections in list: %r' % self.connection_list)
self.current_handler = self.connection_to_handler_map[self.current_connection]
def ping_server(self):
"""Sends off a debugging string to execute an application ping on the Gearman server"""
start_time = time.time()
self.establish_admin_connection()
self.current_handler.send_echo_request(ECHO_STRING)
server_response = self.wait_until_server_responds(GEARMAN_COMMAND_ECHO_REQ)
if server_response != ECHO_STRING:
raise InvalidAdminClientState("Echo string mismatch: got %s, expected %s" % (server_response, ECHO_STRING))
elapsed_time = time.time() - start_time
return elapsed_time
def send_maxqueue(self, task, max_size):
"""Sends a request to change the maximum queue size for a given task"""
self.establish_admin_connection()
self.current_handler.send_text_command('%s %s %s' % (GEARMAN_SERVER_COMMAND_MAXQUEUE, task, max_size))
return self.wait_until_server_responds(GEARMAN_SERVER_COMMAND_MAXQUEUE)
def send_shutdown(self, graceful=True):
"""Sends a request to shutdown the connected gearman server"""
actual_command = GEARMAN_SERVER_COMMAND_SHUTDOWN
if graceful:
actual_command += ' graceful'
self.establish_admin_connection()
self.current_handler.send_text_command(actual_command)
return self.wait_until_server_responds(GEARMAN_SERVER_COMMAND_SHUTDOWN)
def get_status(self):
"""Retrieves a list of all registered tasks and reports how many items/workers are in the queue"""
self.establish_admin_connection()
self.current_handler.send_text_command(GEARMAN_SERVER_COMMAND_STATUS)
return self.wait_until_server_responds(GEARMAN_SERVER_COMMAND_STATUS)
def get_version(self):
"""Retrieves the version number of the Gearman server"""
self.establish_admin_connection()
self.current_handler.send_text_command(GEARMAN_SERVER_COMMAND_VERSION)
return self.wait_until_server_responds(GEARMAN_SERVER_COMMAND_VERSION)
def get_workers(self):
"""Retrieves a list of workers and reports what tasks they're operating on"""
self.establish_admin_connection()
self.current_handler.send_text_command(GEARMAN_SERVER_COMMAND_WORKERS)
return self.wait_until_server_responds(GEARMAN_SERVER_COMMAND_WORKERS)
def wait_until_server_responds(self, expected_type):
current_handler = self.current_handler
def continue_while_no_response(any_activity):
return (not current_handler.response_ready)
self.poll_connections_until_stopped([self.current_connection], continue_while_no_response, timeout=self.poll_timeout)
if not self.current_handler.response_ready:
raise InvalidAdminClientState('Admin client timed out after %f second(s)' % self.poll_timeout)
cmd_type, cmd_resp = self.current_handler.pop_response()
if cmd_type != expected_type:
raise InvalidAdminClientState('Received an unexpected response... got command %r, expecting command %r' % (cmd_type, expected_type))
return cmd_resp
|