+
    åûjc…  ã                  ól  € R t ^ RIHt ^ RIHt ^ RIt^ RIHt ^ RIH	t	 ^ RIH
t
 ^ RIHt ^ RIHt ^ RIHt ^ R	IHt ^ R
IHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^RIHt ^RIHt ^RIHt ^RIH t  ^RIH!t!  ! R R]4      t"RR/R R llt#R!R R  llt$R# )"a  Provides the :class:`~sqlalchemy.engine.url.URL` class which encapsulates
information about a database connection specification.

The URL object is created automatically when
:func:`~sqlalchemy.engine.create_engine` is called with a string
argument; alternatively, the URL is a public-facing construct which can
be used directly and is also accepted directly by ``create_engine()``.
)ÚannotationsN)ÚAny)Úcast)ÚDict)ÚIterable)ÚList)ÚMapping)Ú
NamedTuple)ÚOptional)Úoverload)ÚSequence)ÚTuple)ÚType)ÚUnion)Ú	parse_qsl)Úquote)Ú
quote_plus)Úunquote)ÚDialect)Úexc)Úutil)Úplugins)Úregistryc                  ó\  € ] tR t^.t$ RtR]R&    R]R&    R]R&    R]R&    R]R	&    R]R
&    R]R&    ]RRRRR]P                  3R R ll4       t	]R R l4       t
]R R l4       t]R R l4       t]R R l4       tRGR R lltR R ltRHRR/R R llltRHR  R! lltRHR" R# lltR$ R% lt]R& R' l4       t]P,                  ! R(R)4      RIR* R+ ll4       tRIR, R- lltR. R/ ltR0 R1 ltR2 R3 ltR4 R5 ltR6 R7 ltR8 R9 ltR: R; ltR< R= lt R> R? lt!R@ RA lt"RHRB RC llt#RJRD RE llt$RFt%R# )KÚURLa  
Represent the components of a URL used to connect to a database.

URLs are typically constructed from a fully formatted URL string, where the
:func:`.make_url` function is used internally by the
:func:`_sa.create_engine` function in order to parse the URL string into
its individual components, which are then used to construct a new
:class:`.URL` object. When parsing from a formatted URL string, the parsing
format generally follows
`RFC-1738 <https://www.ietf.org/rfc/rfc1738.txt>`_, with some exceptions.

A :class:`_engine.URL` object may also be produced directly, either by
using the :func:`.make_url` function with a fully formed URL string, or
by using the :meth:`_engine.URL.create` constructor in order
to construct a :class:`_engine.URL` programmatically given individual
fields. The resulting :class:`.URL` object may be passed directly to
:func:`_sa.create_engine` in place of a string argument, which will bypass
the usage of :func:`.make_url` within the engine's creation process.

.. versionchanged:: 1.4

    The :class:`_engine.URL` object is now an immutable object.  To
    create a URL, use the :func:`_engine.make_url` or
    :meth:`_engine.URL.create` function / method.  To modify
    a :class:`_engine.URL`, use methods like
    :meth:`_engine.URL.set` and
    :meth:`_engine.URL.update_query_dict` to return a new
    :class:`_engine.URL` object with modifications.   See notes for this
    change at :ref:`change_5526`.

.. seealso::

    :ref:`database_urls`

:class:`_engine.URL` contains the following attributes:

* :attr:`_engine.URL.drivername`: database backend and driver name, such as
  ``postgresql+psycopg2``
* :attr:`_engine.URL.username`: username string
* :attr:`_engine.URL.password`: password string
* :attr:`_engine.URL.host`: string hostname
* :attr:`_engine.URL.port`: integer port number
* :attr:`_engine.URL.database`: string database name
* :attr:`_engine.URL.query`: an immutable mapping representing the query
  string.  contains strings for keys and either strings or tuples of
  strings for values.


ÚstrÚ
drivernameúOptional[str]ÚusernameÚpasswordÚhostúOptional[int]ÚportÚdatabaseú4util.immutabledict[str, Union[Tuple[str, ...], str]]ÚqueryNc               ó8   € V ^8„  d   QhRRRRRRRRRRR	RR
RRR/# )é   r   r   r   r   r   r    r"   r!   r#   r%   z'Mapping[str, Union[Sequence[str], str]]Úreturnr   © )Úformats   "ÚQC:\Ai_Coding\apps\studio\ComfyUI\.venv\Lib\site-packages\sqlalchemy\engine\url.pyÚ__annotate__ÚURL.__annotate__™   sZ   € ÷ ?
ñ ?
àð?
ð  ð?
ð  ð	?
ð
 ð?
ð ð?
ð  ð?
ð 7ð?
ð 
ñ?
ó    c                óÚ   € V ! V P                  VR4      V P                  VR4      VV P                  VR4      V P                  V4      V P                  VR4      V P                  V4      4      # )aÊ  Create a new :class:`_engine.URL` object.

.. seealso::

    :ref:`database_urls`

:param drivername: the name of the database backend. This name will
  correspond to a module in sqlalchemy/databases or a third party
  plug-in.
:param username: The user name.
:param password: database password.  Is typically a string, but may
  also be an object that can be stringified with ``str()``.

  .. note:: The password string should **not** be URL encoded when
     passed as an argument to :meth:`_engine.URL.create`; the string
     should contain the password characters exactly as they would be
     typed.

  .. note::  A password-producing object will be stringified only
     **once** per :class:`_engine.Engine` object.  For dynamic password
     generation per connect, see :ref:`engines_dynamic_tokens`.

:param host: The name of the host.
:param port: The port number.
:param database: The database name.
:param query: A dictionary of string keys to string values to be passed
  to the dialect and/or the DBAPI upon connect.   To specify non-string
  parameters to a Python DBAPI directly, use the
  :paramref:`_sa.create_engine.connect_args` parameter to
  :func:`_sa.create_engine`.   See also
  :attr:`_engine.URL.normalized_query` for a dictionary that is
  consistently string->list of string.
