SjשldZddlZddlmZmZmZmZmZmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z1dd l/m2Z3dd l/m4Z5dd l/m6Z7dd l/m8Z9dd l/m4Z:dd l/m;Z<ddl/m=Z>ddl/m?Z@ddl/mAZBddlCmDZDGddZEy)zs Main Firecrawl v2 API client. This module provides the main client class that orchestrates all v2 functionality. N)OptionalListDictAnyCallableUnionLiteral) ClientConfig ScrapeOptionsDocument SearchRequest SearchData SourceOptionCategoryOption CrawlRequest CrawlResponseCrawlJobCrawlParamsRequest PDFParserCrawlParamsData WebhookConfigAgentWebhookConfigCrawlErrorsResponseActiveCrawlsResponse MapOptionsMapData FormatOption WaitActionScreenshotAction ClickAction WriteAction PressAction ScrollAction ScrapeActionExecuteJavascriptAction PDFActionLocationPaginationConfig AgentOptions) HttpClient)FirecrawlError)scrape)crawl)batch)search)map)usage)extract)agent)browserWatcherc<H eZdZdZededefdZ ddeededee d e d e f d Z ddddddddddddddddddddd ded ee ddee eefdee edee edeedee dee deedeee ee eeeffdee eddeddeedeedeedeedeedeed ee d!eed"eedef,d#Zdddddddddd$ d%ed&ee ed'ee ed(ee d)eedeed*eedee d+eed"eedefd,Zddddddd-dd-d-d-ddddd-d-d.dddd/ded0eed1ee ed2ee ed3ee d4eed5d6eed7ed(ee d8ed9ed:ed;ee ded?ed@e dee dAee d"eedef.dBZddddddd-dd-d-d-ddddd-d-ddCded0eed1ee ed2ee ed3ee d4eed5d6eed7ed(ee d8ed9ed:ed;ee ded?ed"eedef(dDZ dddEdFedGeedAee defdHZddEdIedAee defdJZdKede fdLZ!de"fdMZ#de"fdNZ$dddddddddOdedPeedQeed7eed(ee d4eed5dee d"eedee%de&fdRZ'dKedefdSZ(ded0ede)fdTZ* ddddddddddddU dVee ed0eedWee ee+fdXeed9eedYeedZeed+ed[d*eed"eed\ee,fd]Z- dddddddddd.dddd^ dVee ed0eedWee ee+fdXeed9eedYeedZeed+ed[d*eed@e dee d"eed\ee,fd_Z.ddddddddddddddddddddddddddd`dVe ed ee ddee eefdee edee edeedee dee deedeee ee eeeffdee eddeddeedeedeedeedeedeed ee d!eed=eeeefdaeed*eeddyZ?ddddzd{ee d|ee d}eefd~Z@ddddedededdee fdZAdefdZBdddeedfdZCdd.dddFededd@e dee deDf dZEddddddddddddddddddddddddddd.dddVe ed ee ddee eefdee edee edeedee dee deedeee ee eeeffdee eddeddeedeedeedeedeedeed ee d!eed=eeeefdaeed*eed__init__zFirecrawlClient.__init__Dsu$ ?ii 34G  ! !' *7-  ##)   &  #)  r@)formatsheaders include_tags exclude_tagsonly_main_contentrCwait_formobileparsersactionslocationskip_tls_verificationremove_base64_images fast_modeuse_mock block_adsproxymax_agestore_in_cache integrationrOrrPrQrRrSrTrUrVrW) rr r!r"r#r$r%r&r'rXr(rYrZr[r\r]r^r_r`ractd|||||||| | | | | ||||||||fDrrtditdid|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|d|d|jDcic] \}}||| c}}nd}t j |j ||Scc}}w)ab Scrape a single URL and return the document. Args: url: URL to scrape formats: List of formats to scrape headers: Dictionary of headers to use include_tags: List of tags to include exclude_tags: List of tags to exclude only_main_content: Whether to only scrape the main content timeout: Timeout in milliseconds wait_for: Wait for a specific element to be present mobile: Whether to use mobile mode parsers: List of parsers to use actions: List of actions to perform location: Location to scrape skip_tls_verification: Whether to skip TLS verification remove_base64_images: Whether to remove base64 images fast_mode: Whether to use fast mode use_mock: Whether to use mock mode block_ads: Whether to block ads proxy: Proxy to use max_age: Maximum age of the cache store_in_cache: Whether to store the result in the cache Returns: Document c3$K|]}|du ywN.0vs r> z)FirecrawlClient.scrape..s\1$\rOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`raNre)anyr dictitems scrape_moduler-rL)rMr:rOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`rakrhoptionss r>r-zFirecrawlClient.scrapeosT\'<Whjqs{~DFMOVX`bwyMOXZbdmotv}MOZ)[\\/  $!!!*!* ! #4 !  !"!! ! !"!'<!&:!$!"! $!!"#!$ %!& .'!(()!*eg+(1*+!t( .bf/ 0##D$4$4c7CC/(sB<) sources categorieslimittbsrXignore_invalid_urlsrCscrape_optionsraqueryrqrrrsrtrurvc lt||||||||| |  } tj|j| S)a Search for documents. Args: query: Search query string limit: Maximum number of results to return (default: 5) tbs: Time-based search filter location: Location string for search timeout: Request timeout in milliseconds (default: 300000) page_options: Options for scraping individual pages Returns: SearchData containing the search results ) rwrqrrrsrtrXrurCrvra)r search_moduler0rL) rMrwrqrrrsrtrXrurCrvrarequests r>r0zFirecrawlClient.searchsG8 ! 3)#  ##D$4$4g>>r@F)prompt exclude_paths include_pathsmax_discovery_depthsitemapignore_sitemapignore_query_parametersrscrawl_entire_domainallow_external_linksallow_subdomainsdelaymax_concurrencywebhookrvregex_on_full_urlzero_data_retention poll_intervalrCrequest_timeoutrar|r}r~rr)onlyincludeskiprrrrrrrrrrrrc|}|||rdnd}id|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|}|||d<tdi|}tj|j||||S)aR Start a crawl job and wait for it to complete. Args: url: Target URL to start crawling from prompt: Optional prompt to guide the crawl exclude_paths: Patterns of URLs to exclude include_paths: Patterns of URLs to include max_discovery_depth: Maximum depth for finding new URLs sitemap: Sitemap usage mode ("only" | "include" | "skip") ignore_sitemap: Deprecated alias for sitemap ("skip" when true, "include" when false) ignore_query_parameters: Ignore URL parameters limit: Maximum pages to crawl crawl_entire_domain: Follow parent directory links allow_external_links: Follow external domain links allow_subdomains: Follow subdomains delay: Delay in seconds between scrapes max_concurrency: Maximum number of concurrent scrapes webhook: Webhook configuration for notifications scrape_options: Page scraping configuration regex_on_full_url: Apply includePaths/excludePaths regex to the full URL (including query parameters) instead of just the pathname zero_data_retention: Whether to delete data after 24 hours poll_interval: Seconds between status checks timeout: Maximum seconds to wait for the entire crawl job to complete (None for no timeout) request_timeout: Timeout (in seconds) for each individual HTTP request, including pagination requests when fetching results. If there are multiple pages, each page request gets this timeout Returns: CrawlJob when job completes Raises: ValueError: If request is invalid Exception: If the crawl fails to start or complete TimeoutError: If timeout is reached rrr:r|r}r~rrrsrrrrrrrvrrrar)rrCrre)r crawl_moduler.rL)rMr:r|r}r~rrrrrsrrrrrrrvrrrrCrraresolved_sitemaprequest_kwargsrzs r>r.zFirecrawlClient.crawls=x#  #(B)7vY  3 f  ]  ]  "#6  &'>   U  "#6  #$8   0  U    w  n  !2 "#6! " ;# &  '(8N9 %00!!    '+   r@)r|r}r~rrrrrsrrrrrrrvrrrac|}|||rdnd}id|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|}|||d<tdi|}tj|j|S)a Start an asynchronous crawl job. Args: url: Target URL to start crawling from prompt: Optional prompt to guide the crawl exclude_paths: Patterns of URLs to exclude include_paths: Patterns of URLs to include max_discovery_depth: Maximum depth for finding new URLs sitemap: Sitemap usage mode ("only" | "include" | "skip") ignore_sitemap: Deprecated alias for sitemap ("skip" when true, "include" when false) ignore_query_parameters: Ignore URL parameters limit: Maximum pages to crawl crawl_entire_domain: Follow parent directory links allow_external_links: Follow external domain links allow_subdomains: Follow subdomains delay: Delay in seconds between scrapes max_concurrency: Maximum number of concurrent scrapes webhook: Webhook configuration for notifications scrape_options: Page scraping configuration regex_on_full_url: Apply includePaths/excludePaths regex to the full URL (including query parameters) instead of just the pathname zero_data_retention: Whether to delete data after 24 hours Returns: CrawlResponse with job information Raises: ValueError: If request is invalid Exception: If the crawl operation fails to start rrr:r|r}r~rrrsrrrrrrrvrrrarre)rr start_crawlrL)rMr:r|r}r~rrrrrsrrrrrrrvrrrarrrzs r>rzFirecrawlClient.start_crawlGs.j#  #(B)7vY  3 f  ]  ]  "#6  &'>   U  "#6  #$8   0  U    w  n  !2 "#6! " ;# &  '(8N9 %00''(8(8'BBr@rjob_idpagination_configcHtj|j|||S)av Get the status of a crawl job. Args: job_id: ID of the crawl job pagination_config: Optional configuration for pagination behavior request_timeout: Timeout (in seconds) for each individual HTTP request. When auto-pagination is enabled (default) and there are multiple pages of results, this timeout applies to each page request separately, not to the entire operation Returns: CrawlJob with current status and data Raises: Exception: If the status check fails )rr)rget_crawl_statusrL)rMrrrs r>rz FirecrawlClient.get_crawl_statuss).,,    /+   r@next_urlcFtj|j||S)a7 Fetch a single page of crawl results using a next URL. Args: next_url: Opaque next URL from a prior crawl status response request_timeout: Timeout (in seconds) for the HTTP request Returns: CrawlJob with the page data and next URL (if any) r)rget_crawl_status_pagerLrMrrs r>rz%FirecrawlClient.get_crawl_status_pages& 11    +  r@crawl_idcBtj|j|S)a Retrieve error details and robots.txt blocks for a given crawl job. Args: crawl_id: The ID of the crawl job Returns: CrawlErrorsResponse containing per-URL errors and robots-blocked URLs )rget_crawl_errorsrLrMrs r>rz FirecrawlClient.get_crawl_errorss,,T-=-=xHHr@c@tj|jS)z Get a list of currently active crawl jobs. Returns: ActiveCrawlsResponse containing a list of active crawl jobs. )rget_active_crawlsrLrMs r>rz!FirecrawlClient.get_active_crawlss--d.>.>??r@c"|jS)z List currently active crawl jobs for the authenticated team. Returns: ActiveCrawlsResponse containing the list of active crawl jobs )rrs r> active_crawlszFirecrawlClient.active_crawlss%%''r@r0include_subdomainsrrsrrCrarXr0rc td|||||||| fDrt||||||nd||| nd} tj|j|| S)a/Map a URL and return discovered links. Args: url: Root URL to explore search: Optional substring filter for discovered links include_subdomains: Whether to include subdomains ignore_query_parameters: Whether to ignore query parameters when mapping limit: Maximum number of links to return sitemap: Sitemap usage mode ("only" | "include" | "skip") timeout: Request timeout in milliseconds Returns: MapData containing the discovered links c3$K|]}|du ywrdrerfs r>riz&FirecrawlClient.map..sO1$OrjNrr)rkr map_moduler1rL) rMr:r0rrrsrrCrarXrps r>r1zFirecrawlClient.mapsHO1CE\^celnuxCEM)NOO1$;&2G #  UY ~~d..W==r@cBtj|j|S)z Cancel a crawl job. Args: crawl_id: The ID of the crawl job to cancel Returns: bool: True if the crawl was cancelled, False otherwise )r cancel_crawlrLrs r>rzFirecrawlClient.cancel_crawls(()9)98DDr@c\t||}tj|j|S)zDerive crawl parameters from natural-language prompt. Args: url: Root URL prompt: Instruction describing how to crawl Returns: CrawlParamsData with normalized crawl configuration )r:r|)rrcrawl_params_previewrL)rMr:r|rzs r>rz$FirecrawlClient.crawl_params_preview s)%V<001A1A7KKr@ r|schema system_promptrenable_web_search show_sourcesrvrurar4urlsrrrrr r4c Xtj|j||||||||| | |  S)aStart an extract job (non-blocking). .. deprecated:: The extract endpoint is in maintenance mode and its use is discouraged. Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement. Args: urls: URLs to extract from (optional) prompt: Natural-language instruction for extraction schema: Target JSON schema for the output system_prompt: Optional system instruction allow_external_links: Allow hyperlinks in output enable_web_search: Whether to augment with web search show_sources: Include per-field/source mapping when available scrape_options: Scrape options applied prior to extraction ignore_invalid_urls: Skip invalid URLs instead of failing integration: Integration tag/name agent: Agent configuration Returns: Response payload with job id/status (poll with get_extract_status) r)extract_module start_extractrL) rMrr|rrrrrrvrurar4s r>rzFirecrawlClient.start_extract-sBJ++    '!5/%) 3#  r@ r|rrrrrrvrurrCrar4c \tj|j||||||||| | | | | S)aExtract structured data and wait until completion. .. deprecated:: The extract endpoint is in maintenance mode and its use is discouraged. Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement. Args: urls: URLs to extract from (optional) prompt: Natural-language instruction for extraction schema: Target JSON schema for the output system_prompt: Optional system instruction allow_external_links: Allow hyperlinks in output enable_web_search: Whether to augment with web search show_sources: Include per-field/source mapping when available scrape_options: Scrape options applied prior to extraction ignore_invalid_urls: Skip invalid URLs instead of failing poll_interval: Seconds between status checks timeout: Maximum seconds to wait (None for no timeout) integration: Integration tag/name agent: Agent configuration Returns: Final extract response when completed r)rr3rL)rMrr|rrrrrrvrurrCrar4s r>r3zFirecrawlClient.extractasHR%%    '!5/%) 3'#  r@)rOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`r append_to_idrurrraidempotency_keyrrctd|||||||| | | | | |||||||fDrotditdid|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|d|jDcic] \}}||| c}}nd}t j |j ||||||||| Scc}}w)aStart a batch scrape job over multiple URLs (non-blocking). Args: urls: List of URLs to scrape formats: Output formats to collect per URL headers: HTTP headers include_tags: HTML tags to include exclude_tags: HTML tags to exclude only_main_content: Restrict scraping to main content timeout: Per-request timeout in milliseconds wait_for: Wait condition in milliseconds mobile: Emulate mobile viewport parsers: Parser list (e.g., ["pdf"]) actions: Browser actions to perform location: Location settings skip_tls_verification: Skip TLS verification remove_base64_images: Remove base64 images from output fast_mode: Prefer faster scraping modes use_mock: Use a mock data source (internal/testing) block_ads: Block ads during scraping proxy: Proxy setting max_age: Cache max age store_in_cache: Whether to store results in cache webhook: Webhook configuration append_to_id: Append to an existing batch job ignore_invalid_urls: Skip invalid URLs without failing max_concurrency: Max concurrent scrapes zero_data_retention: Delete data after 24 hours integration: Integration tag/name idempotency_key: Header used to deduplicate starts Returns: Response payload with job id (poll with get_batch_scrape_status) c3$K|]}|du ywrdrerfs r>riz5FirecrawlClient.start_batch_scrape..O1$OrjrOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`N)rprrrurrrarre)rkr rlrm batch_modulestart_batch_scraperL)rMrrOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`rrrurrrarrorhrps r>rz"FirecrawlClient.start_batch_scrapesnO'<Whjqs{~DFMOVX`bwyMOXZbdmotv}M)NOO-  $!!!*!* ! #4 !  !"!! ! !"!'<!&:!$!"! $!!"#!$ %!& .'!(eg)(1()!t( ,UY- 0..    % 3+ 3#+  /(sCcFtj|j||S)aGet current status and any scraped data for a batch job. Args: job_id: Batch job ID pagination_config: Optional configuration for pagination behavior Returns: Status payload including counts and partial data )r)rget_batch_scrape_statusrL)rMrrs r>rz'FirecrawlClient.get_batch_scrape_statuss&33    /  r@cFtj|j||S)aBFetch a single page of batch scrape results using a next URL. Args: next_url: Opaque next URL from a prior batch scrape status response request_timeout: Timeout (in seconds) for the HTTP request Returns: BatchScrapeJob with the page data and next URL (if any) r)rget_batch_scrape_status_pagerLrs r>rz,FirecrawlClient.get_batch_scrape_status_pages&88    +  r@cBtj|j|S)zCancel a running batch scrape job. Args: job_id: Batch job ID Returns: True if the job was cancelled )rcancel_batch_scraperLrMrs r>rz#FirecrawlClient.cancel_batch_scrape*s//0@0@&IIr@cBtj|j|S)zRetrieve error details for a batch scrape job. Args: job_id: Batch job ID Returns: Errors and robots-blocked URLs for the job ) batch_methodsget_batch_scrape_errorsrLrs r>rz'FirecrawlClient.get_batch_scrape_errors5s44T5E5EvNNr@cBtj|j|S)aGet the current status (and data if completed) of an extract job. .. deprecated:: The extract endpoint is in maintenance mode and its use is discouraged. Review https://docs.firecrawl.dev/developer-guides/usage-guides/choosing-the-data-extractor to find a replacement. Args: job_id: Extract job ID Returns: Extract response payload with status and optional data )rget_extract_statusrLrs r>rz"FirecrawlClient.get_extract_status@s001A1A6JJr@)rra max_creditsstrict_constrain_to_urlsmodelrrrr)z spark-1-proz spark-1-minic Rtj|j|||||||| S)aTStart an agent job (non-blocking). Args: urls: URLs to process (optional) prompt: Natural-language instruction for the agent schema: Target JSON schema for the output (dict or Pydantic BaseModel) integration: Integration tag/name max_credits: Maximum credits to use (optional) model: Model to use for the agent ("spark-1-pro" or "spark-1-mini") webhook: Webhook URL or configuration for notifications Returns: Response payload with job id/status (poll with get_agent_status) )r|rrarrrr) agent_module start_agentrL) rMrr|rrarrrrs r>rzFirecrawlClient.start_agentPs82''    ##%=  r@)rrarrCrrrrc Vtj|j||||||||| |  S)aRun an agent and wait until completion. Args: urls: URLs to process (optional) prompt: Natural-language instruction for the agent schema: Target JSON schema for the output (dict or Pydantic BaseModel) integration: Integration tag/name poll_interval: Seconds between status checks timeout: Maximum seconds to wait (None for no timeout) max_credits: Maximum credits to use (optional) model: Model to use for the agent ("spark-1-pro" or "spark-1-mini") webhook: Webhook URL or configuration for notifications Returns: Final agent response when completed ) r|rrarrCrrrr)rr4rL) rMrr|rrarrCrrrrs r>r4zFirecrawlClient.agentus>:!!    #'#%=  r@cBtj|j|S)zGet the current status (and data if completed) of an agent job. Args: job_id: Agent job ID Returns: Agent response payload with status and optional data )rget_agent_statusrLrs r>rz FirecrawlClient.get_agent_statuss,,T-=-=vFFr@cBtj|j|S)zCancel a running agent job. Args: job_id: Agent job ID Returns: True if the agent was cancelled )r cancel_agentrLrs r>rzFirecrawlClient.cancel_agents(()9)96BBr@c@tj|jS)zCGet current concurrency and maximum allowed for this team/key (v2).) usage_methodsget_concurrencyrLrs r>rzFirecrawlClient.get_concurrency,,T-=-=>>r@c@tj|jS)z-Get remaining credits for this team/key (v2).)rget_credit_usagerLrs r>rz FirecrawlClient.get_credit_usage--d.>.>??r@c@tj|jS)z$Get recent token usage metrics (v2).)rget_token_usagerLrs r>rzFirecrawlClient.get_token_usagerr@ by_api_keycBtj|j|S)z!Get historical credit usage (v2).)rget_credit_usage_historicalrLrMrs r>rz+FirecrawlClient.get_credit_usage_historicals889I9I:VVr@cBtj|j|S)z Get historical token usage (v2).)rget_token_usage_historicalrLrs r>rz*FirecrawlClient.get_token_usage_historicals778H8H*UUr@c@tj|jS)z*Get metrics about the team's scrape queue.)rget_queue_statusrLrs r>rz FirecrawlClient.get_queue_statusrr@ttl activity_ttlstream_web_viewrrrcHtj|j|||S)aJCreate a new browser session. Args: ttl: Total time-to-live in seconds (30-3600, default 300) activity_ttl: Inactivity TTL in seconds (10-3600) stream_web_view: Whether to enable webview streaming Returns: BrowserCreateResponse with session id and CDP URL r)browser_moduler5rL)rMrrrs r>r5zFirecrawlClient.browsers)"%%   %+   r@bashlanguagerC session_idcoder)pythonnodercJtj|j||||S)aaExecute code in a browser session. Args: session_id: Browser session ID code: Code to execute language: Programming language ("python", "node", or "bash") timeout: Execution timeout in seconds (1-300, default 30) Returns: BrowserExecuteResponse with execution result r)rbrowser_executerL)rMrrrrCs r>rzFirecrawlClient.browser_executes,&--        r@cBtj|j|S)zDelete a browser session. Args: session_id: Browser session ID Returns: BrowserDeleteResponse )rdelete_browserrL)rMrs r>rzFirecrawlClient.delete_browsers,,T-=-=zJJr@statusr)active destroyedcDtj|j|S)zList browser sessions. Args: status: Filter by session status ("active" or "destroyed") Returns: BrowserListResponse with list of sessions r)r list_browsersrL)rMrs r>rzFirecrawlClient.list_browsers s#++     r@r.kindrrCr)r.r/c"t|||||S)aACreate a watcher for crawl or batch jobs. Args: job_id: Job ID to watch kind: Job kind ("crawl" or "batch") poll_interval: Seconds between status checks timeout: Maximum seconds to watch (None for no timeout) Returns: Watcher instance rr6)rMrrrrCs r>watcherzFirecrawlClient.watchers&tV$mU\]]r@)rOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`rrrurrrarr wait_timeoutrctd|||||||| | | | | |||||||fDrotditdid|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|d|jDcic] \}}||| c}}nd} t j |j || ||||||||| Scc}}w)zE Start a batch scrape job and wait until completion. c3$K|]}|du ywrdrerfs r>riz/FirecrawlClient.batch_scrape..nrrjrOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`N) rprrrurrrarrrCre)rkr rlrmr batch_scraperL)!rMrrOrPrQrRrSrCrTrUrVrWrXrYrZr[r\r]r^r_r`rrrurrrarrrrorhrps! r>r zFirecrawlClient.batch_scrape4stO'<Whjqs{~DFMOVX`bwyMOXZbdmotv}M)NOO-  $!!!*!* ! #4 !  !"!! ! !"!'<!&:!$!"! $!!"#!$ %!& .'!(eg)(1()!t( ,UY- 0((    % 3+ 3#+'   /(sC)Nzhttps://api.firecrawl.devNg?rd)F)G__name__ __module__ __qualname____doc__ staticmethodstrboolr?rfloatintrNrrrrr r-rrr rr0r rrr.rrr)rrrrrrrr(rr1rrrrr*rr3rrrrrrrrr4rrrrrrrrr5rrrr7rr rer@r>r9r99s` 2s2t22 "&2#' # ) #) ) % )  )  ) ^37,0,0,0,0!%"&!%KOAE)-04/3$("&$(#!%)-%)/KD KD$~./ KD $sCx.) KD tCy) KDtCy)KD$D>KD#KD3-KDKD%S 4c9n0E+F FGHKD$u&{ |}~KD:&KD (~KD 'tn!KD"D>#KD$3-%KD&D>'KD(})KD*#+KD,!-KD.c]/KD0 1KDb1559#!"&.2!%26%))?)?$|,- )? T.12 )? } )?c])?3-)?&d^)?#)?!/)?c])? )?^!%-1-1-1@D)-(-#$)%*!&#)-7;26"'$)!%+/%)1^ ^  ^  S * ^  S * ^ &c]^ '";<=^ !^ "&^ }^ "^ #^ ^ }^ "#!^ "%] 234#^ $!/%^ & '^ (")^ *+^ ,#-^ ."%/^ 0c]1^ 2 3^ H!%-1-1-1@D)-(-#$)%*!&#)-7;26"'$)%)+QC QC QC  S * QC  S * QC&c]QC'";<=QC!QC"&QC}QC"QC#QCQC}QC "#!QC"%] 234#QC$!/%QC& 'QC(")QC*c]+QC, -QCl9= ,0   $$45 "%    D,0   "%    , I I1D I@#7@(3(!%-126#@D!%%)'+&> &> &> %TN &> "*$ &>}&>'";<=&>#&>c]&>8$&> &>P ES ET E L LS L_ L%)2 !%+/'+/3,0'+48.2%)(,2 tCy!2  2 c3h( 2  } 2 'tn2 $D>2 tn2 !12 &d^2 c]2  %2 l%)8 !%+/'+/3,0'+48.2!%%)(,8 tCy!8  8 c3h( 8  } 8 'tn8 $D>8 tn8 !18 &d^8 8 #8 c]8  %8 |37,0,0,0,0!%"&!%KOAE)-04/3$("&$(#!%)-7;&*.2)-.2%))-;d 3id $~./ d $sCx.) d tCy) d tCy)d $D>d #d 3-d d %S 4c9n0E+F FGHd $u&{ |}~d :&d  (~d 'tn!d "D>#d $3-%d &D>'d (})d *#+d ,!-d .%] 234/d 0sm1d 2&d^3d 4"#5d 6&d^7d 8c]9d :"#;d R9=  $$45 0,0   "%  * J# J$ J Oc OKK$%)# !%%)%)37BF<@# tCy!#  #  # c] # c]# #+4.#  =>?# %%7 789# N%)) !%%)!%%)37BF<@) tCy!)  )  ) c] ) ) #) c]) #+4.)  =>?) %%7 789) V Gs G C3 C4 C?@?WdWVTV@"&**.  c] sm  "$  :7=!%    23  #  6 K K<@ !678 ,+2!% ^^&' ^  ^ # ^ ^237,0,0,0,0!%"&!%KOAE)-04/3$("&$(#!%)-7;&*.2)-.2%))-&*?I 3iI $~./ I $sCx.) I tCy) I tCy)I $D>I #I 3-I I %S 4c9n0E+F FGHI $u&{ |}~I :&I  (~I 'tn!I "D>#I $3-%I &D>'I (})I *#+I ,!-I .%] 234/I 0sm1I 2&d^3I 4"#5I 6&d^7I 8c]9I :"#;I <=I >sm?I r@r9)FrrHtypingrrrrrrr typesr r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*utils.http_clientr+utils.error_handlerr,methodsr-rnr.rr/rr0ryr1rrr2rr3rr4rr5rrr7r9rer@r>rs{  FFF!!!!!!!!!D*/,**,&++.*.D D r@