Karim shoair
264ae02aa7
- `Adaptor` became `Selector` - `Adaptors` became `Selectors` - `auto_match` argument/feature became `adaptive` - `adaptor_arguments` argument became `selector_config` - `automatch_domain` argument became `adaptive_domain` - `additional_arguments` argument became `additional_args` - `storage_adaptors` file became just `storage`
260 lines
12 KiB
Python
260 lines
12 KiB
Python
from curl_cffi.requests import Response as CurlResponse
|
|
from playwright.sync_api import Page as SyncPage, Response as SyncResponse
|
|
from playwright.async_api import Page as AsyncPage, Response as AsyncResponse
|
|
|
|
from scrapling.core.utils import log
|
|
from scrapling.core._types import Dict, Optional
|
|
from .custom import Response, StatusText
|
|
|
|
|
|
class ResponseFactory:
|
|
"""
|
|
Factory class for creating `Response` objects from various sources.
|
|
|
|
This class provides multiple static and instance methods for building standardized `Response` objects
|
|
from diverse input sources such as Playwright responses, asynchronous Playwright responses,
|
|
and raw HTTP request responses. It supports handling response histories, constructing the proper
|
|
response objects, and managing encoding, headers, cookies, and other attributes.
|
|
"""
|
|
|
|
@classmethod
|
|
def _process_response_history(
|
|
cls, first_response: SyncResponse, parser_arguments: Dict
|
|
) -> list[Response]:
|
|
"""Process response history to build a list of `Response` objects"""
|
|
history = []
|
|
current_request = first_response.request.redirected_from
|
|
|
|
try:
|
|
while current_request:
|
|
try:
|
|
current_response = current_request.response()
|
|
history.insert(
|
|
0,
|
|
Response(
|
|
url=current_request.url,
|
|
# using current_response.text() will trigger "Error: Response.text: Response body is unavailable for redirect responses"
|
|
text="",
|
|
body=b"",
|
|
status=current_response.status if current_response else 301,
|
|
reason=(
|
|
current_response.status_text
|
|
or StatusText.get(current_response.status)
|
|
)
|
|
if current_response
|
|
else StatusText.get(301),
|
|
encoding=current_response.headers.get("content-type", "")
|
|
or "utf-8",
|
|
cookies=tuple(),
|
|
headers=current_response.all_headers()
|
|
if current_response
|
|
else {},
|
|
request_headers=current_request.all_headers(),
|
|
**parser_arguments,
|
|
),
|
|
)
|
|
except Exception as e:
|
|
log.error(f"Error processing redirect: {e}")
|
|
break
|
|
|
|
current_request = current_request.redirected_from
|
|
except Exception as e:
|
|
log.error(f"Error processing response history: {e}")
|
|
|
|
return history
|
|
|
|
@classmethod
|
|
def from_playwright_response(
|
|
cls,
|
|
page: SyncPage,
|
|
first_response: SyncResponse,
|
|
final_response: Optional[SyncResponse],
|
|
parser_arguments: Dict,
|
|
) -> Response:
|
|
"""
|
|
Transforms a Playwright response into an internal `Response` object, encapsulating
|
|
the page's content, response status, headers, and relevant metadata.
|
|
|
|
The function handles potential issues, such as empty or missing final responses,
|
|
by falling back to the first response if necessary. Encoding and status text
|
|
are also derived from the provided response headers or reasonable defaults.
|
|
Additionally, the page content and cookies are extracted for further use.
|
|
|
|
:param page: A synchronous Playwright `Page` instance that represents the current browser page. Required to retrieve the page's URL, cookies, and content.
|
|
:param final_response: The last response received for the given request from the Playwright instance. Typically used as the main response object to derive status, headers, and other metadata.
|
|
:param first_response: An earlier or initial Playwright `Response` object that may serve as a fallback response in the absence of the final one.
|
|
:param parser_arguments: A dictionary containing additional arguments needed for parsing or further customization of the returned `Response`. These arguments are dynamically unpacked into
|
|
the `Response` object.
|
|
|
|
:return: A fully populated `Response` object containing the page's URL, content, status, headers, cookies, and other derived metadata.
|
|
:rtype: Response
|
|
"""
|
|
# In case we didn't catch a document type somehow
|
|
final_response = final_response if final_response else first_response
|
|
if not final_response:
|
|
raise ValueError("Failed to get a response from the page")
|
|
|
|
# This will be parsed inside `Response`
|
|
encoding = (
|
|
final_response.headers.get("content-type", "") or "utf-8"
|
|
) # default encoding
|
|
# PlayWright API sometimes give empty status text for some reason!
|
|
status_text = final_response.status_text or StatusText.get(
|
|
final_response.status
|
|
)
|
|
|
|
history = cls._process_response_history(first_response, parser_arguments)
|
|
try:
|
|
page_content = page.content()
|
|
except Exception as e:
|
|
log.error(f"Error getting page content: {e}")
|
|
page_content = ""
|
|
|
|
return Response(
|
|
url=page.url,
|
|
text=page_content,
|
|
body=page_content.encode("utf-8"),
|
|
status=final_response.status,
|
|
reason=status_text,
|
|
encoding=encoding,
|
|
cookies=tuple(dict(cookie) for cookie in page.context.cookies()),
|
|
headers=first_response.all_headers(),
|
|
request_headers=first_response.request.all_headers(),
|
|
history=history,
|
|
**parser_arguments,
|
|
)
|
|
|
|
@classmethod
|
|
async def _async_process_response_history(
|
|
cls, first_response: AsyncResponse, parser_arguments: Dict
|
|
) -> list[Response]:
|
|
"""Process response history to build a list of `Response` objects"""
|
|
history = []
|
|
current_request = first_response.request.redirected_from
|
|
|
|
try:
|
|
while current_request:
|
|
try:
|
|
current_response = await current_request.response()
|
|
history.insert(
|
|
0,
|
|
Response(
|
|
url=current_request.url,
|
|
# using current_response.text() will trigger "Error: Response.text: Response body is unavailable for redirect responses"
|
|
text="",
|
|
body=b"",
|
|
status=current_response.status if current_response else 301,
|
|
reason=(
|
|
current_response.status_text
|
|
or StatusText.get(current_response.status)
|
|
)
|
|
if current_response
|
|
else StatusText.get(301),
|
|
encoding=current_response.headers.get("content-type", "")
|
|
or "utf-8",
|
|
cookies=tuple(),
|
|
headers=await current_response.all_headers()
|
|
if current_response
|
|
else {},
|
|
request_headers=await current_request.all_headers(),
|
|
**parser_arguments,
|
|
),
|
|
)
|
|
except Exception as e:
|
|
log.error(f"Error processing redirect: {e}")
|
|
break
|
|
|
|
current_request = current_request.redirected_from
|
|
except Exception as e:
|
|
log.error(f"Error processing response history: {e}")
|
|
|
|
return history
|
|
|
|
@classmethod
|
|
async def from_async_playwright_response(
|
|
cls,
|
|
page: AsyncPage,
|
|
first_response: AsyncResponse,
|
|
final_response: Optional[AsyncResponse],
|
|
parser_arguments: Dict,
|
|
) -> Response:
|
|
"""
|
|
Transforms a Playwright response into an internal `Response` object, encapsulating
|
|
the page's content, response status, headers, and relevant metadata.
|
|
|
|
The function handles potential issues, such as empty or missing final responses,
|
|
by falling back to the first response if necessary. Encoding and status text
|
|
are also derived from the provided response headers or reasonable defaults.
|
|
Additionally, the page content and cookies are extracted for further use.
|
|
|
|
:param page: An asynchronous Playwright `Page` instance that represents the current browser page. Required to retrieve the page's URL, cookies, and content.
|
|
:param final_response: The last response received for the given request from the Playwright instance. Typically used as the main response object to derive status, headers, and other metadata.
|
|
:param first_response: An earlier or initial Playwright `Response` object that may serve as a fallback response in the absence of the final one.
|
|
:param parser_arguments: A dictionary containing additional arguments needed for parsing or further customization of the returned `Response`. These arguments are dynamically unpacked into
|
|
the `Response` object.
|
|
|
|
:return: A fully populated `Response` object containing the page's URL, content, status, headers, cookies, and other derived metadata.
|
|
:rtype: Response
|
|
"""
|
|
# In case we didn't catch a document type somehow
|
|
final_response = final_response if final_response else first_response
|
|
if not final_response:
|
|
raise ValueError("Failed to get a response from the page")
|
|
|
|
# This will be parsed inside `Response`
|
|
encoding = (
|
|
final_response.headers.get("content-type", "") or "utf-8"
|
|
) # default encoding
|
|
# PlayWright API sometimes give empty status text for some reason!
|
|
status_text = final_response.status_text or StatusText.get(
|
|
final_response.status
|
|
)
|
|
|
|
history = await cls._async_process_response_history(
|
|
first_response, parser_arguments
|
|
)
|
|
try:
|
|
page_content = await page.content()
|
|
except Exception as e:
|
|
log.error(f"Error getting page content in async: {e}")
|
|
page_content = ""
|
|
|
|
return Response(
|
|
url=page.url,
|
|
text=page_content,
|
|
body=page_content.encode("utf-8"),
|
|
status=final_response.status,
|
|
reason=status_text,
|
|
encoding=encoding,
|
|
cookies=tuple(dict(cookie) for cookie in await page.context.cookies()),
|
|
headers=await first_response.all_headers(),
|
|
request_headers=await first_response.request.all_headers(),
|
|
history=history,
|
|
**parser_arguments,
|
|
)
|
|
|
|
@staticmethod
|
|
def from_http_request(response: CurlResponse, parser_arguments: Dict) -> Response:
|
|
"""Takes `curl_cffi` response and generates `Response` object from it.
|
|
|
|
:param response: `curl_cffi` response object
|
|
:param parser_arguments: Additional arguments to be passed to the `Response` object constructor.
|
|
:return: A `Response` object that is the same as `Selector` object except it has these added attributes: `status`, `reason`, `cookies`, `headers`, and `request_headers`
|
|
"""
|
|
return Response(
|
|
url=response.url,
|
|
text=response.text,
|
|
body=response.content
|
|
if type(response.content) is bytes
|
|
else response.content.encode(),
|
|
status=response.status_code,
|
|
reason=response.reason,
|
|
encoding=response.encoding or "utf-8",
|
|
cookies=dict(response.cookies),
|
|
headers=dict(response.headers),
|
|
request_headers=dict(response.request.headers),
|
|
method=response.request.method,
|
|
history=response.history, # https://github.com/lexiforest/curl_cffi/issues/82
|
|
**parser_arguments,
|
|
)
|