:return: new :class:`_engine.URL` object.

.. versionadded:: 1.4

    The :class:`_engine.URL` object is now an **immutable named
    tuple**.  In addition, the ``query`` dictionary is also immutable.
    To create a URL, use the :func:`_engine.url.make_url` or
    :meth:`_engine.URL.create` function/ method.  To modify a
    :class:`_engine.URL`, use the :meth:`_engine.URL.set` and
    :meth:`_engine.URL.update_query` methods.

r   r   r    r#   )Ú_assert_strÚ_assert_none_strÚ_assert_portÚ	_str_dict)Úclsr   r   r   r    r"   r#   r%   s   &&&&&&&&r+   ÚcreateÚ
URL.create˜   sm   € ñp Ø�O‰O˜J¨Ó5Ø× Ñ  ¨:Ó6ØØ× Ñ   vÓ.Ø×Ñ˜TÓ"Ø× Ñ  ¨:Ó6Ø�M‰M˜%Ó ó
ð 	
r.   c               ó    € V ^8„  d   QhRRRR/# )r'   r"   r!   r(   r)   )r*   s   "r+   r,   r-   Û   s   € ÷ Hñ H ð H°-ñ Hr.   c                	óZ   € Vf   R #  \        V4      #   \         d    \        R4      hi ; i)Nz(Port argument must be an integer or None)ÚintÚ	TypeError)r4   r"   s   &&r+   r2   ÚURL._assert_portÚ   s7   € àŠ<Ùð	HÜ�t“9ÐøÜô 	HÜÐFÓGÐGð	Hús   ˆ
 “*c               ó$   € V ^8„  d   QhRRRRRR/# )r'   Úvr   Ú	paramnamer(   r)   )r*   s   "r+   r,   r-   ä   s!   € ÷ ñ ˜Cð ¨Cð °Cñ r.   c                	óV   € \        V\        4      '       g   \        R V,          4      hV# )z%s must be a string©Ú
isinstancer   r:   ©r4   r=   r>   s   &&&r+   r0   ÚURL._assert_strã   s%   € ä˜!œS×!Ò!ÜÐ1°IÕ=Ó>Ð>Øˆr.   c               ó$   € V ^8„  d   QhRRRRRR/# )r'   r=   r   r>   r   r(   r)   )r*   s   "r+   r,   r-   ê   s$   € ÷ -ñ -Øð-Ø*-ð-à	ñ-r.   c                	ó0   € Vf   V# V P                  W4      # ©N)r0   rB   s   &&&r+   r1   ÚURL._assert_none_stré   s   € ð Š9ØˆHà�‰˜qÓ,Ð,r.   c               ó    € V ^8„  d   QhRRRR/# )r'   Údict_ziOptional[Union[Sequence[Tuple[str, Union[Sequence[str], str]]], Mapping[str, Union[Sequence[str], str]]]]r(   r$   r)   )r*   s   "r+   r,   r-   ó   s    € ÷ 5
ñ 5
ð
ð5
ð 
>ñ5
r.   c           
     	óf  a€ Vf   \         P                  # \        R R l4       o\        R R l4       oR V3R lloR R lp\        V\        P
                  4      '       d   TpMVP                  4       p\         P                  ! V UUu/ uF  w  rEV! V4      S! V4      bK  	  upp4      # u uppi )	Nc               ó    € V ^8„  d   QhRRRR/# )r'   Úvalr   r(   r)   )r*   s   "r+   r,   Ú#URL._str_dict.<locals>.__annotate__   s   € ÷ 	ñ 	Øð	àñ	r.   c                ó   € R # rF   r)   ©rL   s   &r+   Ú_assert_valueÚ$URL._str_dict.<locals>._assert_valueÿ   s   € ñ r.   c               ó    € V ^8„  d   QhRRRR/# )r'   rL   zSequence[str]r(   úUnion[str, Tuple[str, ...]]r)   )r*   s   "r+   r,   rM     s   € ÷ 	.ñ 	.Øð	.à(ñ	.r.   c                ó   € R # rF   r)   rO   s   &r+   rP   rQ     s   € ñ +.r.   c               ó    € V ^8„  d   QhRRRR/# )r'   rL   zUnion[str, Sequence[str]]r(   rS   r)   )r*   s   "r+   r,   rM   	  s   € ÷ 	ñ 	Ø*ð	à(ñ	r.   c                óî   <€ \        V \        4      '       d   V # \        V \        P                  4      '       d3   \        ;QJ d    . V3R  lV  4       F  NK  	  5# ! V3R  lV  4       4      # \        R4      h)c              3  ó4   <"  € T F  pS! V4      x € K  	  R # 5irF   r)   )Ú.0ÚelemrP   s   & €r+   Ú	<genexpr>Ú7URL._str_dict.<locals>._assert_value.<locals>.<genexpr>  s   øé € ÐA¹S°T™]¨4×0Ð0»Sùs   ƒz?Query dictionary values must be strings or sequences of strings)rA   r   Úcollections_abcr   Útupler:   )rL   rP   s   &€r+   rP   rQ   	  s^   ø€ ô ˜#œs×#Ò#Ø�
Ü˜C¤×!9Ñ!9×:Ò:ß”uÔA¹SÓA—uÐA�uÔA¹SÓAÓAÐAäð+óð r.   c               ó    € V ^8„  d   QhRRRR/# )r'   r=   r   r(   r)   )r*   s   "r+   r,   rM     s   € ÷ 	ñ 	˜3ð 	 3ñ 	r.   c                óH   € \        V \        4      '       g   \        R 4      hV # )z%Query dictionary keys must be stringsr@   )r=   s   &r+   r0   Ú"URL._str_dict.<locals>._assert_str  s    € Ü˜a¤×%Ò%ÜÐ GÓHÐHØˆHr.   )r   Ú
EMPTY_DICTr   rA   r\   r   ÚitemsÚimmutabledict)r4   rI   r0   Ú
dict_itemsÚkeyÚvaluerP   s   &&    @r+   r3   ÚURL._str_dictò   s½   ø€ ð Š=Ü—?‘?Ð"ä	ô	ó 
ð	ô 
ô	.ó 
ð	.÷	ð 	õ	ô �eœ_×5Ñ5×6Ò6Ø‰JàŸ™›ˆJä×!Ò!ñ
 #-ô	ñ #-‘J�Cñ ˜CÓ ¡-Øó#ò ñ #-ò	ó
