Skip to content

Commit c1b15cb

Browse files
committed
Update Asgi message docs
1 parent cd0c8a6 commit c1b15cb

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

modal_proto/api.proto

+11-3
Original file line numberDiff line numberDiff line change
@@ -90,9 +90,17 @@ enum WebhookAsyncMode {
9090
WEBHOOK_ASYNC_MODE_AUTO = 4; // redirect to polling endpoint if execution time nears the http timeout
9191
}
9292

93-
// An opinionated interpretation of a message in the ASGI HTTP specification.
94-
// Spec: https://asgi.readthedocs.io/en/latest/specs/www.html
95-
message AsgiProtocol {
93+
// A web endpoint connection-related message.
94+
//
95+
// Modal's internal web endpoint runtime effectively acts as a global web server
96+
// that schedules requests to tasks that are spawned on-demand, so we need an
97+
// internal protocol to model HTTP requests. This is that protocol.
98+
//
99+
// We base this protocol on Python's ASGI specification, which is a popular
100+
// interface between applications and web servers.
101+
//
102+
// ASGI Spec: https://asgi.readthedocs.io/en/latest/specs/www.html
103+
message Asgi {
96104
// Single-request connection scope
97105
message Scope {
98106
string http_version = 1;

0 commit comments

Comments
 (0)