136 lines
4.3 KiB
Python
136 lines
4.3 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
proxy.py
|
|
~~~~~~~~
|
|
⚡⚡⚡ Fast, Lightweight, Pluggable, TLS interception capable proxy server focused on
|
|
Network monitoring, controls & Application development, testing, debugging.
|
|
|
|
:copyright: (c) 2013-present by Abhinav Singh and contributors.
|
|
:license: BSD, see LICENSE for more details.
|
|
|
|
.. spelling::
|
|
|
|
devtools
|
|
"""
|
|
import json
|
|
import logging
|
|
from typing import Any, Dict, List, Tuple
|
|
|
|
from ..parser import HttpParser
|
|
from ..server import HttpWebServerBasePlugin, httpProtocolTypes
|
|
from ..websocket import WebsocketFrame, websocketOpcodes
|
|
from .transformer import CoreEventsToDevtoolsProtocol
|
|
from ...core.event import EventSubscriber
|
|
from ...common.flag import flags
|
|
from ...common.utils import text_, bytes_
|
|
from ...common.constants import (
|
|
DEFAULT_ENABLE_DEVTOOLS, DEFAULT_DEVTOOLS_DOC_URL,
|
|
DEFAULT_DEVTOOLS_WS_PATH,
|
|
)
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
flags.add_argument(
|
|
'--enable-devtools',
|
|
action='store_true',
|
|
default=DEFAULT_ENABLE_DEVTOOLS,
|
|
help='Default: False. Enables integration with Chrome Devtool Frontend. Also see --devtools-ws-path.',
|
|
)
|
|
|
|
flags.add_argument(
|
|
'--devtools-ws-path',
|
|
type=str,
|
|
default=DEFAULT_DEVTOOLS_WS_PATH,
|
|
help='Default: /devtools. Only applicable '
|
|
'if --enable-devtools is used.',
|
|
)
|
|
|
|
|
|
class DevtoolsProtocolPlugin(HttpWebServerBasePlugin):
|
|
"""Speaks DevTools protocol with client over websocket.
|
|
|
|
- It responds to DevTools client request methods and also
|
|
relay proxy.py core events to the client.
|
|
- Core events are transformed into DevTools protocol format before
|
|
dispatching to client.
|
|
- Core events unrelated to DevTools protocol are dropped.
|
|
"""
|
|
|
|
def __init__(self, *args: Any, **kwargs: Any) -> None:
|
|
super().__init__(*args, **kwargs)
|
|
self.subscriber = EventSubscriber(
|
|
self.event_queue,
|
|
callback=lambda event: CoreEventsToDevtoolsProtocol.transformer(
|
|
self.client, event,
|
|
),
|
|
)
|
|
|
|
def routes(self) -> List[Tuple[int, str]]:
|
|
return [
|
|
(httpProtocolTypes.WEBSOCKET, text_(self.flags.devtools_ws_path)),
|
|
]
|
|
|
|
def handle_request(self, request: HttpParser) -> None:
|
|
raise NotImplementedError('This should have never been called')
|
|
|
|
def on_websocket_open(self) -> None:
|
|
self.subscriber.setup()
|
|
|
|
def on_websocket_message(self, frame: WebsocketFrame) -> None:
|
|
try:
|
|
assert frame.data
|
|
message = json.loads(frame.data)
|
|
except UnicodeDecodeError:
|
|
logger.error(frame.data)
|
|
logger.info(frame.opcode)
|
|
return
|
|
self.handle_devtools_message(message)
|
|
|
|
def on_client_connection_close(self) -> None:
|
|
self.subscriber.shutdown()
|
|
|
|
def handle_devtools_message(self, message: Dict[str, Any]) -> None:
|
|
frame = WebsocketFrame()
|
|
frame.fin = True
|
|
frame.opcode = websocketOpcodes.TEXT_FRAME
|
|
# logger.info(message)
|
|
method = message['method']
|
|
if method in (
|
|
'Page.canScreencast',
|
|
'Network.canEmulateNetworkConditions',
|
|
'Emulation.canEmulate',
|
|
):
|
|
data: Dict[str, Any] = {
|
|
'result': False,
|
|
}
|
|
elif method == 'Page.getResourceTree':
|
|
data = {
|
|
'result': {
|
|
'frameTree': {
|
|
'frame': {
|
|
'id': 1,
|
|
'url': DEFAULT_DEVTOOLS_DOC_URL,
|
|
'mimeType': 'other',
|
|
},
|
|
'childFrames': [],
|
|
'resources': [],
|
|
},
|
|
},
|
|
}
|
|
elif method == 'Network.getResponseBody':
|
|
connection_id = message['params']['requestId']
|
|
data = {
|
|
'result': {
|
|
'body': text_(CoreEventsToDevtoolsProtocol.RESPONSES[connection_id]),
|
|
'base64Encoded': False,
|
|
},
|
|
}
|
|
else:
|
|
logging.warning('Unhandled devtools method %s', method)
|
|
data = {}
|
|
data['id'] = message['id']
|
|
frame.data = bytes_(json.dumps(data))
|
|
self.client.queue(memoryview(frame.build()))
|