merge_cookies() — requests Function Reference

Architecture documentation for the merge_cookies() function in cookies.py from the requests codebase.

Function python CoreAPI VerbHandlers calls 3 called by 2

Entity Profile

CoreAPI→ VerbHandlers→ merge_cookies() — requests Function Reference

Dependency Diagram

graph TD
  b950528f_167e_7566_bbfa_f2e1929d1939["merge_cookies()"]
  270696ff_2a4f_ef5b_92e8_33a79e68a2d8["cookies.py"]
  b950528f_167e_7566_bbfa_f2e1929d1939 -->|defined in| 270696ff_2a4f_ef5b_92e8_33a79e68a2d8
  cbf6862f_d124_817f_3342_f1142c276f25["resolve_redirects()"]
  cbf6862f_d124_817f_3342_f1142c276f25 -->|calls| b950528f_167e_7566_bbfa_f2e1929d1939
  a4eb532d_c481_9e3e_ad07_8d203ffafd2d["prepare_request()"]
  a4eb532d_c481_9e3e_ad07_8d203ffafd2d -->|calls| b950528f_167e_7566_bbfa_f2e1929d1939
  fad58eac_0316_2b83_52d3_1a1829c12c66["cookiejar_from_dict()"]
  b950528f_167e_7566_bbfa_f2e1929d1939 -->|calls| fad58eac_0316_2b83_52d3_1a1829c12c66
  0aace64c_6424_62be_3052_5ea0e8ae90d3["update()"]
  b950528f_167e_7566_bbfa_f2e1929d1939 -->|calls| 0aace64c_6424_62be_3052_5ea0e8ae90d3
  18b8e0d9_87b2_0c01_a9bc_40b6eb7e0054["set_cookie()"]
  b950528f_167e_7566_bbfa_f2e1929d1939 -->|calls| 18b8e0d9_87b2_0c01_a9bc_40b6eb7e0054
  style b950528f_167e_7566_bbfa_f2e1929d1939 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/requests/cookies.py lines 542–561

def merge_cookies(cookiejar, cookies):
    """Add cookies to cookiejar and returns a merged CookieJar.

    :param cookiejar: CookieJar object to add the cookies to.
    :param cookies: Dictionary or CookieJar object to be added.
    :rtype: CookieJar
    """
    if not isinstance(cookiejar, cookielib.CookieJar):
        raise ValueError("You can only merge into CookieJar")

    if isinstance(cookies, dict):
        cookiejar = cookiejar_from_dict(cookies, cookiejar=cookiejar, overwrite=False)
    elif isinstance(cookies, cookielib.CookieJar):
        try:
            cookiejar.update(cookies)
        except AttributeError:
            for cookie_in_jar in cookies:
                cookiejar.set_cookie(cookie_in_jar)

    return cookiejar