ð 	
ùós   ÂB-
c               ó8   € V ^8„  d   QhRRRRRRRRRRRRR	R
RR/# )r'   r   r   r   r   r    r"   r!   r#   r%   z1Optional[Mapping[str, Union[Sequence[str], str]]]r(   r   r)   )r*   s   "r+   r,   r-   *  s[   € ÷ 3*ñ 3*à!ð3*ð  ð3*ð  ð	3*ð
 ð3*ð ð3*ð  ð3*ð Að3*ð 
ñ3*r.   c                óš   € / pVe   WR&   Ve   W(R&   Ve   W8R&   Ve   WHR&   Ve   WXR&   Ve   WhR&   Ve   WxR&   V P                   ! R/ VB # )	a…  return a new :class:`_engine.URL` object with modifications.

Values are used if they are non-None.  To set a value to ``None``
explicitly, use the :meth:`_engine.URL._replace` method adapted
from ``namedtuple``.

:param drivername: new drivername
:param username: new username
:param password: new password
:param host: new hostname
:param port: new port
:param query: new query parameters, passed a dict of string keys
 referring to string or sequence of string values.  Fully
 replaces the previous list of arguments.

:return: new :class:`_engine.URL` object.

.. versionadded:: 1.4

.. seealso::

    :meth:`_engine.URL.update_query_dict`

r   r   r   r    r"   r#   r%   r)   )Ú_assert_replace)	Úselfr   r   r   r    r"   r#   r%   Úkws	   &&&&&&&& r+   ÚsetÚURL.set*  sz   € ðF  ˆØÒ!Ø)ˆ|ÑØÒØ%ˆz‰NØÒØ%ˆz‰NØÒØˆv‰JØÒØˆv‰JØÒØ%ˆz‰NØÒØˆw‰Kà×#Ò#Ñ) bÑ)Ð)r.   c               ó    € V ^8„  d   QhRRRR/# )r'   rl   r   r(   r   r)   )r*   s   "r+   r,   r-   _  s   € ÷ #ñ # Cð #¨Cñ #r.   c                ó:  € RV9   d   V P                  VR,          R4       R F#  pW!9   g   K  V P                  W,          V4       K%  	  RV9   d   V P                  VR,          4       RV9   d   V P                  VR,          4      VR&   V P                  ! R/ VB # )z)argument checks before calling _replace()r   r"   r%   )r   r    r#   r)   )r0   r1   r2   r3   Ú_replace)rk   rl   Únames   &, r+   rj   ÚURL._assert_replace_  sŒ   € ð ˜2ÔØ×Ñ˜R Õ-¨|Ô<Û2ˆDØŽzØ×%Ñ% b¥h°Ö5ñ 3ð �RŒ<Ø×Ñ˜b �jÔ)Ø�bŒ=ØŸ.™.¨¨G­Ó5ˆBˆw‰Kà�}Š}Ñ"˜rÑ"Ð"r.   FÚkeep_blank_valuesc               ó(   € V ^8„  d   QhRRRRRRRR/# )r'   Úquery_stringr   ÚappendÚboolrt   r(   r   r)   )r*   s   "r+   r,   r-   n  s2   € ÷ /
ñ /
àð/
ð ð/
ð
  ð/
ð 
ñ/
r.   c               ó<   € V P                  \        WR7      VR7      # )a½  Return a new :class:`_engine.URL` object with the :attr:`_engine.URL.query`
parameter dictionary updated by the given query string.

E.g.::

    >>> from sqlalchemy.engine import make_url
    >>> url = make_url("postgresql+psycopg2://user:pass@host/dbname")
    >>> url = url.update_query_string(
    ...     "alt_host=host1&alt_host=host2&ssl_cipher=%2Fpath%2Fto%2Fcrt"
    ... )
    >>> str(url)
    'postgresql+psycopg2://user:pass@host/dbname?alt_host=host1&alt_host=host2&ssl_cipher=%2Fpath%2Fto%2Fcrt'

:param query_string: a URL escaped query string, not including the
 question mark.

:param append: if True, parameters in the existing query string will
 not be removed; new parameters will be in addition to those present.
 If left at its default of False, keys present in the given query
 parameters will replace those of the existing query string.

:param keep_blank_values: if True, parameters with blank values
 such as ``key=`` are retained in the query dictionary as empty
 strings.  If left at its default of False, parameters with blank
 values are omitted.

 .. versionadded:: 2.1.6

.. versionadded:: 1.4

.. seealso::

    :attr:`_engine.URL.query`

    :meth:`_engine.URL.update_query_dict`

©rt   ©rw   )Úupdate_query_pairsr   )rk   rv   rw   rt   s   &&&$r+   Úupdate_query_stringÚURL.update_query_stringn  s(   € ðX ×&Ñ&Ü�lÔHØð 'ó 
ð 	
r.   c               ó$   € V ^8„  d   QhRRRRRR/# )r'   Úkey_value_pairsz/Iterable[Tuple[str, Union[str, Sequence[str]]]]rw   rx   r(   r   r)   )r*   s   "r+   r,   r-   Ÿ  s-   € ÷ `)ñ `)àHð`)ð ð`)ð 
ñ	`)r.   c                óÎ  € V P                   p/ pV F}  w  rVWT9   dH   \        P                  ! WE,          4      pVP                  \        P                  ! V4      4       WtV&   KR  \	        V\
        \        34      '       d   \        V4      MTWE&   K  	  V'       d§   / pV F]  p	W“9   dK   \        \        P                  ! W9,          4      \        P                  ! WI,          4      ,           4      W‰&   KS  WI,          W‰&   K_  	  TP                  \        V4      P                  V4       U	u/ uF  p	W“V	,          bK  	  up	4       M/ V P                   CVCpV P                  VR7      # u up	i )a†  Return a new :class:`_engine.URL` object with the
:attr:`_engine.URL.query`
parameter dictionary updated by the given sequence of key/value pairs

E.g.::

    >>> from sqlalchemy.engine import make_url
    >>> url = make_url("postgresql+psycopg2://user:pass@host/dbname")
    >>> url = url.update_query_pairs(
    ...     [
    ...         ("alt_host", "host1"),
    ...         ("alt_host", "host2"),
    ...         ("ssl_cipher", "/path/to/crt"),
    ...     ]
    ... )
    >>> str(url)
    'postgresql+psycopg2://user:pass@host/dbname?alt_host=host1&alt_host=host2&ssl_cipher=%2Fpath%2Fto%2Fcrt'

A value may also be given as a sequence of strings, which is
equivalent to passing the same key once for each string; the
above example may also be expressed as::

    >>> url = make_url("postgresql+psycopg2://user:pass@host/dbname")
    >>> url = url.update_query_pairs(
    ...     [
    ...         ("alt_host", ["host1", "host2"]),
    ...         ("ssl_cipher", "/path/to/crt"),
    ...     ]
    ... )
    >>> str(url)
    'postgresql+psycopg2://user:pass@host/dbname?alt_host=host1&alt_host=host2&ssl_cipher=%2Fpath%2Fto%2Fcrt'

:param key_value_pairs: A sequence of tuples, each containing a
 string key and a value that is either a string or a sequence of
 strings.  A key may appear more than once, in which case all of
 its values are combined in the order given.

:param append: if True, parameters in the existing query string will
 not be removed; new parameters will be in addition to those present.
 If left at its default of False, keys present in the given query
 parameters will replace those of the existing query string.

.. versionadded:: 1.4

.. versionchanged:: 2.0.58, 2.1.9  A value may be given as a sequence
   of strings, including for a key that appears more than once.

.. seealso::

    :attr:`_engine.URL.query`

    :meth:`_engine.URL.difference_update_query`

    :meth:`_engine.URL.set`

)r%   )
r%   r   Úto_listÚextendrA   Úlistr]   Úupdaterm   Ú
difference)
rk   r€   rw   Úexisting_queryÚnew_keysre   rf   Úcurrent_as_listÚ	new_queryÚks
   &&&       r+   r|   ÚURL.update_query_pairsŸ  s7  € ð| Ÿ™ˆØ9;ˆã)‰JˆCØŒÜ"&§,¢,¨x­}Ó"=�Ø×&Ñ&¤t§|¢|°EÓ':Ô;Ø /˜“ô $.¨e´d¼E°]×#CÒ#C”D˜”KÈð “ñ *÷ ØˆIã�ØÔ&Ü#(ÜŸš ^Õ%6Ó7ÜŸ,š, x¥{Ó3õ4ó$�I“Lð
 $,¥;�I“Lñ ð ×Ñô ! Ó0×;Ñ;¸HÔEóáE˜ð  aÕ(Ò(ÙEñõð 3˜4Ÿ:™:Ð2¨Ð2ˆIØ�x‰x˜iˆxÓ(Ð(ùòs   Ä&E"c               ó$   € V ^8„  d   QhRRRRRR/# )r'   Úquery_parametersz'Mapping[str, Union[str, Sequence[str]]]rw   rx   r(   r   r)   )r*   s   "r+   r,   r-     s-   € ÷ 1Pñ 1PàAð1Pð ð1Pð 
ñ	1Pr.   c                óD   € V P                  VP                  4       VR7      # )a  Return a new :class:`_engine.URL` object with the
:attr:`_engine.URL.query` parameter dictionary updated by the given
dictionary.

The dictionary typically contains string keys and string values.
In order to represent a query parameter that is expressed multiple
times, pass a sequence of string values.

E.g.::


    >>> from sqlalchemy.engine import make_url
    >>> url = make_url("postgresql+psycopg2://user:pass@host/dbname")
    >>> url = url.update_query_dict(
    ...     {"alt_host": ["host1", "host2"], "ssl_cipher": "/path/to/crt"}
    ... )
    >>> str(url)
    'postgresql+psycopg2://user:pass@host/dbname?alt_host=host1&alt_host=host2&ssl_cipher=%2Fpath%2Fto%2Fcrt'


:param query_parameters: A dictionary with string keys and values
 that are either strings, or sequences of strings.

:param append: if True, parameters in the existing query string will
 not be removed; new parameters will be in addition to those present.
 If left at its default of False, keys present in the given query
 parameters will replace those of the existing query string.


.. versionadded:: 1.4

.. seealso::

    :attr:`_engine.URL.query`

    :meth:`_engine.URL.update_query_string`

    :meth:`_engine.URL.update_query_pairs`

    :meth:`_engine.URL.difference_update_query`

    :meth:`_engine.URL.set`

r{   )r|   rb   )rk   rŽ   rw   s   &&&r+   Úupdate_query_dictÚURL.update_query_dict  s%   € ðb ×&Ñ&Ð'7×'=Ñ'=Ó'?ÈÐ&ÓOÐOr.   c               ó    € V ^8„  d   QhRRRR/# )r'   ÚnameszIterable[str]r(   r   r)   )r*   s   "r+   r,   r-   4  s   € ÷ /
ñ /
¨]ð /
¸sñ /
r.   c                ó°  € \        V4      pVP                  V P                  4      '       g   V # \        V P                  V P
                  V P                  V P                  V P                  V P                  \        P                  ! \        V P                  4      P                  V4       Uu/ uF  pW P                  V,          bK  	  up4      4      # u upi )a
  
Remove the given names from the :attr:`_engine.URL.query` dictionary,
returning the new :class:`_engine.URL`.

E.g.::

    url = url.difference_update_query(["foo", "bar"])

Equivalent to using :meth:`_engine.URL.set` as follows::

    url = url.set(
        query={
            key: url.query[key]
            for key in set(url.query).difference(["foo", "bar"])
        }
    )

.. versionadded:: 1.4

.. seealso::

    :attr:`_engine.URL.query`

    :meth:`_engine.URL.update_query_dict`

    :meth:`_engine.URL.set`

)rm   Úintersectionr%   r   r   r   r   r    r"   r#   r   rc   r†   )rk   r“   re   s   && r+   Údifference_update_queryÚURL.difference_update_query4  s¬   € ô< �E“
ˆØ×!Ñ! $§*¡*×-Ò-ØˆKäØ�O‰OØ�M‰MØ�M‰MØ�I‰IØ�I‰IØ�M‰MÜ×Òô  # 4§:¡:›×9Ñ9¸%Ô@óá@˜ð Ÿ™ C�Ò(Ù@ñóó
ð 	
ùòs   Â,Cc               ó   € V ^8„  d   QhRR/# )r'   r(   zMapping[str, Sequence[str]]r)   )r*   s   "r+   r,   r-   f  s   € ÷ 
ñ 
Ð"=ñ 
r.   c                óÆ   € \         P                  ! V P                  P                  4        UUu/ uF!  w  rT\	        V\
        4      '       g   V3MTbK#  	  upp4      # u uppi )až  Return the :attr:`_engine.URL.query` dictionary with values normalized
into sequences.

As the :attr:`_engine.URL.query` dictionary may contain either
string values or sequences of string values to differentiate between
parameters that are specified multiple times in the query string,
code that needs to handle multiple parameters generically will wish
to use this attribute so that all parameters present are presented
as sequences.   Inspiration is from Python's ``urllib.parse.parse_qs``
function.  E.g.::


    >>> from sqlalchemy.engine import make_url
    >>> url = make_url(
    ...     "postgresql+psycopg2://user:pass@host/dbname?alt_host=host1&alt_host=host2&ssl_cipher=%2Fpath%2Fto%2Fcrt"
    ... )
    >>> url.query
    immutabledict({'alt_host': ('host1', 'host2'), 'ssl_cipher': '/path/to/crt'})
    >>> url.normalized_query
    immutabledict({'alt_host': ('host1', 'host2'), 'ssl_cipher': ('/path/to/crt',)})

)r   rc   r%   rb   rA   r]   )rk   r‹   r=   s   &  r+   Únormalized_queryÚURL.normalized_querye  s]   € ô2 ×!Ò!ð !ŸJ™J×,Ñ,Ô.ôá.‘D�Að œz¨!¬U×3Ò3�A‘4¸Ò:Ù.òó
ð 	
ùós   ®'A
ú1.4zŸThe :meth:`_engine.URL.__to_string__ method is deprecated and will be removed in a future release.  Please use the :meth:`_engine.URL.render_as_string` method.c               ó    € V ^8„  d   QhRRRR/# ©r'   Úhide_passwordrx   r(   r   r)   )r*   s   "r+   r,   r-   ‹  s   € ÷ Bñ B¨4ð B¸3ñ Br.   c                ó&   € V P                  VR7      # )z§Render this :class:`_engine.URL` object as a string.

:param hide_password: Defaults to True.   The password is not shown
 in the string unless this is set to False.

)rŸ   ©Úrender_as_string)rk   rŸ   s   &&r+   Ú__to_string__ÚURL.__to_string__…  s   € ð ×$Ñ$°=Ð$ÓAÐAr.   c               ó    € V ^8„  d   QhRRRR/# rž   r)   )r*   s   "r+   r,   r-   ”  s   € ÷ %ñ %¨dð %¸cñ %r.   c                ó@  a € S P                   R,           pS P                  en   V\        S P                  RR7      ,          pS P                  e9   TRV'       d   RM\        \	        S P                  4      RR7      ,           ,          pVR,          pS P
                  e=   RS P
                  9   d   VRS P
                   R2,          pMVS P
                  ,          pS P                  e$   VR\	        S P                  4      ,           ,          pS P                  e&   VR	\        S P                  R
