2015-02-26 18:17:40 +00:00
|
|
|
"""
|
2020-06-22 23:53:39 +00:00
|
|
|
Modify a streamed response.
|
|
|
|
|
|
|
|
Generally speaking, we recommend *not* to stream messages you need to modify.
|
|
|
|
Modifying streamed responses is tricky and brittle:
|
2015-02-27 14:24:27 +00:00
|
|
|
- If the transfer encoding isn't chunked, you cannot simply change the content length.
|
2018-02-25 02:45:11 +00:00
|
|
|
- If you want to replace all occurrences of "foobar", make sure to catch the cases
|
2015-02-27 14:24:27 +00:00
|
|
|
where one chunk ends with [...]foo" and the next starts with "bar[...].
|
2015-02-26 18:17:40 +00:00
|
|
|
"""
|
2021-07-29 12:56:06 +00:00
|
|
|
from typing import Iterable, Union
|
2015-02-26 18:17:40 +00:00
|
|
|
|
2015-02-27 14:24:27 +00:00
|
|
|
|
2021-07-29 12:56:06 +00:00
|
|
|
def modify(data: bytes) -> Union[bytes, Iterable[bytes]]:
|
2015-02-26 17:44:47 +00:00
|
|
|
"""
|
2021-07-29 12:56:06 +00:00
|
|
|
This function will be called for each chunk of request/response body data that arrives at the proxy,
|
|
|
|
and once at the end of the message with an empty bytes argument (b"").
|
|
|
|
|
|
|
|
It may either return bytes or an iterable of bytes (which would result in multiple HTTP/2 data frames).
|
2015-02-26 17:44:47 +00:00
|
|
|
"""
|
2021-07-29 12:56:06 +00:00
|
|
|
return data.replace(b"foo", b"bar")
|
2015-02-27 14:24:27 +00:00
|
|
|
|
2015-02-26 17:44:47 +00:00
|
|
|
|
2016-07-08 01:37:33 +00:00
|
|
|
def responseheaders(flow):
|
2015-05-30 00:03:28 +00:00
|
|
|
flow.response.stream = modify
|