Splitting the debugger and console part of the python debugger

Move DebuggerPrompt to jerry_client.py
Implement JerryDebugger functions in the jerry_client_ws.py file
Server response is displayed by jerry_client.py

JerryScript-DCO-1.0-Signed-off-by: Tamas Zakor [email protected]

Author: zombori

jerry-debugger/jerry_client.py

@@ -0,0 +1,327 @@
+#!/usr/bin/env python
+
+# Copyright JS Foundation and other contributors, http://js.foundation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import print_function
+from cmd import Cmd
+from pprint import pprint
+import math
+import socket
+import sys
+import logging
+import time
+import jerry_client_ws
+
+class DebuggerPrompt(Cmd):
+    # pylint: disable=too-many-instance-attributes,too-many-arguments
+    def __init__(self, debugger):
+        Cmd.__init__(self)
+        self.debugger = debugger
+        self.stop = False
+        self.quit = False
+        self.debugger.non_interactive = False
+
+    def precmd(self, line):
+        self.stop = False
+        if self.debugger.non_interactive:
+            print("%s" % line)
+        return line
+
+    def postcmd(self, stop, line):
+        return self.stop
+
+    def do_quit(self, _):
+        """ Exit JerryScript debugger """
+        self.debugger.quit()
+        self.quit = True
+        self.stop = True
+
+    def do_display(self, args):
+        """ Toggle source code display after breakpoints """
+        if args:
+            line_num = src_check_args(args)
+            if line_num >= 0:
+                self.debugger.display = line_num
+        else:
+            print("Non-negative integer number expected, 0 turns off this function")
+
+    def do_break(self, args):
+        """ Insert breakpoints on the given lines or functions """
+        sbreak = ""
+        if args == "":
+            print("Error: Breakpoint index expected")
+        elif ':' in args:
+            try:
+                args_second = int(args.split(':', 1)[1])
+                if args_second < 0:
+                    print("Error: Positive breakpoint index expected")
+                else:
+                    sbreak = self.debugger.set_break(args)
+            except ValueError as val_errno:
+                print("Error: Positive breakpoint index expected: %s" % val_errno)
+        else:
+            sbreak = self.debugger.set_break(args)
+        if sbreak is not None:
+            print(sbreak)
+    do_b = do_break
+
+    def do_list(self, _):
+        """ Lists the available breakpoints """
+        if self.debugger.active_breakpoint_list:
+            print("=== %sActive breakpoints %s ===" % (self.debugger.green_bg, self.debugger.nocolor))
+            for breakpoint in self.debugger.active_breakpoint_list.values():
+                print(" %d: %s" % (breakpoint.active_index, breakpoint))
+
+        if self.debugger.pending_breakpoint_list:
+            print("=== %sPending breakpoints%s ===" % (self.debugger.yellow_bg, self.debugger.nocolor))
+            for breakpoint in self.debugger.pending_breakpoint_list.values():
+                print(" %d: %s (pending)" % (breakpoint.index, breakpoint))
+
+        if not self.debugger.active_breakpoint_list and not self.debugger.pending_breakpoint_list:
+            print("No breakpoints")
+
+    def do_delete(self, args):
+        """ Delete the given breakpoint, use 'delete all|active|pending' to clear all the given breakpoints """
+        result = ''
+        if not args:
+            print("Error: Breakpoint index expected")
+            print("Delete the given breakpoint, use 'delete all|active|pending' to clear all the given breakpoints ")
+        elif args in ['all', 'pending', 'active']:
+            result = self.debugger.delete(args)
+        else:
+            try:
+                result = self.debugger.delete(args)
+            except ValueError as val_errno:
+                result = "Error: Integer number expected, %s" % (val_errno)
+        if result != '':
+            print(result)
+
+    def do_next(self, args):
+        """ Next breakpoint in the same context """
+        self.stop = True
+        if not args:
+            args = 0
+            self.debugger.next()
+        else:
+            try:
+                args = int(args)
+                if args <= 0:
+                    raise ValueError(args)
+                else:
+                    while int(args) != 0:
+                        self.debugger.next()
+                        time.sleep(0.25)
+                        result = self.debugger.mainloop()
+                        if result[-1:] == '\n':
+                            result = result[:-1]
+                        if result != '':
+                            print(result)
+                            self.debugger.smessage = ''
+                        if self.debugger.display > 0:
+                            print(self.debugger.print_source(self.debugger.display,
+                                                             self.debugger.src_offset))
+                        args = int(args) - 1
+                    self.cmdloop()
+            except ValueError as val_errno:
+                print("Error: expected a positive integer: %s" % val_errno)
+                self.cmdloop()
+    do_n = do_next
+
+    def do_step(self, _):
+        """ Next breakpoint, step into functions """
+        self.debugger.step()
+        self.stop = True
+    do_s = do_step
+
+    def do_backtrace(self, args):
+        """ Get backtrace data from debugger """
+        self.debugger.backtrace(args)
+        self.stop = True
+    do_bt = do_backtrace
+
+    def do_src(self, args):
+        """ Get current source code """
+        if args:
+            line_num = src_check_args(args)
+            if line_num >= 0:
+                print(self.debugger.print_source(line_num, 0))
+    do_source = do_src
+
+    def do_scroll(self, _):
+        """ Scroll the source up or down """
+        while True:
+            key = sys.stdin.readline()
+            if key == 'w\n':
+                _scroll_direction(self.debugger, "up")
+            elif key == 's\n':
+                _scroll_direction(self.debugger, "down")
+            elif key == 'q\n':
+                break
+            else:
+                print("Invalid key")
+
+    def do_continue(self, _):
+        """ Continue execution """
+        self.debugger.get_continue()
+        self.stop = True
+        if not self.debugger.non_interactive:
+            print("Press enter to stop JavaScript execution.")
+    do_c = do_continue
+
+    def do_finish(self, _):
+        """ Continue running until the current function returns """
+        self.debugger.finish()
+        self.stop = True
+    do_f = do_finish
+
+    def do_dump(self, args):
+        """ Dump all of the debugger data """
+        if args:
+            print("Error: No argument expected")
+        else:
+            pprint(self.debugger.function_list)
+
+    def do_eval(self, args):
+        """ Evaluate JavaScript source code """
+        self.debugger.eval(args)
+        self.stop = True
+    do_e = do_eval
+
+    def do_memstats(self, _):
+        """ Memory statistics """
+        self.debugger.memstats()
+        self.stop = True
+    do_ms = do_memstats
+
+    def do_abort(self, args):
+        """ Throw an exception """
+        self.debugger.abort(args)
+        self.stop = True
+
+    def do_restart(self, _):
+        """ Restart the engine's debug session """
+        self.debugger.restart()
+        self.stop = True
+    do_res = do_restart
+
+    def do_throw(self, args):
+        """ Throw an exception """
+        self.debugger.throw(args)
+        self.stop = True
+
+    def do_exception(self, args):
+        """ Config the exception handler module """
+        print(self.debugger.exception(args))
+
+def _scroll_direction(debugger, direction):
+    """ Helper function for do_scroll """
+    debugger.src_offset_diff = int(max(math.floor(debugger.display / 3), 1))
+    if direction == "up":
+        debugger.src_offset -= debugger.src_offset_diff
+    else:
+        debugger.src_offset += debugger.src_offset_diff
+    print(debugger.print_source(debugger.display, debugger.src_offset))
+
+def src_check_args(args):
+    try:
+        line_num = int(args)
+        if line_num < 0:
+            print("Error: Non-negative integer number expected")
+            return -1
+
+        return line_num
+    except ValueError as val_errno:
+        print("Error: Non-negative integer number expected: %s" % (val_errno))
+        return -1
+
+# pylint: disable=too-many-branches,too-many-locals,too-many-statements
+def main():
+    args = jerry_client_ws.arguments_parse()
+
+    debugger = jerry_client_ws.JerryDebugger(args.address)
+
+    non_interactive = args.non_interactive
+
+    logging.debug("Connected to JerryScript on %d port", debugger.port)
+
+    prompt = DebuggerPrompt(debugger)
+    prompt.prompt = "(jerry-debugger) "
+    prompt.debugger.non_interactive = non_interactive
+
+    if args.color:
+        debugger.set_colors()
+
+    if args.display:
+        prompt.debugger.display = args.display
+        prompt.do_display(args.display)
+    else:
+        prompt.stop = False
+        if not args.client_source:
+            prompt.debugger.mainloop()
+            result = prompt.debugger.smessage
+            print(result)
+            prompt.debugger.smessage = ''
+            prompt.cmdloop()
+
+    if args.exception is not None:
+        prompt.do_exception(str(args.exception))
+
+    if args.client_source:
+        prompt.debugger.store_client_sources(args.client_source)
+
+    while True:
+        if prompt.quit:
+            break
+
+        result = prompt.debugger.mainloop()
+
+        if result == '':
+            break
+        if result is None:
+            continue
+        elif jerry_client_ws.JERRY_DEBUGGER_DATA_END in result:
+            result = result.replace(jerry_client_ws.JERRY_DEBUGGER_DATA_END, '')
+            if result.endswith('\n'):
+                result = result.rstrip()
+            if result:
+                print(result)
+                prompt.debugger.smessage = ''
+            if prompt.debugger.display > 0:
+                print(prompt.debugger.print_source(prompt.debugger.display, prompt.debugger.src_offset))
+            break
+        else:
+            if result.endswith('\n'):
+                result = result.rstrip()
+            if result:
+                print(result)
+                prompt.debugger.smessage = ''
+            if prompt.debugger.display > 0:
+                print(prompt.debugger.print_source(prompt.debugger.display, prompt.debugger.src_offset))
+        prompt.cmdloop()
+        continue
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except socket.error as error_msg:
+        ERRNO = error_msg.errno
+        MSG = str(error_msg)
+        if ERRNO == 111:
+            sys.exit("Failed to connect to the JerryScript debugger.")
+        elif ERRNO == 32 or ERRNO == 104:
+            sys.exit("Connection closed.")
+        else:
+            sys.exit("Failed to connect to the JerryScript debugger.\nError: %s" % (MSG))