R7      ,           ,          pS P                  '       dO   \        S P                  4      pVP                  4        VRRP                  V 3R lV 4       4      ,           ,          pV# )a*  Render this :class:`_engine.URL` object as a string.

This method is used when the ``__str__()`` or ``__repr__()``
methods are used.   The method directly includes additional options.

:param hide_password: Defaults to True.   The password is not shown
 in the string unless this is set to False.

z://z +)ÚsafeÚ:z***Ú@Ú[Ú]Ú/z +/Ú?Ú&c              3  ó²   <"  € T FL  p\         P                  ! SP                  V,          4       F  p\        V4       R \        V4       2x € K   	  KN  	  R# 5i)Ú=N)r   r‚   r%   r   )rX   r‹   Úelementrk   s   &  €r+   rZ   Ú'URL.render_as_string.<locals>.<genexpr>´  sK   øé € ð  á�AÜ#Ÿ|š|¨D¯J©J°q­MÖ:�Gô ˜a“=�/ ¤:¨gÓ#6Ð"7Õ8á:ñ 9Ûùs   ƒAA)r   r   r   r   r   r    r"   r#   r%   r„   ÚsortÚjoin)rk   rŸ   ÚsÚkeyss   f&  r+   r¢   ÚURL.render_as_string”  sB  ø€ ð �O‰O˜eÕ#ˆØ�=‰=Ò$Ø”�t—}‘}¨4Ô0Õ0ˆAØ�}‰}Ò(Ø�Sç$ñ äœs 4§=¡=Ó1¸Ô=õõ �ð
 ��HˆAØ�9‰9Ò Ø�d—i‘iÔØ�q˜Ÿ™˜ 1Ð%Õ%‘à�T—Y‘Y•�Ø�9‰9Ò Ø�”s˜4Ÿ9™9“~Õ%Õ%ˆAØ�=‰=Ò$Ø�”u˜TŸ]™]°Ô7Õ7Õ7ˆAØ�:�:ˆ:Ü˜Ÿ
