Home | History | Annotate | Download | only in servers
      1 # Copyright (C) 2011 Google Inc. All rights reserved.
      2 #
      3 # Redistribution and use in source and binary forms, with or without
      4 # modification, are permitted provided that the following conditions are
      5 # met:
      6 #
      7 #     * Redistributions of source code must retain the above copyright
      8 # notice, this list of conditions and the following disclaimer.
      9 #     * Redistributions in binary form must reproduce the above
     10 # copyright notice, this list of conditions and the following disclaimer
     11 # in the documentation and/or other materials provided with the
     12 # distribution.
     13 #     * Neither the name of Google Inc. nor the names of its
     14 # contributors may be used to endorse or promote products derived from
     15 # this software without specific prior written permission.
     16 #
     17 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     18 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     19 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     20 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     21 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     22 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     23 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     24 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     25 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     26 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     27 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     28 
     29 """A class to help start/stop the PyWebSocket server used by layout tests."""
     30 
     31 import logging
     32 import os
     33 import sys
     34 import time
     35 
     36 from webkitpy.layout_tests.servers import http_server
     37 from webkitpy.layout_tests.servers import http_server_base
     38 
     39 _log = logging.getLogger(__name__)
     40 
     41 
     42 _WS_LOG_PREFIX = 'pywebsocket.ws.log-'
     43 _WSS_LOG_PREFIX = 'pywebsocket.wss.log-'
     44 
     45 
     46 _DEFAULT_WS_PORT = 8880
     47 _DEFAULT_WSS_PORT = 9323
     48 
     49 
     50 class PyWebSocket(http_server.Lighttpd):
     51     def __init__(self, port_obj, output_dir, port=_DEFAULT_WS_PORT,
     52                  root=None, use_tls=False,
     53                  private_key=None, certificate=None, ca_certificate=None,
     54                  pidfile=None):
     55         """Args:
     56           output_dir: the absolute path to the layout test result directory
     57         """
     58         http_server.Lighttpd.__init__(self, port_obj, output_dir,
     59                                       port=_DEFAULT_WS_PORT,
     60                                       root=root)
     61         self._output_dir = output_dir
     62         self._pid_file = pidfile
     63         self._process = None
     64 
     65         self._port = port
     66         self._root = root
     67         self._use_tls = use_tls
     68 
     69         self._name = 'pywebsocket'
     70         if self._use_tls:
     71             self._name = 'pywebsocket_secure'
     72 
     73         if private_key:
     74             self._private_key = private_key
     75         else:
     76             self._private_key = self._pem_file
     77         if certificate:
     78             self._certificate = certificate
     79         else:
     80             self._certificate = self._pem_file
     81         self._ca_certificate = ca_certificate
     82         if self._port:
     83             self._port = int(self._port)
     84         self._wsin = None
     85         self._wsout = None
     86         self._mappings = [{'port': self._port}]
     87 
     88         if not self._pid_file:
     89             self._pid_file = self._filesystem.join(self._runtime_path, '%s.pid' % self._name)
     90 
     91         # Webkit tests
     92         # FIXME: This is the wrong way to detect if we're in Chrome vs. WebKit!
     93         # The port objects are supposed to abstract this.
     94         if self._root:
     95             self._layout_tests = self._filesystem.abspath(self._root)
     96             self._web_socket_tests = self._filesystem.abspath(self._filesystem.join(self._root, 'http', 'tests', 'websocket'))
     97         else:
     98             try:
     99                 self._layout_tests = self._port_obj.layout_tests_dir()
    100                 self._web_socket_tests = self._filesystem.join(self._layout_tests, 'http', 'tests', 'websocket')
    101             except:
    102                 self._web_socket_tests = None
    103 
    104         if self._use_tls:
    105             self._log_prefix = _WSS_LOG_PREFIX
    106         else:
    107             self._log_prefix = _WS_LOG_PREFIX
    108 
    109     def _prepare_config(self):
    110         time_str = time.strftime('%d%b%Y-%H%M%S')
    111         log_file_name = self._log_prefix + time_str
    112         # FIXME: Doesn't Executive have a devnull, so that we don't have to use os.devnull directly?
    113         self._wsin = open(os.devnull, 'r')
    114 
    115         error_log = self._filesystem.join(self._output_dir, log_file_name + "-err.txt")
    116         output_log = self._filesystem.join(self._output_dir, log_file_name + "-out.txt")
    117         self._wsout = self._filesystem.open_text_file_for_writing(output_log)
    118 
    119         from webkitpy.thirdparty import mod_pywebsocket
    120         python_interp = sys.executable
    121         # FIXME: Use self._filesystem.path_to_module(self.__module__) instead of __file__
    122         # I think this is trying to get the chrome directory?  Doesn't the port object know that?
    123         pywebsocket_base = self._filesystem.join(self._filesystem.dirname(self._filesystem.dirname(self._filesystem.dirname(self._filesystem.abspath(__file__)))), 'thirdparty')
    124         pywebsocket_script = self._filesystem.join(pywebsocket_base, 'mod_pywebsocket', 'standalone.py')
    125         start_cmd = [
    126             python_interp, '-u', pywebsocket_script,
    127             '--server-host', 'localhost',
    128             '--port', str(self._port),
    129             '--document-root', self._web_socket_tests,
    130             '--scan-dir', self._web_socket_tests,
    131             '--cgi-paths', '/',
    132             '--log-file', error_log,
    133         ]
    134 
    135         handler_map_file = self._filesystem.join(self._web_socket_tests, 'handler_map.txt')
    136         if self._filesystem.exists(handler_map_file):
    137             _log.debug('Using handler_map_file: %s' % handler_map_file)
    138             start_cmd.append('--websock-handlers-map-file')
    139             start_cmd.append(handler_map_file)
    140         else:
    141             _log.warning('No handler_map_file found')
    142 
    143         if self._use_tls:
    144             start_cmd.extend(['-t', '-k', self._private_key,
    145                               '-c', self._certificate])
    146             if self._ca_certificate:
    147                 start_cmd.append('--ca-certificate')
    148                 start_cmd.append(self._ca_certificate)
    149 
    150         self._start_cmd = start_cmd
    151         server_name = self._filesystem.basename(pywebsocket_script)
    152         self._env = self._port_obj.setup_environ_for_server(server_name)
    153         self._env['PYTHONPATH'] = (pywebsocket_base + os.path.pathsep + self._env.get('PYTHONPATH', ''))
    154 
    155     def _remove_stale_logs(self):
    156         try:
    157             self._remove_log_files(self._output_dir, self._log_prefix)
    158         except OSError, e:
    159             _log.warning('Failed to remove stale %s log files: %s' % (self._name, str(e)))
    160 
    161     def _spawn_process(self):
    162         _log.debug('Starting %s server, cmd="%s"' % (self._name, self._start_cmd))
    163         self._process = self._executive.popen(self._start_cmd, env=self._env, shell=False, stdin=self._wsin, stdout=self._wsout, stderr=self._executive.STDOUT)
    164         self._filesystem.write_text_file(self._pid_file, str(self._process.pid))
    165         return self._process.pid
    166 
    167     def _stop_running_server(self):
    168         super(PyWebSocket, self)._stop_running_server()
    169 
    170         if self._wsin:
    171             self._wsin.close()
    172             self._wsin = None
    173         if self._wsout:
    174             self._wsout.close()
    175             self._wsout = None
    176