web_server_file_response.py 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. """Range responses over a descriptor opened under the file ticket's profile lease."""
  2. from __future__ import annotations
  3. import os
  4. from secrets import token_hex
  5. import anyio
  6. from anyio.to_thread import run_sync
  7. from starlette.datastructures import MutableHeaders
  8. from starlette.responses import FileResponse
  9. class OpenedFileResponse(FileResponse):
  10. """Keep Starlette's Range parsing/headers, but never reopen a reusable path.
  11. The opener runs immediately before response dispatch and returns a checked
  12. file object. Its lifecycle lease ends before any network await. Every exit,
  13. including HEAD, invalid Range and disconnect, closes the pinned descriptor.
  14. """
  15. def __init__(self, *args, opener, **kwargs):
  16. super().__init__(*args, **kwargs)
  17. self._opener = opener
  18. async def __call__(self, scope, receive, send):
  19. handle = await run_sync(self._opener)
  20. self._file = anyio.wrap_file(handle)
  21. try:
  22. self.stat_result = os.fstat(handle.fileno())
  23. self._file_size = self.stat_result.st_size
  24. self.set_stat_headers(self.stat_result)
  25. await super().__call__(scope, receive, send)
  26. finally:
  27. with anyio.CancelScope(shield=True):
  28. await self._file.aclose()
  29. async def _send_range(self, send, start, end):
  30. await self._file.seek(start)
  31. while start < end:
  32. chunk = await self._file.read(min(self.chunk_size, end - start))
  33. if not chunk:
  34. break
  35. start += len(chunk)
  36. await send({"type": "http.response.body", "body": chunk, "more_body": True})
  37. async def _handle_simple(self, send, send_header_only, send_pathsend):
  38. # ASGI pathsend would reopen the pathname and lose the pinned identity.
  39. await send({"type": "http.response.start", "status": self.status_code, "headers": self.raw_headers})
  40. if not send_header_only:
  41. await self._send_range(send, 0, self._file_size)
  42. await send({"type": "http.response.body", "body": b"", "more_body": False})
  43. async def _handle_single_range(self, send, start, end, file_size, send_header_only):
  44. headers = MutableHeaders(raw=list(self.raw_headers))
  45. headers["content-range"] = f"bytes {start}-{end - 1}/{file_size}"
  46. headers["content-length"] = str(end - start)
  47. await send({"type": "http.response.start", "status": 206, "headers": headers.raw})
  48. if not send_header_only:
  49. await self._send_range(send, start, end)
  50. await send({"type": "http.response.body", "body": b"", "more_body": False})
  51. async def _handle_multiple_ranges(self, send, ranges, file_size, send_header_only):
  52. boundary = token_hex(13)
  53. length, header = self.generate_multipart(ranges, boundary, file_size, self.headers["content-type"])
  54. headers = MutableHeaders(raw=list(self.raw_headers))
  55. headers["content-type"] = f"multipart/byteranges; boundary={boundary}"
  56. headers["content-length"] = str(length)
  57. await send({"type": "http.response.start", "status": 206, "headers": headers.raw})
  58. if not send_header_only:
  59. for start, end in ranges:
  60. await send({"type": "http.response.body", "body": header(start, end), "more_body": True})
  61. await self._send_range(send, start, end)
  62. await send({"type": "http.response.body", "body": b"\r\n", "more_body": True})
  63. await send({"type": "http.response.body", "body": f"--{boundary}--".encode("ascii"), "more_body": True})
  64. await send({"type": "http.response.body", "body": b"", "more_body": False})