[nrf fromtree] Update test_dcl_server.py for Python 3.10+ compatibility (#37549) (#37589)

* fix: Update test_dcl_server.py for Python 3.x compatibility

Update the DCL server script to support newer Python versions for
TC-CGEN-2.12 manual test case execution. The script provides terms
and conditions functionality required for testing the DCL flow.

Testing:

1. Start the DCL server in terminal 1:

   ```bash
   python3 ./examples/chip-tool/commands/dcl/test_dcl_server.py
   ```

2. Launch terms and conditions app in terminal 2:

   ```bash
   rm /tmp/chip* ; ./out/linux-x64-terms-and-conditions/chip-terms-and-conditions-app \
   --version 0 --custom-flow 2 --capabilities 6 --discriminator 3840 \
   --passcode 20202021 --KVS /tmp/chip_kvs.bin --trace_file /tmp/chip_trace.log \
   --trace_log 1 --trace_decode 1
   ```

3. Execute pairing command in terminal 3:

   ```bash
   yes | ./out/linux-x64-chip-tool/chip-tool pairing code 0x12344321 \
   MT:-24J029Q00KA0648G00 --use-dcl true --dcl-hostname localhost --dcl-port 4443
   ```

* [DCL] Improve HTTPS server implementation and documentation

- Add detailed comments explaining the SSL/TLS setup process
- Use context manager for proper socket cleanup

(cherry picked from commit b5c706d27947e8487ad4a5128d43569262a23c45)
Signed-off-by: Adrian Gielniewski <[email protected]>

Author: swan-amazon

.vscode/launch.json

@@ -4,6 +4,14 @@
     // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
     "version": "0.2.0",
     "configurations": [
+        {
+            "name": "Python Debugger: test_dcl_server",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "/workspace/connectedhomeip/examples/chip-tool/commands/dcl/test_dcl_server.py",
+            "args": [],
+            "console": "integratedTerminal"
+        },
         {
             "name": "Attach to running process",
             "type": "lldb",

examples/chip-tool/commands/dcl/test_dcl_server.py

@@ -211,19 +211,25 @@ def handle_tc_request(self, vendor_id, product_id):
 
 
 def run_https_server(cert_file="cert.pem", key_file="key.pem"):
-    httpd = http.server.HTTPServer(
-        (DEFAULT_HOSTNAME, DEFAULT_PORT), RESTRequestHandler)
-
-    httpd.socket = ssl.wrap_socket(
-        httpd.socket,
-        server_side=True,
-        certfile=cert_file,
-        keyfile=key_file,
-        ssl_version=ssl.PROTOCOL_TLS,
-    )
-
-    print(f"Serving on https://{DEFAULT_HOSTNAME}:{DEFAULT_PORT}")
-    httpd.serve_forever()
+    # Creates a basic HTTP server instance that listens on DEFAULT_HOSTNAME and DEFAULT_PORT
+    # RESTRequestHandler handles incoming HTTP requests
+    httpd = http.server.HTTPServer((DEFAULT_HOSTNAME, DEFAULT_PORT), RESTRequestHandler)
+
+    # Creates an SSL context using TLS protocol for secure communications
+    context = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
+
+    # Loads the SSL certificate and private key for the server
+    # cert_file: contains the server's public certificate
+    # key_file: contains the server's private key
+    context.load_cert_chain(certfile=cert_file, keyfile=key_file)
+
+    # Uses a context manager (with statement) to wrap the HTTP server's socket with SSL
+    # server_side=True indicates this is a server socket
+    # The wrapped socket is automatically closed when exiting the with block
+    with context.wrap_socket(httpd.socket, server_side=True) as httpd.socket:
+        print(f"Serving on https://{DEFAULT_HOSTNAME}:{DEFAULT_PORT}")
+        # Starts the server and runs indefinitely, handling incoming HTTPS requests
+        httpd.serve_forever()
 
 
 # Generate self-signed certificates if needed