™
Ó#ˆDØ�I‰IŒKØ��s—x‘xô  áó ó õ õ ˆAð
 ˆr.   c               ó   € V ^8„  d   QhRR/# ©r'   r(   r   r)   )r*   s   "r+   r,   r-   »  s   € ÷ 'ñ '˜#ñ 'r.   c                	ó"   € V P                  4       # rF   r¡   ©rk   s   &r+   Ú__repr__ÚURL.__repr__»  s   € Ø×$Ñ$Ó&Ð&r.   c               ó   € V ^8„  d   QhRR/# )r'   r(   r   r)   )r*   s   "r+   r,   r-   ¾  s   € ÷ 
ñ 
˜#ñ 
r.   c           	     	óÐ   € V P                   P                  V P                  V P                  V P                  V P
                  V P                  V P                  V P                  4      # rF   )	Ú	__class__r5   r   r   r   r    r"   r#   r%   r»   s   &r+   Ú__copy__ÚURL.__copy__¾  sL   € Ø�~‰~×$Ñ$Ø�O‰OØ�M‰MØ�M‰MØ�I‰IØ�I‰IØ�M‰Mð �J‰Jó

ð 
	
r.   c               ó    € V ^8„  d   QhRRRR/# )r'   Úmemor   r(   r   r)   )r*   s   "r+   r,   r-   Ë  s   € ÷ ñ  ð ¨ñ r.   c                	ó"   € V P                  4       # rF   )rÁ   )rk   rÄ   s   &&r+   Ú__deepcopy__ÚURL.__deepcopy__Ë  s   € Ø�}‰}‹Ðr.   c               ó   € V ^8„  d   QhRR/# )r'   r(   r9   r)   )r*   s   "r+   r,   r-   Î  s   € ÷ ñ ˜#ñ r.   c                	ó*   € \        \        V 4      4      # rF   )Úhashr   r»   s   &r+   Ú__hash__ÚURL.__hash__Î  s   € Ü”C˜“I‹Ðr.   c               ó    € V ^8„  d   QhRRRR/# ©r'   Úotherr   r(   rx   r)   )r*   s   "r+   r,   r-   Ñ  s   € ÷ 

ñ 

˜Cð 

 Dñ 

r.   c                	óð  € \        V\        4      ;'       dà    V P                  VP                  8H  ;'       d¿    V P                  VP                  8H  ;'       dž    V P                  VP                  8H  ;'       d}    V P
                  VP
                  8H  ;'       d\    V P                  VP                  8H  ;'       d;    V P                  VP                  8H  ;'       d    V P                  VP                  8H  # rF   )	rA   r   r   r   r   r    r#   r%   r"   ©rk   rÏ   s   &&r+   Ú__eq__Ú
URL.__eq__Ñ  sÓ   € ä�uœcÓ"÷ (ð (Ø—‘ 5×#3Ñ#3Ñ3÷(ð (à—‘ §¡Ñ/÷(ð (ð —‘ §¡Ñ/÷(ð (ð —	‘	˜UŸZ™ZÑ'÷	(ð (ð
 —‘ §¡Ñ/÷(ð (ð —
‘
˜eŸk™kÑ)÷(ð (ð —	‘	˜UŸZ™ZÑ'ð		
r.   c               ó    € V ^8„  d   QhRRRR/# rÎ   r)   )r*   s   "r+   r,   r-   Ý  s   € ÷ !ñ !˜Cð ! Dñ !r.   c                	ó   € W8X  * # rF   r)   rÑ   s   &&r+   Ú__ne__Ú
URL.__ne__Ý  s   € ØÒ Ð r.   c               ó   € V ^8„  d   QhRR/# r¹   r)   )r*   s   "r+   r,   r-   à  s   € ÷ 1ñ 1 #ñ 1r.   c                ó€   € RV P                   9  d   V P                   # V P                   P                  R4      ^ ,          # )z¼Return the backend name.

This is the name that corresponds to the database backend in
use, and is the portion of the :attr:`_engine.URL.drivername`
that is to the left of the plus sign.

Ú+)r   Úsplitr»   s   &r+   Úget_backend_nameÚURL.get_backend_nameà  s4   € ð �d—o‘oÔ%Ø—?‘?Ð"à—?‘?×(Ñ(¨Ó-¨aÕ0Ð0r.   c               ó   € V ^8„  d   QhRR/# r¹   r)   )r*   s   "r+   r,   r-   í  s   € ÷ 1ñ 1 ñ 1r.   c                óœ   € RV P                   9  d   V P                  4       P                  # V P                   P                  R4      ^,          # )as  Return the backend name.

This is the name that corresponds to the DBAPI driver in
use, and is the portion of the :attr:`_engine.URL.drivername`
that is to the right of the plus sign.

If the :attr:`_engine.URL.drivername` does not include a plus sign,
then the default :class:`_engine.Dialect` for this :class:`_engine.URL`
is imported in order to get the driver name.

rÚ   )r   Úget_dialectÚdriverrÛ   r»   s   &r+   Úget_driver_nameÚURL.get_driver_nameí  s?   € ð �d—o‘oÔ%Ø×#Ñ#Ó%×,Ñ,Ð,à—?‘?×(Ñ(¨Ó-¨aÕ0Ð0r.   c               ó    € V ^8„  d   QhRRRR/# )r'   ÚkwargszMapping[str, Any]r(   z%Tuple[URL, List[Any], Dict[str, Any]]r)   )r*   s   "r+   r,   r-   ÿ  s   € ÷ )ñ )Ø'ð)à	.ñ)r.   c                	óž  € \         P                  ! V P                  P                  R R4      4      pW!P                  R. 4      ,          p\	        V4      pV Uu. uF  p\
        P                  ! V4      ! W4      NK!  	  ppV P                  R R.4      pV F  pVP                  V4      pVf   K  TpK  	  VP                  RR4       WTV3# u upi )Úpluginr   Nr)   )
r   r‚   r%   ÚgetÚdictr   Úloadr–   Ú
update_urlÚpop)rk   rå   Úplugin_namesÚplugin_nameÚloaded_pluginsÚurç   Únew_us   &&      r+   Ú_instantiate_pluginsÚURL._instantiate_pluginsÿ  sÉ   € ô —|’| D§J¡J§N¡N°8¸RÓ$@ÓAˆØŸ
™
 9¨bÓ1Õ1ˆä�f“ˆñ  ,ó
á+�ô �LŠL˜Ô% dÖ3Ù+ð 	ð 
ð
 ×(Ñ(¨(°IÐ)>Ó?ˆã$ˆFØ×%Ñ% aÓ(ˆEØÔ Ø’ñ %ð
 	�
‰
�9˜dÔ#à &Ð(Ð(ùò
s   Á%C
c               ó   € V ^8„  d   QhRR/# )r'   r(   úType[Dialect]r)   )r*   s   "r+   r,   r-     s   € ÷ .ñ . ñ .r.   c                óv  € RV P                   9  d   V P                   pMV P                   P                  RR4      p\        P                  ! V4      p\	        VR4      '       dM   \        VP                  \        4      '       d-   \        VP                  \        4      '       d   VP                  # \        RV4      # )z¢Return the "entry point" dialect class.

This is normally the dialect itself except in the case when the
returned class implements the get_dialect_cls() method.

rÚ   Ú.Údialectrõ   )r   Úreplacer   rê   ÚhasattrrA   rø   ÚtypeÚ
issubclassr   r   )rk   rr   r4   s   &  r+   Ú_get_entrypointÚURL._get_entrypoint  s…   € ð �d—o‘oÔ%Ø—?‘?‰Dà—?‘?×*Ñ*¨3°Ó4ˆDÜ�mŠm˜DÓ!ˆô
 �C˜×#Ò#Ü˜3Ÿ;™;¬×-Ò-Ü˜3Ÿ;™;¬×0Ò0à—;‘;Ðä˜¨Ó-Ð-r.   c               ó    € V ^8„  d   QhRRRR/# )r'   Ú	_is_asyncrx   r(   rõ   r)   )r*   s   "r+   r,   r-   /  s   € ÷ 
ñ 
 Tð 
°mñ 
r.   c                ó~   € V P                  4       pV'       d   VP                  V 4      pV# VP                  V 4      pV# )z_Return the SQLAlchemy :class:`_engine.Dialect` class corresponding
to this URL's driver name.

)rý   Úget_async_dialect_clsÚget_dialect_cls)rk   r   Ú
entrypointÚdialect_clss   &&  r+   rà   ÚURL.get_dialect/  sE   € ð
 ×)Ñ)Ó+ˆ
ßØ$×:Ñ:¸4Ó@ˆKð Ðð %×4Ñ4°TÓ:ˆKØÐr.   c               ó$   € V ^8„  d   QhRRRRRR/# )r'   r“   zOptional[List[str]]rl   r   r(   zDict[str, Any]r)   )r*   s   "r+   r,   r-   ;  s$   € ÷ 'ñ 'Ø(ð'Ø7:ð'à	ñ'r.   c                ó<  € Ve   \         P                  ! RR4       / p. ROpV Ft  pV'       d   VP                  ^ 4      pMWR9   d
   W%,          pMTpVf   K4  \        WR4      '       g   KH  VR8X  d   \	        \        W4      4      W6&   Kg  \        W4      W6&   Kv  	  V# )aò  Translate url attributes into a dictionary of connection arguments.

Returns attributes of this url (`host`, `database`, `username`,
`password`, `port`) as a plain dictionary.  The attribute names are
used as the keys by default.  Unset or false attributes are omitted
from the final dictionary.

:param \**kw: Optional, alternate key names for url attributes.

:param names: Deprecated.  Same purpose as the keyword-based alternate
    names, but correlates the name to the original positionally.
zpThe `URL.translate_connect_args.name`s parameter is deprecated. Please pass the alternate names as kw arguments.rœ   r   F)r    r#   r   r   r"   )r   Úwarn_deprecatedrì   Úgetattrr   )rk   r“   rl   Ú
translatedÚattribute_namesÚsnamerr   s   &&,    r+   Útranslate_connect_argsÚURL.translate_connect_args;  sš   € ð  ÒÜ× Ò ð3ð ô	ð ˆ
ÚNˆÛ$ˆEßØ—y‘y “|‘Ø”Ø•y‘à�ØÔ¤G¨D¸×$?Ô$?Ø˜JÔ&Ü'*¬7°4Ó+?Ó'@�JÓ$ä'.¨tÓ';�JÓ$ñ %ð Ðr.   r)   )NNNNNNN©F)TrF   )&Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Ú__annotations__Úclassmethodr   ra   r5   r2   r0   r1   r3   rm   rj   r}   r|   r�   r–   Úpropertyrš   Ú
deprecatedr£   r¢   r¼   rÁ   rÆ   rË   rÒ   rÖ   rÜ   râ   rò   rý   rà   r  Ú__static_attributes__r)   r.   r+   r   r   .   sŒ  ‡ ñ0ðd ƒOðð
 ÓØàÓð/ð Óðð ÓØàÓØà?Ó?ðð> ð #'Ø"&Ø"Ø"Ø"&Ø9=¿¹ö?
ó ð?
ðB ôHó ðHð ôó ðð
 ô-ó ð-ð ô5
ó ð5
÷n3*õj#ñ/
ð
 #(÷/
ð /
÷b`)÷D1Põf/
ðb ô
ó ð
ð> 
‡_‚_Øð	7óöBóðB÷%õN'õ
õõõ

õ!õ1õ1õ$)õ0.÷0
÷'ó 'r.   r   rt   Fc               ó$   € V ^8„  d   QhRRRRRR/# )r'   Úname_or_urlzUnion[str, URL]rt   rx   r(   r   r)   )r*   s   "r+   r,   r,   e  s$   € ÷ *ñ *Ø ð*Ø8<ð*àñ*r.   c               óÎ   € \        V \        4      '       d   \        WR7      # \        V \        4      '       g-   \	        V R4      '       g   \
        P                  ! RV : 24      hV # )aÕ  Given a string, produce a new URL instance.

The format of the URL generally follows `RFC-1738
<https://www.ietf.org/rfc/rfc1738.txt>`_, with some exceptions, including
that underscores, and not dashes or periods, are accepted within the
"scheme" portion.

If a :class:`.URL` object is passed, it is returned as is.

:param name_or_url: a string URL or :class:`.URL` object.

:param keep_blank_values: if True, query string parameters with blank
 values such as ``key=`` are retained in the :attr:`.URL.query`
 dictionary as empty strings.  If left at its default of False,
 parameters with blank values are omitted.  Has no effect when a
 :class:`.URL` object is passed.

 As :func:`_sa.create_engine` parses string URLs using the default
 setting, a string URL with blank values to be retained should be
 parsed with :func:`.make_url` first, and the resulting :class:`.URL`
 passed to :func:`_sa.create_engine`.

 .. versionadded:: 2.1.6

.. seealso::

    :ref:`database_urls`

rz   Ú)_sqla_is_testing_if_this_is_a_mock_objectz#Expected string or URL object, got )rA   r   Ú
_parse_urlr   rú   r   ÚArgumentError)r  rt   s   &$r+   Úmake_urlr!  e  sc   € ôB �+œs×#Ò#Ü˜+ÔKÐKÜ˜¤S×)Ò)´'ØÐ@÷3ò 3ô ×ÒØ1°+±ÐAó
ð 	
ð Ðr.   c               ó$   € V ^8„  d   QhRRRRRR/# )r'   rr   r   rt   rx   r(   r   r)   )r*   s   "r+   r,   r,   ’  s!   € ÷ 9
ñ 9
�Sð 9
¨Tð 9
¸cñ 9
r.   c                ó  € \         P                  ! R \         P                  4      pVP                  V 4      pVEe2   VP	                  4       pVR,          el   / p\        VR,          VR7       FP  w  rgWe9   dB   \        P                  ! WV,          4      WV&   \        RWV,          4      P                  V4       KL  WuV&   KR  	  MRpWTR&   R F"  pWH,          f   K  \        WH,          4      WH&   K$  	  VP                  R4      p	VP                  R4      p
T	;'       g    T
VR&   VP                  R4      p VR	,          '       d   \        VR	,          4      VR	&   \        P                  ! V 3/ VB # \        P                   ! R
4      h)a®  
            (?P<name>[\w\+]+)://
            (?:
                (?P<username>[^:/]*)
                (?::(?P<password>[^@]*))?
            @)?
            (?:
                (?:
                    \[(?P<ipv6host>[^/\?]+)\] |
                    (?P<ipv4host>[^/:\?]+)
                )?
                (?::(?P<port>[^/\?]*))?
            )?
            (?:/(?P<database>[^\?]*))?
            (?:\?(?P<query>.*))?
            Nr%   rz   z	List[str]Úipv4hostÚipv6hostr    rr   r"   z4Could not parse SQLAlchemy URL from given URL string)r   r   r#   )ÚreÚcompileÚXÚmatchÚ	groupdictr   r   r‚   r   rw   r   rì   r9   r   r5   r   r   )rr   rt   ÚpatternÚmÚ
componentsr%   re   rf   Úcompr$  r%  s   &&         r+   r  r  ’  s\  € Ü�jŠjð	ô  	�‰ó#€Gð( 	�‰�dÓ€AØƒ}Ø—[‘[“]ˆ
à�gÕÒ*ØˆEä'Ø˜7Õ#Ð7H÷‘
�ð ”<Ü!%§¢¨e­jÓ!9�E‘JÜ˜ e¥jÓ1×8Ñ8¸Ö?à!&˜#“Jòð ˆEØ#�7Ñã6ˆDØÕÔ+Ü#*¨:Õ+;Ó#<�
Ó ñ 7ð —>‘> *Ó-ˆØ—>‘> *Ó-ˆØ%×1Ð1¨ˆ
�6ÑØ�~‰~˜fÓ%ˆà�f×ÔÜ!$ Z°Õ%7Ó!8ˆJ�vÑä�zŠz˜$Ñ- *Ñ-Ð-ô ×ÒØBó
ð 	
r.   r  )%r  Ú
__future__r   Úcollections.abcÚabcr\   r&  Útypingr   r   r   r   r   r   r	   r
   r   r   r   r   r   Úurllib.parser   r   r   r   Ú
interfacesr   Ú r   r   Údialectsr   r   r   r!  r  r)   r.   r+   Ú<module>r7     s~   ðñõ #å )Û 	Ý Ý Ý Ý Ý Ý Ý Ý Ý Ý Ý Ý Ý Ý "Ý Ý #Ý  å Ý Ý Ý Ý ôtˆ*ô tðn*Ø?D÷*÷Z9
ñ 9
r.   