g  `ddlmZGddeZGddZ d dededed ed ef d Zy ))Enumc$eZdZdZdZdZdZdZdZy) CacheModea@ Defines the caching behavior for web crawling operations. Modes: - ENABLED: Normal caching behavior (read and write) - DISABLED: No caching at all - READ_ONLY: Only read from cache, don't write - WRITE_ONLY: Only write to cache, don't read - BYPASS: Bypass cache for this operation enableddisabled read_only write_onlybypassN) __name__ __module__ __qualname____doc__ENABLEDDISABLED READ_ONLY WRITE_ONLYBYPASSK/var/www/openai/venv/lib/python3.12/site-packages/crawl4ai/cache_context.pyrrs" GHIJ FrrcTeZdZdZd dededefdZdefdZdefdZ e defd Z y ) CacheContexta2 Encapsulates cache-related decisions and URL handling. This class centralizes all cache-related logic and URL type checking, making the caching behavior more predictable and maintainable. Attributes: url (str): The URL being processed. cache_mode (CacheMode): The cache mode for the current operation. always_bypass (bool): If True, bypasses caching for this operation. is_cacheable (bool): True if the URL is cacheable, False otherwise. is_web_url (bool): True if the URL is a web URL, False otherwise. is_local_file (bool): True if the URL is a local file, False otherwise. is_raw_html (bool): True if the URL is raw HTML, False otherwise. _url_display (str): The display name for the URL (web, local file, or raw HTML). url cache_mode always_bypassc||_||_||_|jd|_|jd|_|jd|_|jd|_|js||_yd|_y)a9 Initializes the CacheContext with the provided URL and cache mode. Args: url (str): The URL being processed. cache_mode (CacheMode): The cache mode for the current operation. always_bypass (bool): If True, bypasses caching for this operation. )http://https://file://)rrrzraw:zRaw HTMLN) rrr startswith is_cacheable is_web_url is_local_file is_raw_html _url_display)selfrrrs r__init__zCacheContext.__init__'sv$*NN+MN..)@A ^^I6>>&1'+'7'7CZrreturnc|js |jsy|jtjtj fvS)aK Determines if cache should be read based on context. How it works: 1. If always_bypass is True or is_cacheable is False, return False. 2. If cache_mode is ENABLED or READ_ONLY, return True. Returns: bool: True if cache should be read, False otherwise. F)rr!rrrrr&s r should_readzCacheContext.should_read9s8   T%6%69#4#4i6I6I"JJJrc|js |jsy|jtjtj fvS)aR Determines if cache should be written based on context. How it works: 1. If always_bypass is True or is_cacheable is False, return False. 2. If cache_mode is ENABLED or WRITE_ONLY, return True. Returns: bool: True if cache should be written, False otherwise. F)rr!rrrrr*s r should_writezCacheContext.should_writeHs8   T%6%69#4#4i6J6J"KKKrc|jS)z"Returns the URL in display format.)r%r*s r display_urlzCacheContext.display_urlWs   rN)F) r r r rstrrboolr'r+r-propertyr/rrrrrs\ HCHYHtH$ KT K Ld L!S!!rr disable_cache bypass_cache no_cache_readno_cache_writer(c|rtjS|rtjS|r|rtjS|rtjS|rtjStj S)z Converts legacy cache parameters to the new CacheMode enum. This is an internal function to help transition from the old boolean flags to the new CacheMode system. )rrrrrr)r3r4r5r6s r_legacy_to_cache_moder8]s]!!!!!!###"""   rN)FFFF)enumrrrr1r8rrrr:sb$D!D!P     r