📝 add documentation to refactored functions

Author: ediskandarov-cur

mangum/adapter.py

@@ -94,7 +94,6 @@ def __call__(self, event: dict, context: "LambdaContext") -> dict:
             scope = self.event_to_asgi_scope(event)
             scope["aws.event"] = event
             scope["aws.context"] = context
-
             http_cycle = HTTPCycle(scope, text_mime_types=self.text_mime_types)
 
             initial_body = self.event_to_request_body(event)
@@ -103,6 +102,7 @@ def __call__(self, event: dict, context: "LambdaContext") -> dict:
         return response
 
     def event_to_request_body(self, event: dict) -> bytes:
+        """Extracts request body from a Lambda event."""
         is_binary = event.get("isBase64Encoded", False)
         initial_body = event.get("body") or b""
         if is_binary:
@@ -113,6 +113,15 @@ def event_to_request_body(self, event: dict) -> bytes:
         return initial_body
 
     def event_to_asgi_scope(self, event: dict) -> Scope:
+        """Creates a scope object according to ASGI specification from a Lambda Event.
+
+        https://asgi.readthedocs.io/en/latest/specs/www.html#http-connection-scope
+
+        Event comes from various sources: AWS ALB, AWS API Gateway of different
+        versions and configurations(multivalue header, etc).
+        Thus some heuristics is applied to guess event type.
+
+        """
         request_context = event["requestContext"]
 
         if event.get("multiValueHeaders"):