Merge branch 'Add_Chunk_Responses' into my-main

# Conflicts:
#	adafruit_httpserver.py

Author: paul-1

adafruit_httpserver.py

@@ -194,6 +194,14 @@ class HTTPResponse:
         "\r\n"
     )
 
+    _CHUNK_HEADERS_FORMAT = (
+        "HTTP/1.1 {}\r\n"
+        "Content-Type: {}\r\n"
+        "Transfer-Encoding: chunked\r\n"
+        "Connection: close\r\n"
+        "\r\n"
+    )
+
     def __init__(
         self,
         *,
@@ -244,6 +252,22 @@ def send(self, conn: Any) -> None:
         else:
             self._send_response(conn, self.status, self.content_type, self.body, self.cache)
 
+    def send_chunk_headers(self, conn: Any):
+        """Send Headers for a chunked response over the given socket."""
+        self._send_bytes(
+            conn, self._CHUNK_HEADERS_FORMAT.format(self.status, self.content_type)
+        )
+
+    def send_body_chunk(self, conn: Any, chunk: str):
+        """Send chunk of data to the given socket.  Send an empty("") chunk to finish the session.
+
+        :param Any conn: Current connection.
+        :param str chunk: String data to be sent.
+        """
+        size="%X\r\n".encode() % len(chunk)
+        self._send_bytes(conn, size)
+        self._send_bytes(conn, chunk.encode() + b'\r\n')
+
     def _send_response(self, conn, status, content_type, body, cache):
         self._send_bytes(
             conn, self._HEADERS_FORMAT.format(status, content_type, len(body), cache)
@@ -305,7 +329,17 @@ def route_func(request):
                 raw_text = request.raw_request.decode("utf8")
                 print("Received a request of length", len(raw_text), "bytes")
                 return HTTPResponse(body="hello world")
-
+                
+            @server.route(path, method)
+            def route_func(request, conn):
+                raw_text = request.raw_request.decode("utf8")
+                print("Received a request of length", len(raw_text), "bytes")
+                res = HTTPResponse(content_type="text/html")
+                res.send_chunk_headers(conn)
+                res.send_body_chunk(conn, "Some content")
+                res.send_body_chunk(conn, "Some more content")
+                res.send_body_chunk(conn, "")  # Send empty packet to finish chunked stream
+                return None  # Return None, so server knows that nothing else needs to be sent.
         """
 
         def route_decorator(func: Callable) -> Callable:
@@ -364,7 +398,13 @@ def poll(self):
                 # If a route exists for this request, call it. Otherwise try to serve a file.
                 route = self.routes.get(request, None)
                 if route:
-                    response = route(request)
+                    # Use try, so we don't break old api of this lib.
+                    try:
+                        response = route(request, conn)
+                    except TypeError:
+                        response = route(request)
+                    if response is None:
+                        return
                 elif request.method == "GET":
                     response = HTTPResponse(filename=request.path, cache=604800, root=self.root_path)
                 else: