How blanketsucks/async-web-framework works
Subway is an asynchronous Python web framework. Its principal workflow accepts an HTTP connection, constructs a request, resolves a route and runs the application callback, then converts and sends a response. The README documents request/response middleware and a distinct WebSocket callback path. The graph also preserves framework extensions, static files, sessions, models, and client-side HTTP support. Some subsystem links rely on the README or SOURCE INDEX references; unsampled code does not establish further runtime call order.
Main entry points: app.py Application · request.py Request Parsing · workers.py Connection Worker · response.py Response Types
Components 24
Request Runtime
- Async Server
subway/server/__init__.py - Connection Worker
subway/workers.py - Application
subway/app.py - Route Matching
subway/router.py - Routes and Middleware
subway/objects.py
HTTP Primitives
- Request Parsing
subway/request.py - Response Types
subway/response.py - HTTP Status Responses
subway/responses.py - Async Streams
subway/streams.py - HTTP Protocol Types
subway/http/abc.py - Headers and Cookies
subway/headers.py - Cookie Handling
subway/cookies.py - File Responses
subway/files.py - URL Handling
subway/url.py
Framework Features
- WebSocket Frames
subway/websockets/enums.py - Views and Resources
subway/views.py - Data Models
subway/models/fields.py - Server Sessions
subway/sessions.py - Static Files
subway/extensions/staticfiles.py
Extensions and Clients
- SQLAlchemy Results
subway/extensions/sqlalchemy/results.py - SQLAlchemy Schemas
subway/extensions/sqlalchemy/schemas.py - HTTP Client Sessions
subway/http/sessions.py - HTTP Transport
subway/http/abc.py
Other components
- HTTP Client
Connections 23
- HTTP Client → Async Server: sends request
- Async Server → Connection Worker: serves connections
subway/workers.py - Connection Worker → Request Parsing: constructs request
subway/workers.py - Connection Worker → Application: dispatches request
subway/workers.py - Application → Route Matching: resolves route
subway/app.py - Route Matching → Routes and Middleware: returns route
subway/router.py - Application → Request Parsing: runs callback
subway/app.py - Application → Response Types: converts result
subway/app.py - Application → HTTP Status Responses: handles HTTP errors
subway/app.py - Request Parsing → Async Streams: reads body
subway/request.py - Request Parsing → URL Handling: parses URL
subway/request.py - Request Parsing → Headers and Cookies: uses headers
subway/request.py - Request Parsing → Cookie Handling: reads cookies
subway/request.py - Response Types → File Responses: serves files
subway/response.py - Response Types → Cookie Handling: sets cookies
subway/response.py - Connection Worker → WebSocket Frames: handles WebSocket
- Application → Views and Resources: registers views
subway/app.py - Application → Server Sessions: supports sessions
subway/sessions.py - Application → Static Files: configures static files
subway/extensions/staticfiles.py - SQLAlchemy Results → SQLAlchemy Schemas: uses schemas
subway/extensions/sqlalchemy/types.py - HTTP Client Sessions → HTTP Transport: creates transport
subway/http/sessions.py - HTTP Transport → Async Streams: uses streams
subway/http/abc.py - Data Models → SQLAlchemy Results: integrates models