Add part 1 of tutorial.

Author: fabioz

part1/__debug_output__.txt

@@ -0,0 +1,70 @@
+Debug output gotten from starting the debugger and then stopping it:
+
+Starting. Args: X:/vscode-pydev/vscode-pydev/debugger/debug_adapter_main.py
+read line: >>Content-Length: 312\r\n<<
+read line: >>\r\n<<
+Process json: {
+    "arguments": {
+        "adapterID": "PyDev", 
+        "clientID": "vscode", 
+        "clientName": "Visual Studio Code", 
+        "columnsStartAt1": true, 
+        "linesStartAt1": true, 
+        "locale": "en-us", 
+        "pathFormat": "path", 
+        "supportsRunInTerminalRequest": true, 
+        "supportsVariablePaging": true, 
+        "supportsVariableType": true
+    }, 
+    "command": "initialize", 
+    "seq": 1, 
+    "type": "request"
+}
+Writing: {"request_seq": 1, "body": {"supportsConfigurationDoneRequest": true, "supportsConditionalBreakpoints": true}, "success": true, "seq": 0, "command": "initialize", "type": "response"}
+Writing: {"type": "event", "event": "initialized", "seq": 1}
+read line: >>Content-Length: 284\r\n<<
+read line: >>\r\n<<
+Process json: {
+    "arguments": {
+        "__sessionId": "a5a37776-8a8f-48e6-b50f-c5ad276d0586", 
+        "args": "", 
+        "console": "integratedTerminal", 
+        "cwd": "X:\\vscode_example", 
+        "name": "PyDev Debug (Launch)", 
+        "program": "X:/vscode_example/robots.py", 
+        "request": "launch", 
+        "type": "PyDev"
+    }, 
+    "command": "launch", 
+    "seq": 2, 
+    "type": "request"
+}
+read line: >>Content-Length: 56\r\n<<
+Writing: {"request_seq": 2, "command": "launch", "type": "response", "seq": 2, "success": true}
+read line: >>\r\n<<
+Process json: {
+    "arguments": {}, 
+    "command": "configurationDone", 
+    "seq": 3, 
+    "type": "request"
+}
+read line: >>Content-Length: 46\r\n<<
+Writing: {"request_seq": 3, "command": "configurationDone", "type": "response", "seq": 3, "success": true}
+read line: >>\r\n<<
+Process json: {
+    "command": "threads", 
+    "seq": 4, 
+    "type": "request"
+}
+Writing: {"request_seq": 4, "body": {"threads": [{"id": 0, "name": "Main Thread"}, {"id": 1, "name": "Thread 1"}]}, "success": true, "seq": 4, "command": "threads", "type": "response"}
+read line: >>Content-Length: 79\r\n<<
+read line: >>\r\n<<
+Process json: {
+    "arguments": {
+        "restart": false
+    }, 
+    "command": "disconnect", 
+    "seq": 5, 
+    "type": "request"
+}
+Writing: {"request_seq": 5, "command": "disconnect", "type": "response", "seq": 5, "success": true}

part1/debugger/debug_adapter/__init__.py

@@ -0,0 +1,49 @@
+class BaseSchema(object):
+    
+    def to_json(self):
+        import json
+        return json.dumps(self.to_dict())
+
+
+requests_to_types = {}
+all_messages = {}
+
+
+def register(cls):
+    all_messages[cls.__name__] = cls
+    return cls
+
+    
+def register_request(request_command):
+
+    def do_register(cls):
+        requests_to_types[request_command] = cls
+        return cls
+    
+    return do_register
+    
+
+def from_dict(dct):
+    msg_type = dct.get('type')
+    if msg_type is None:
+        raise ValueError('Unable to make sense of message: %s' % (dct,))
+    if msg_type == 'request':
+        cls = requests_to_types[dct['command']] 
+        return cls(**dct)
+
+    
+def from_json(json_msg):
+    import json
+    return from_dict(json.loads(json_msg))
+
+
+def build_response(request, kwargs=None):
+    if kwargs is None:
+        kwargs = {}
+    name = request.__class__.__name__
+    assert name.endswith('Request')
+    name = name[:-7] + 'Response'
+    response_class = all_messages[name]
+    kwargs.setdefault('seq', -1)
+    return response_class(command=request.command, request_seq=request.seq, success=True, **kwargs)
+