Ë
    îÍ:jÙ£  ã                   ó6  — d Z ddlZddlZddlZddlZddlZddlmZmZm	Z	 ddl
mZmZ ddlmZmZmZ ddlmZmZmZ ddlmZ ddlmZmZ dd	lmZmZmZmZ ddlZ d
dl!m"Z" ddl#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) i Z* e"jV                  e,«      Z- e'«       r
ddl.Z.d
dl/m0Z0 d„ Z1d„ Z2d„ Z3d„ Z4d„ Z5d„ Z6d„ Z7d„ Z8d„ Z9d„ Z:d„ Z;d„ Z<d„ Z=d„ Z>d„ Z?d„ Z@d„ ZAd „ ZBd!„ ZCd"„ ZDd#„ ZEd$„ ZF G d%„ d&e«      ZG e'«       r_ddlHm!c mIZJ d'eGd(eKeLe   d)f   fd*„ZM	 dcd+ee   d,d)d(eGfd-„ZN eJjž                  eGeM eeNeG¬.«      eGj                   › d/eGjX                  › �¬0«        G d1„ d2eQe«      ZR G d3„ d4eR«      ZS G d5„ d6eR«      ZT G d7„ d8«      ZUd9„ ZVd:„ ZWddd;ed<eQd=eQfd>„ZXeded@eYfdA„«       ZZdcdB„Z[dC„ Z\dcdD„Z]dE„ Z^dF„ Z_dG„ Z`dH„ ZadI„ ZbdcdJeeL   fdK„Zc G dL„ dMed?¬N«      ZddOeeeQef   d(eYfdP„ZfdQeQd(eYfdR„ZgdSdTdUeQdVefdW„ZhdSdTdUeQfdX„ZidY„ Zje e)dZ¬[«       G d\„ d]«      «       «       Zkdcd^d_œd`„Zl G da„ dbe«      Zmy)fz
Generic utilities
é    N)ÚOrderedDictÚUserDictÚdefaultdict)ÚIterableÚMutableMapping)ÚAbstractContextManagerÚ	ExitStackÚcontextmanager)Ú	dataclassÚfieldsÚis_dataclass)ÚEnum)ÚpartialÚwraps)ÚAnyÚCallableÚOptionalÚ	TypedDicté   )Úloggingé   )Úis_flax_availableÚis_mlx_availableÚis_tf_availableÚis_torch_availableÚis_torch_fx_proxyÚrequires)Úmodel_addition_debugger_contextc                 óR   — | j                  «       } | dv ry| dv ryt        d| ›�«      ‚)zïConvert a string representation of truth to true (1) or false (0).

    True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values are 'n', 'no', 'f', 'false', 'off', and '0'.
    Raises ValueError if 'val' is anything else.
    >   Ú1ÚtÚyÚonÚyesÚtruer   >   Ú0ÚfÚnÚnoÚoffÚfalser   zinvalid truth value )ÚlowerÚ
ValueError)Úvals    úo/home/mcse/projects/srt_converter/srt-converter-venv/lib/python3.12/site-packages/transformers/utils/generic.pyÚ	strtoboolr0   9   s:   € ð �)‰)‹+€CØ
Ð2Ñ2ØØ
Ð3Ñ3ØÜ
Ð+¨C¨7Ð3Ó
4Ð4ó    c                 óà   — t        t        | «      «      }|j                  d«      ry|j                  d«      ry|j                  d«      ry|j                  d«      ry|j                  d	«      ry
y)zÃ
    Tries to guess the framework of an object `x` from its repr (brittle but will help in `is_tensor` to try the
    frameworks in a smart order, without the need to import the frameworks).
    z<class 'torch.Úptz<class 'tensorflow.Útfz<class 'jaxÚjaxz<class 'numpy.Únpz<class 'mlx.ÚmlxN)ÚstrÚtypeÚ
startswith)ÚxÚrepresentations     r/   Úinfer_framework_from_reprr=   G   sn   € ô
 œ˜a›“\€NØ× Ñ Ð!1Ô2ØØ	×	"Ñ	"Ð#8Ô	9ØØ	×	"Ñ	" =Ô	1ØØ	×	"Ñ	"Ð#3Ô	4ØØ	×	"Ñ	" >Ô	2Øð 
3r1   c                 ó  — t         t        t        t        t        dœ}t        | «      }|€g n|g}|dk7  r|j                  d«       |j                  |D �cg c]  }||dfvsŒ
|‘Œ c}«       |D �ci c]  }|||   “Œ
 c}S c c}w c c}w )z¿
    Returns an (ordered since we are in Python 3.7+) dictionary framework to test function, which places the framework
    we can guess from the repr first, then Numpy, then the others.
    )r3   r4   r5   r6   r7   r6   )Úis_torch_tensorÚis_tf_tensorÚis_jax_tensorÚis_numpy_arrayÚis_mlx_arrayr=   ÚappendÚextend)r;   Úframework_to_testÚpreferred_frameworkÚ
frameworksr'   s        r/   Ú_get_frameworks_and_test_funcrI   Y   s›   € ô ÜÜÜÜñÐô 4°AÓ6Ðà*Ð2‘Ð9LÐ8M€JØ˜dÒ"Ø×Ñ˜$ÔØ×ÑÐ"3Ö\˜Q°qÐATÐVZÐ@[Ò7[’qÒ\Ô]Ø-7Ö8¨ˆAÐ  Ñ#Ñ#Ò8Ð8ùò ]ùÚ8s   ÁA?Á A?Á/Bc                 óª   — t        | «      }|j                  «       D ]  } || «      sŒ y t        | «      ryt        «       rddlm} t        | |«      ryy)z°
    Tests if `x` is a `torch.Tensor`, `tf.Tensor`, `jaxlib.xla_extension.DeviceArray`, `np.ndarray` or `mlx.array`
    in the order defined by `infer_framework_from_repr`
    Tr   )ÚTracerF)rI   Úvaluesr   r   Újax.corerK   Ú
isinstance)r;   Úframework_to_test_funcÚ	test_funcrK   s       r/   Ú	is_tensorrQ   n   sW   € ô ;¸1Ó=ÐØ+×2Ñ2Ó4ò ˆ	Ù�Q�<Ùðô
 ˜ÔØäÔÝ#ä�a˜Ô Øàr1   c                 ó6   — t        | t        j                  «      S ©N)rN   r6   Úndarray©r;   s    r/   Ú	_is_numpyrV   †   s   € Ü�aœŸ™Ó$Ð$r1   c                 ó   — t        | «      S )z/
    Tests if `x` is a numpy array or not.
    )rV   rU   s    r/   rB   rB   Š   s   € ô �Q‹<Ðr1   c                 ó6   — dd l }t        | |j                  «      S ©Nr   )ÚtorchrN   ÚTensor©r;   rZ   s     r/   Ú	_is_torchr]   ‘   ó   € Ûä�a˜Ÿ™Ó&Ð&r1   c                 ó0   — t        «       sdS t        | «      S )z]
    Tests if `x` is a torch tensor or not. Safe to call even if torch is not installed.
    F)r   r]   rU   s    r/   r?   r?   —   s   € ô +Ô,ˆ5Ð>´)¸A³,Ð>r1   c                 ó6   — dd l }t        | |j                  «      S rY   )rZ   rN   Údevicer\   s     r/   Ú_is_torch_devicerb   ž   r^   r1   c                 ó0   — t        «       sdS t        | «      S )z]
    Tests if `x` is a torch device or not. Safe to call even if torch is not installed.
    F)r   rb   rU   s    r/   Úis_torch_devicerd   ¤   s   € ô +Ô,ˆ5ÐEÔ2BÀ1Ó2EÐEr1   c                 óŠ   — dd l }t        | t        «      rt        || «      rt	        || «      } nyt        | |j
                  «      S )Nr   F)rZ   rN   r8   ÚhasattrÚgetattrÚdtyper\   s     r/   Ú_is_torch_dtyperi   «   s9   € Ûä�!”SÔÜ�5˜!ÔÜ˜˜qÓ!‰AàÜ�a˜Ÿ™Ó%Ð%r1   c                 ó0   — t        «       sdS t        | «      S )z\
    Tests if `x` is a torch dtype or not. Safe to call even if torch is not installed.
    F)r   ri   rU   s    r/   Úis_torch_dtyperk   ¶   s   € ô +Ô,ˆ5ÐD´/À!Ó2DÐDr1   c                 ó6   — dd l }t        | |j                  «      S rY   )Ú
tensorflowrN   r[   ©r;   r4   s     r/   Ú_is_tensorflowro   ½   s   € Ûä�a˜Ÿ™Ó#Ð#r1   c                 ó0   — t        «       sdS t        | «      S )zg
    Tests if `x` is a tensorflow tensor or not. Safe to call even if tensorflow is not installed.
    F)r   ro   rU   s    r/   r@   r@   Ã   s   € ô (Ô)ˆ5Ð@¬~¸aÓ/@Ð@r1   c                 óp   — dd l }t        |d«      r|j                  | «      S t        | |j                  «      S )Nr   Úis_symbolic_tensor)rm   rf   rr   rN   r[   rn   s     r/   Ú_is_tf_symbolic_tensorrs   Ê   s4   € Ûô ˆrÐ'Ô(Ø×$Ñ$ QÓ'Ð'Ü�a˜Ÿ™Ó#Ð#r1   c                 ó0   — t        «       sdS t        | «      S )z„
    Tests if `x` is a tensorflow symbolic tensor or not (ie. not eager). Safe to call even if tensorflow is not
    installed.
    F)r   rs   rU   s    r/   Úis_tf_symbolic_tensorru   Ó   s   € ô
 (Ô)ˆ5ÐHÔ/EÀaÓ/HÐHr1   c                 ó:   — dd l m} t        | |j                  «      S rY   )Ú	jax.numpyÚnumpyrN   rT   )r;   Újnps     r/   Ú_is_jaxrz   Û   s   € Ýä�a˜Ÿ™Ó%Ð%r1   c                 ó0   — t        «       sdS t        | «      S )zY
    Tests if `x` is a Jax tensor or not. Safe to call even if jax is not installed.
    F)r   rz   rU   s    r/   rA   rA   á   s   € ô *Ô+ˆ5Ð;´¸³Ð;r1   c                 ó:   — dd l m} t        | |j                  «      S rY   )Úmlx.coreÚcorerN   Úarray)r;   Úmxs     r/   Ú_is_mlxr�   è   s   € Ýä�a˜Ÿ™Ó"Ð"r1   c                 ó0   — t        «       sdS t        | «      S )zZ
    Tests if `x` is a mlx array or not. Safe to call even when mlx is not installed.
    F)r   r�   rU   s    r/   rC   rC   î   s   € ô )Ô*ˆ5Ð:´¸³
Ð:r1   c                 ó.  — t        | t        t        f«      r| S t        | t        t        f«      r-| j                  «       D ��ci c]  \  }}|t        |«      “Œ c}}S t        | t        t        f«      rœ	 t        j                  | «      }t        j                  |j                  t        j                  «      s.t        j                  |j                  t        j                  «      r|j                  «       S 	 | D �cg c]  }t        |«      ‘Œ c}S d„ d„ d„ d„ dœ}t#        | «      }|j                  «       D ]  \  }} || «      sŒ ||   | «      c S  t        | t        j$                  «      r| j                  «       S | S c c}}w # t         $ r Y Œ™w xY wc c}w )zc
    Convert a TensorFlow tensor, PyTorch tensor, Numpy array or python list to a python list.
    c                 ó"   — | j                  «       S rS   ©Útolist©Úobjs    r/   ú<lambda>zto_py_obj.<locals>.<lambda>  ó   € ˜#Ÿ*™*›,€ r1   c                 ó>   — | j                  «       j                  «       S rS   )rx   r†   r‡   s    r/   r‰   zto_py_obj.<locals>.<lambda>  s   € ˜#Ÿ)™)›+×,Ñ,Ó.€ r1   c                 óH   — t        j                  | «      j                  «       S rS   )r6   Úasarrayr†   r‡   s    r/   r‰   zto_py_obj.<locals>.<lambda>	  s   € œ2Ÿ:™: c›?×1Ñ1Ó3€ r1   c                 ó"   — | j                  «       S rS   r…   r‡   s    r/   r‰   zto_py_obj.<locals>.<lambda>
  rŠ   r1   ©r3   r4   r5   r6   )rN   ÚintÚfloatÚdictr   ÚitemsÚ	to_py_objÚlistÚtupler6   r   Ú
issubdtyperh   ÚintegerÚfloatingr†   Ú	ExceptionrI   Únumber)	rˆ   ÚkÚvÚarrÚoÚframework_to_py_objrO   Ú	frameworkrP   s	            r/   r”   r”   õ   sV  € ô �#œœU�|Ô$Øˆ
Ü	�Cœ$¤Ð)Ô	*Ø,/¯I©I«K×8¡D A q�”9˜Q“<‘Ó8Ð8Ü	�Cœ$¤˜Ô	'ð	Ü—(‘(˜3“-ˆCÜ�}‰}˜SŸY™Y¬¯
©
Ô3´r·}±}ÀSÇYÁYÔPR×P[ÑP[Ô7\Ø—z‘z“|Ð#ð 8]ð '*Ö* ”	˜!•Ò*Ð*ñ 'Ù.Ù3Ù&ñ	Ðô ;¸3Ó?ÐØ 6× <Ñ <Ó >ò 7Ñˆ	�9Ù�S�>Ø1Ð& yÑ1°#Ó6Ò6ð7ô
 �#”r—y‘yÔ!Ø�z‰z‹|Ðàˆ
ùó7 9øô ò 	Ùð	üâ*s   ÁE=Á3B F Ã9FÆ	FÆFc                 ót  — d„ d„ d„ d„ dœ}t        | t        t        f«      r-| j                  «       D ��ci c]  \  }}|t	        |«      “Œ c}}S t        | t
        t        f«      rt        j                  | «      S t        | «      }|j                  «       D ]  \  }} || «      sŒ ||   | «      c S  | S c c}}w )zc
    Convert a TensorFlow tensor, PyTorch tensor, Numpy array or python list to a Numpy array.
    c                 óZ   — | j                  «       j                  «       j                  «       S rS   )ÚdetachÚcpurx   r‡   s    r/   r‰   zto_numpy.<locals>.<lambda>   s   € ˜#Ÿ*™*›,×*Ñ*Ó,×2Ñ2Ó4€ r1   c                 ó"   — | j                  «       S rS   )rx   r‡   s    r/   r‰   zto_numpy.<locals>.<lambda>!  s   € ˜#Ÿ)™)›+€ r1   c                 ó,   — t        j                  | «      S rS   )r6   r�   r‡   s    r/   r‰   zto_numpy.<locals>.<lambda>"  s   € œ2Ÿ:™: c›?€ r1   c                 ó   — | S rS   © r‡   s    r/   r‰   zto_numpy.<locals>.<lambda>#  s   € ˜#€ r1   r�   )
rN   r’   r   r“   Úto_numpyr•   r–   r6   r   rI   )rˆ   Úframework_to_numpyrœ   r�   rO   r¡   rP   s          r/   rª   rª     s¸   € ñ 5Ù%Ù*Ùñ	Ðô �#œœhÐ'Ô(Ø+.¯9©9«;×7¡4 1 a�”8˜A“;‘Ó7Ð7Ü	�Cœ$¤˜Ô	'Ü�x‰x˜‹}Ðô ;¸3Ó?ÐØ 6× <Ñ <Ó >ò 6Ñˆ	�9Ù�S�>Ø0Ð% iÑ0°Ó5Ò5ð6ð €Jùó 8s   µB4c                   óx   ‡ — e Zd ZdZdd„Zˆ fd„Zd„ Zd„ Zd„ Zd„ Z	d	„ Z
d
„ Zˆ fd„Zˆ fd„Zˆ fd„Zdefd„Zˆ xZS )ÚModelOutputa±  
    Base class for all model outputs as dataclass. Has a `__getitem__` that allows indexing by integer or slice (like a
    tuple) or strings (like a dictionary) that will ignore the `None` attributes. Otherwise behaves like a regular
    python dictionary.

    <Tip warning={true}>

    You can't unpack a `ModelOutput` directly. Use the [`~utils.ModelOutput.to_tuple`] method to convert it to a tuple
    before.

    </Tip>
    Úreturnc                 ó–   — t        «       r?ddlm}  || t        t	        t
        | ¬«      | j                  › d| j                  › �¬«       yy)zìRegister subclasses as pytree nodes.

        This is necessary to synchronize gradients when using `torch.nn.parallel.DistributedDataParallel` with
        `static_graph=True` with modules that output `ModelOutput` subclasses.
        r   )Úregister_pytree_node©Úoutput_typeú.©Úserialized_type_nameN)r   Útorch.utils._pytreer°   Ú_model_output_flattenr   Ú_model_output_unflattenÚ
__module__Ú__name__)Úclsr°   s     r/   Ú__init_subclass__zModelOutput.__init_subclass__B  sB   € ô ÔÝ@á ØÜ%ÜÔ/¸SÔAØ(+¯©Ð'7°q¸¿¹¸Ð%Gö	ð  r1   c                 óÄ   •— t        ‰| �  |i |¤Ž | j                  t        k7  }|r;t	        | «      s/t        | j                  › d| j                  j                  › d�«      ‚y y )Nr³   z` is not a dataclass. This is a subclass of ModelOutput and so must use the @dataclass decorator.)ÚsuperÚ__init__Ú	__class__r­   r   Ú	TypeErrorr¹   rº   )ÚselfÚargsÚkwargsÚis_modeloutput_subclassrÀ   s       €r/   r¿   zModelOutput.__init__R  sl   ø€ Ü‰Ñ˜$Ð) &Ò)ð #'§.¡.´KÑ"?Ðá"¬<¸Ô+=ÜØ—?‘?Ð# 1 T§^¡^×%<Ñ%<Ð$=ð >_ð _óð ð ,>Ð"r1   c                 óØ  ‡ — t        ‰ «      }t        |«      s"t        ‰ j                  j                  › d�«      ‚t        d„ |dd D «       «      s"t        ‰ j                  j                  › d�«      ‚t        ‰ |d   j                  «      }t        ˆ fd„|dd D «       «      }|�rt        |«      sût        |t        «      r|j                  «       }d}n	 t        |«      }d}|r²t        ‰ |d   j                  d«       t        «      D ]‰  \  }}t        |t         t"        f«      r!t        |«      d
k7  st        |d   t$        «      s)|dk(  r|‰ |d   j                  <   nt        d|› d�«      ‚ yt        ‰ |d   |d   «       |d   €Œ|d   ‰ |d   <   Œ‹ y|�|‰ |d   j                  <   yy|D ]*  }t        ‰ |j                  «      }	|	€Œ|	‰ |j                  <   Œ, y# t        $ r d	}Y �Œw xY w)zeCheck the ModelOutput dataclass.

        Only occurs if @dataclass decorator has been used.
        z has no fields.c              3   ó8   K  — | ]  }|j                   d u –— Œ y ­wrS   )Údefault)Ú.0Úfields     r/   ú	<genexpr>z,ModelOutput.__post_init__.<locals>.<genexpr>k  s   è ø€ ÒG¨U�5—=‘= DÔ(ÑGùs   ‚r   Nz. should not have more than one required field.r   c              3   óN   •K  — | ]  }t        ‰|j                  «      d u –— Œ y ­wrS   ©rg   Úname©rÉ   rÊ   rÂ   s     €r/   rË   z,ModelOutput.__post_init__.<locals>.<genexpr>o  s!   øè ø€ Ò#dÈ%¤G¨D°%·*±*Ó$=ÀÔ$EÑ#dùs   ƒ"%TFr   zCannot set key/value for z&. It needs to be a tuple (key, value).)r   Úlenr-   rÀ   rº   Úallrg   rÎ   rQ   rN   r’   r“   ÚiterrÁ   ÚsetattrÚ	enumerater•   r–   r8   )
rÂ   Úclass_fieldsÚfirst_fieldÚother_fields_are_noneÚiteratorÚfirst_field_iteratorÚidxÚelementrÊ   r�   s
   `         r/   Ú__post_init__zModelOutput.__post_init__a  s  ø€ ô
 ˜d“|ˆô �<Ô Ü §¡× 7Ñ 7Ð8¸ÐHÓIÐIÜÑG°lÀ1À2Ð6FÔGÔGÜ §¡× 7Ñ 7Ð8Ð8fÐgÓhÐhä˜d L°¡O×$8Ñ$8Ó9ˆÜ #Ó#dÐS_Ð`aÐ`bÐScÔ#dÓ dÐâ ¬°;Ô)?Ü˜+¤tÔ,Ø&×,Ñ,Ó.�Ø'+Ñ$ð1Ü# KÓ0�HØ+/Ð(ñ $ä˜˜l¨1™o×2Ñ2°DÔ9Ü$-¨hÓ$7ò 6‘L�C˜Ü% g´´e¨}Ô=ÄÀWÃÐQRÒARÔZdÐelÐmnÑeoÔqtÔZuØ !š8à9D˜D ¨a¡×!5Ñ!5Ò6ô #-Ø";¸G¸9ÐDjÐ kó#ð ñ Ü˜D '¨!¡*¨g°a©jÔ9Ø˜q‘zÑ-Ø+2°1©:˜˜W Q™ZÒ(ñ6ð Ð(Ø-8��\ !‘_×)Ñ)Ò*ð )ð &ò )�Ü˜D %§*¡*Ó-�Ø‘=Ø'(�D˜Ÿ™Ò$ñ)øô3 !ò 1Ø+0Ó(ð1ús   ÃG ÇG)Ç(G)c                 óH   — t        d| j                  j                  › d�«      ‚)Nz$You cannot use ``__delitem__`` on a ú
 instance.©rš   rÀ   rº   ©rÂ   rÃ   rÄ   s      r/   Ú__delitem__zModelOutput.__delitem__—  s#   € ÜÐ>¸t¿~¹~×?VÑ?VÐ>WÐWaÐbÓcÐcr1   c                 óH   — t        d| j                  j                  › d�«      ‚)Nz#You cannot use ``setdefault`` on a rÞ   rß   rà   s      r/   Ú
setdefaultzModelOutput.setdefaultš  s#   € ÜÐ=¸d¿n¹n×>UÑ>UÐ=VÐV`ÐaÓbÐbr1   c                 óH   — t        d| j                  j                  › d�«      ‚)NzYou cannot use ``pop`` on a rÞ   rß   rà   s      r/   ÚpopzModelOutput.pop�  s"   € ÜÐ6°t·~±~×7NÑ7NÐ6OÈzÐZÓ[Ð[r1   c                 óH   — t        d| j                  j                  › d�«      ‚)NzYou cannot use ``update`` on a rÞ   rß   rà   s      r/   ÚupdatezModelOutput.update   s#   € ÜÐ9¸$¿.¹.×:QÑ:QÐ9RÐR\Ð]Ó^Ð^r1   c                 ó„   — t        |t        «      rt        | j                  «       «      }||   S | j	                  «       |   S rS   )rN   r8   r’   r“   Úto_tuple)rÂ   rœ   Ú
inner_dicts      r/   Ú__getitem__zModelOutput.__getitem__£  s7   € Ü�aœÔÜ˜dŸj™j›lÓ+ˆJØ˜a‘=Ð à—=‘=“? 1Ñ%Ð%r1   c                 ón   •— || j                  «       v r|�t        ‰| �	  ||«       t        ‰| �  ||«       y rS   )Úkeysr¾   Ú__setitem__Ú__setattr__)rÂ   rÎ   ÚvaluerÀ   s      €r/   rï   zModelOutput.__setattr__ª  s4   ø€ Ø�4—9‘9“;Ñ 5Ð#4ä‰GÑ  eÔ,Ü‰Ñ˜D %Õ(r1   c                 óF   •— t         ‰| �  ||«       t         ‰| �	  ||«       y rS   )r¾   rî   rï   )rÂ   Úkeyrð   rÀ   s      €r/   rî   zModelOutput.__setitem__°  s!   ø€ ä‰Ñ˜C Ô'ä‰Ñ˜C Õ'r1   c                 ó¢   •‡ — t        ‰ «      st        ‰‰ �	  «       S t        ‰‰ �	  «       ^}}}t        ˆ fd„t	        ‰ «      D «       «      }||g|¢­S )Nc              3   óJ   •K  — | ]  }t        ‰|j                  «      –— Œ y ­wrS   rÍ   rÏ   s     €r/   rË   z)ModelOutput.__reduce__.<locals>.<genexpr>º  s   øè ø€ ÒI°5”W˜T 5§:¡:×.ÑIùs   ƒ #)r   r¾   Ú
__reduce__r–   r   )rÂ   ÚcallableÚ_argsÚ	remainingrÃ   rÀ   s   `    €r/   rõ   zModelOutput.__reduce__¶  sQ   ù€ Ü˜DÔ!Ü‘7Ñ%Ó'Ð'Ü&+¡gÑ&8Ó&:Ð#ˆ�%˜)ÜÓI¼FÀ4»LÔIÓIˆØ˜Ð) 	Ñ)Ð)r1   c                 óH   ‡ — t        ˆ fd„‰ j                  «       D «       «      S )za
        Convert self to a tuple containing all the attributes/keys that are not `None`.
        c              3   ó(   •K  — | ]	  }‰|   –— Œ y ­wrS   r©   )rÉ   rœ   rÂ   s     €r/   rË   z'ModelOutput.to_tuple.<locals>.<genexpr>Á  s   øè ø€ Ò2 �T˜!•WÑ2ùs   ƒ)r–   rí   ©rÂ   s   `r/   ré   zModelOutput.to_tuple½  s   ø€ ô Ó2 d§i¡i£kÔ2Ó2Ð2r1   )r®   N)rº   r¹   Ú__qualname__Ú__doc__r¼   r¿   rÜ   rá   rã   rå   rç   rë   rï   rî   rõ   r–   ré   Ú__classcell__)rÀ   s   @r/   r­   r­   4  sP   ø„ ñóô ò4)òldòcò\ò_ò&ô)ô(ô*ð3˜%÷ 3r1   r­   Úoutputr®   z_torch_pytree.Contextc                 óf   — t        | j                  «       «      t        | j                  «       «      fS rS   )r•   rL   rí   )rÿ   s    r/   r·   r·   Ç  s#   € Ü�F—M‘M“OÓ$¤d¨6¯;©;«=Ó&9Ð9Ð9r1   rL   Úcontextc           
      ó8   —  |di t        t        || «      «      ¤ŽS )Nr©   )r’   Úzip)rL   r  r²   s      r/   r¸   r¸   Ê  s   € ñ
 Ñ8œT¤# g¨vÓ"6Ó7Ñ8Ð8r1   r±   r³   r´   c                   ó    — e Zd ZdZed„ «       Zy)ÚExplicitEnumzC
    Enum with more explicit error message for missing values.
    c           
      ó~   — t        |› d| j                  › dt        | j                  j	                  «       «      › �«      ‚)Nz is not a valid z, please select one of )r-   rº   r•   Ú_value2member_map_rí   )r»   rð   s     r/   Ú	_missing_zExplicitEnum._missing_Þ  s?   € äØˆgÐ% c§l¡l ^Ð3JÌ4ÐPS×PfÑPf×PkÑPkÓPmÓKnÐJoÐpó
ð 	
r1   N)rº   r¹   rü   rý   Úclassmethodr  r©   r1   r/   r  r  Ù  s   „ ñð ñ
ó ñ
r1   r  c                   ó   — e Zd ZdZdZdZdZy)ÚPaddingStrategyz†
    Possible values for the `padding` argument in [`PreTrainedTokenizerBase.__call__`]. Useful for tab-completion in an
    IDE.
    ÚlongestÚ
max_lengthÚ
do_not_padN)rº   r¹   rü   rý   ÚLONGESTÚ
MAX_LENGTHÚ
DO_NOT_PADr©   r1   r/   r  r  å  s   „ ñð
 €GØ€JØ�Jr1   r  c                   ó$   — e Zd ZdZdZdZdZdZdZy)Ú
TensorTypez�
    Possible values for the `return_tensors` argument in [`PreTrainedTokenizerBase.__call__`]. Useful for
    tab-completion in an IDE.
    r3   r4   r6   r5   r7   N)	rº   r¹   rü   rý   ÚPYTORCHÚ
TENSORFLOWÚNUMPYÚJAXÚMLXr©   r1   r/   r  r  ð  s"   „ ñð
 €GØ€JØ€EØ
€CØ
�Cr1   r  c                   ó.   — e Zd ZdZdee   fd„Zd„ Zd„ Zy)ÚContextManagerszš
    Wrapper for `contextlib.ExitStack` which enters a collection of context managers. Adaptation of `ContextManagers`
    in the `fastcore` library.
    Úcontext_managersc                 ó0   — || _         t        «       | _        y rS   )r  r	   Ústack)rÂ   r  s     r/   r¿   zContextManagers.__init__  s   € Ø 0ˆÔÜ“[ˆ�
r1   c                 ó\   — | j                   D ]  }| j                  j                  |«       Œ y rS   )r  r  Úenter_context)rÂ   Úcontext_managers     r/   Ú	__enter__zContextManagers.__enter__  s)   € Ø#×4Ñ4ò 	6ˆOØ�J‰J×$Ñ$ _Õ5ñ	6r1   c                 ó<   —  | j                   j                  |i |¤Ž y rS   )r  Ú__exit__rà   s      r/   r#  zContextManagers.__exit__  s   € Øˆ�
‰
×Ñ˜TÐ, VÓ,r1   N)	rº   r¹   rü   rý   r•   r   r¿   r!  r#  r©   r1   r/   r  r  ý  s#   „ ñð
!¨Ð.DÑ)Eó !ò6ó-r1   r  c                 óT  — t        | «      }|dk(  r t        j                  | j                  «      }nD|dk(  r t        j                  | j                  «      }nt        j                  | j
                  «      }|j                  D ]%  }|dk(  sŒ	|j                  |   j                  du sŒ% y y)zr
    Check if a given model can return loss.

    Args:
        model_class (`type`): The class of the model.
    r4   r3   Úreturn_lossTF)Úinfer_frameworkÚinspectÚ	signatureÚcallÚforwardÚ__call__Ú
parametersrÈ   )Úmodel_classr¡   r(  Úps       r/   Úcan_return_lossr/    s�   € ô   Ó,€IØ�DÒÜ×%Ñ% k×&6Ñ&6Ó7‰	Ø	�dÒ	Ü×%Ñ% k×&9Ñ&9Ó:‰	ä×%Ñ% k×&:Ñ&:Ó;ˆ	à×!Ñ!ò ˆØ�Ó )×"6Ñ"6°qÑ"9×"AÑ"AÀTÒ"IÙðð r1   c                 ó¢  — | j                   }t        | «      }|dk(  r t        j                  | j                  «      }nD|dk(  r t        j                  | j
                  «      }nt        j                  | j                  «      }d|v r#|j                  D �cg c]  }d|v s|dv sŒ|‘Œ c}S |j                  D �cg c]	  }d|v sŒ|‘Œ c}S c c}w c c}w )zq
    Find the labels used by a given model.

    Args:
        model_class (`type`): The class of the model.
    r4   r3   ÚQuestionAnsweringÚlabel)Ústart_positionsÚend_positions)rº   r&  r'  r(  r)  r*  r+  r,  )r-  Ú
model_namer¡   r(  r.  s        r/   Úfind_labelsr6  %  s¾   € ð ×%Ñ%€JÜ Ó,€IØ�DÒÜ×%Ñ% k×&6Ñ&6Ó7‰	Ø	�dÒ	Ü×%Ñ% k×&9Ñ&9Ó:‰	ä×%Ñ% k×&:Ñ&:Ó;ˆ	à˜jÑ(Ø$×/Ñ/Öm�a°7¸a±<À1ÐHlÒCl’ÒmÐmà$×/Ñ/Ö@�a°7¸a²<’Ò@Ð@ùò nùâ@s   ÂCÂ!CÂ6	CÃ CÚdÚ
parent_keyÚ	delimiterc                 ó0   — dd„}t         || ||«      «      S )z/Flatten a nested dict into a single level dict.c              3   óö   K  — | j                  «       D ]`  \  }}|rt        |«      |z   t        |«      z   n|}|r5t        |t        «      r%t	        |||¬«      j                  «       E d {  –—†  Œ[||f–— Œb y 7 Œ­w)N)r9  )r“   r8   rN   r   Úflatten_dict)r7  r8  r9  rœ   r�   rò   s         r/   Ú_flatten_dictz#flatten_dict.<locals>._flatten_dict>  sp   è ø€ Ø—G‘G“Iò 	‰DˆAˆqÙ:D”#�j“/ IÑ-´°A³Ò6È!ˆCÙ”Z ¤>Ô2Ü'¨¨3¸)ÔD×JÑJÓL×LÑLà˜1�f“ñ	ð Mús   ‚A&A9Á(A7Á)A9©Ú r³   )r’   )r7  r8  r9  r=  s       r/   r<  r<  ;  s   € óô ‘˜a ¨YÓ7Ó8Ð8r1   FÚuse_temp_dirc              #   ót   K  — |r"t        j                  «       5 }|–— d d d «       y | –— y # 1 sw Y   y xY w­wrS   )ÚtempfileÚTemporaryDirectory)Úworking_dirr@  Útmp_dirs      r/   Úworking_or_temp_dirrF  I  s=   è ø€ áÜ×(Ñ(Ó*ð 	¨gØŠM÷	ð 	ð Ó÷	ð 	üs   ‚8™,ž8¬5±8c                 óR  — t        | «      rt        j                  | |¬«      S t        | «      r|€| j                  S  | j
                  |Ž S t        | «      rddl}|j                  | |¬«      S t        | «      rddl	m
} |j                  | |¬«      S t        dt        | «      › d�«      ‚)z…
    Framework-agnostic version of `numpy.transpose` that will work on torch/TensorFlow/Jax tensors as well as NumPy
    arrays.
    )ÚaxesNr   )Úpermz"Type not supported for transpose: r³   )rB   r6   Ú	transposer?   ÚTÚpermuter@   rm   rA   rw   rx   r-   r9   )r   rH  r4   ry   s       r/   rJ  rJ  R  s˜   € ô
 �eÔÜ�|‰|˜E¨Ô-Ð-Ü	˜Ô	Ø˜,ˆu�w‰wÐ@¨M¨E¯M©M¸4Ð,@Ð@Ü	�eÔ	Ûà�|‰|˜E¨ˆ|Ó-Ð-Ü	�uÔ	Ýà�}‰}˜U¨ˆ}Ó.Ð.äÐ=¼dÀ5»k¸]È!ÐLÓMÐMr1   c                 ó0  — t        | «      rt        j                  | |«      S t        | «      r | j                  |Ž S t	        | «      rddl}|j                  | |«      S t        | «      rddlm} |j                  | |«      S t        dt        | «      › d�«      ‚)zƒ
    Framework-agnostic version of `numpy.reshape` that will work on torch/TensorFlow/Jax tensors as well as NumPy
    arrays.
    r   Nz Type not supported for reshape: r³   )rB   r6   Úreshaper?   r@   rm   rA   rw   rx   r-   r9   )r   Únewshaper4   ry   s       r/   rN  rN  g  s‡   € ô
 �eÔÜ�z‰z˜% Ó*Ð*Ü	˜Ô	Øˆu�}‰}˜hÐ'Ð'Ü	�eÔ	Ûà�z‰z˜% Ó*Ð*Ü	�uÔ	Ýà�{‰{˜5 (Ó+Ð+äÐ;¼DÀ»K¸=ÈÐJÓKÐKr1   c                 ó`  — t        | «      rt        j                  | |¬«      S t        | «      r$|€| j                  «       S | j                  |¬«      S t	        | «      rddl}|j                  | |¬«      S t        | «      rddlm} |j                  | |¬«      S t        dt        | «      › d�«      ‚)zƒ
    Framework-agnostic version of `numpy.squeeze` that will work on torch/TensorFlow/Jax tensors as well as NumPy
    arrays.
    ©ÚaxisN©Údimr   z Type not supported for squeeze: r³   )rB   r6   Úsqueezer?   r@   rm   rA   rw   rx   r-   r9   ©r   rR  r4   ry   s       r/   rU  rU  |  sš   € ô
 �eÔÜ�z‰z˜% dÔ+Ð+Ü	˜Ô	Ø"& ,ˆu�}‰}‹ÐK°E·M±MÀd°MÓ4KÐKÜ	�eÔ	Ûà�z‰z˜% dˆzÓ+Ð+Ü	�uÔ	Ýà�{‰{˜5 tˆ{Ó,Ð,äÐ;¼DÀ»K¸=ÈÐJÓKÐKr1   c                 ó:  — t        | «      rt        j                  | |«      S t        | «      r| j	                  |¬«      S t        | «      rddl}|j                  | |¬«      S t        | «      rddlm	} |j                  | |¬«      S t        dt        | «      › d�«      ‚)z‡
    Framework-agnostic version of `numpy.expand_dims` that will work on torch/TensorFlow/Jax tensors as well as NumPy
    arrays.
    rS  r   NrQ  z$Type not supported for expand_dims: r³   )rB   r6   Úexpand_dimsr?   Ú	unsqueezer@   rm   rA   rw   rx   r-   r9   rV  s       r/   rX  rX  ‘  s‹   € ô
 �eÔÜ�~‰~˜e TÓ*Ð*Ü	˜Ô	Ø�‰ 4ˆÓ(Ð(Ü	�eÔ	Ûà�~‰~˜e¨$ˆ~Ó/Ð/Ü	�uÔ	Ýà�‰˜u¨4ˆÓ0Ð0äÐ?ÄÀUÃ¸}ÈAÐNÓOÐOr1   c                 ó  — t        | «      rt        j                  | «      S t        | «      r| j	                  «       S t        | «      rddl}|j                  | «      S t        | «      r| j                  S t        dt        | «      › d�«      ‚)z|
    Framework-agnostic version of `numpy.size` that will work on torch/TensorFlow/Jax tensors as well as NumPy arrays.
    r   Nz$Type not supported for tensor_size: r³   )
rB   r6   Úsizer?   Únumelr@   rm   rA   r-   r9   )r   r4   s     r/   Útensor_sizer]  ¦  sr   € ô �eÔÜ�w‰w�u‹~ÐÜ	˜Ô	Ø�{‰{‹}ÐÜ	�eÔ	Ûà�w‰w�u‹~ÐÜ	�uÔ	Ø�z‰zÐäÐ?ÄÀUÃ¸}ÈAÐNÓOÐOr1   c                 óX  — t        j                  | «      D ]„  }|j                  }|j                  }|j	                  d«      s|j	                  d«      s|dk(  r y|j	                  d«      s|dk(  r y|j	                  d«      s|j	                  d	«      s|d
k(  sŒ„ y t        d| › d�«      ‚)z 
    Infers the framework of a given model without using isinstance(), because we cannot guarantee that the relevant
    classes are imported or available.
    rm   ÚkerasÚTFPreTrainedModelr4   rZ   ÚPreTrainedModelr3   Úflaxr5   ÚFlaxPreTrainedModelz%Could not infer framework from class r³   )r'  Úgetmror¹   rº   r:   rÁ   )r-  Ú
base_classÚmodulerÎ   s       r/   r&  r&  ¸  s®   € ô
 —n‘n [Ó1ò ˆ
Ø×&Ñ&ˆØ×"Ñ"ˆØ×Ñ˜\Ô*¨f×.?Ñ.?ÀÔ.HÈDÐTgÒLgÙØ×Ñ˜wÔ'¨4Ð3DÒ+DÙØ×Ñ˜vÔ&¨&×*;Ñ*;¸EÔ*BÀdÐNcÓFcÙðô Ð;¸K¸=ÈÐJÓ
KÐKr1   c                 óà   — t        «       st        | «      S ddl}|j                  j	                  «       r1t        | |j                  «      r| j                  |j                  «      S t        | «      S )zk
    Casts an input to a torch int64 tensor if we are in a tracing context, otherwise to a Python int.
    r   N)	r   r�   rZ   ÚjitÚ
is_tracingrN   r[   ÚtoÚint64r\   s     r/   Ú	torch_intrl  É  sQ   € ô ÔÜ�1‹vˆãà %§	¡	× 4Ñ 4Ô 6¼:ÀaÈÏÉÔ;Vˆ1�4‰4�—‘ÓÐbÔ\_Ð`aÓ\bÐbr1   c                 óà   — t        «       st        | «      S ddl}|j                  j	                  «       r1t        | |j                  «      r| j                  |j                  «      S t        | «      S )zo
    Casts an input to a torch float32 tensor if we are in a tracing context, otherwise to a Python float.
    r   N)	r   r�   rZ   rh  ri  rN   r[   rj  Úfloat32r\   s     r/   Útorch_floatro  Õ  sQ   € ô ÔÜ�1‹vˆãà"'§)¡)×"6Ñ"6Ô"8¼ZÈÈ5Ï<É<Ô=Xˆ1�4‰4�—‘ÓÐdÔ^aÐbcÓ^dÐdr1   Úextrac                 ó4   ‡— | xs g } t        | «      Šˆfd„}|S )aI  
    Decorator to filter out named arguments that are not in the function signature.

    This decorator ensures that only the keyword arguments that match the function's signature, or are specified in the
    `extra` list, are passed to the function. Any additional keyword arguments are filtered out and a warning is issued.

    Parameters:
        extra (`Optional[list]`, *optional*):
            A list of extra keyword argument names that are allowed even if they are not in the function's signature.

    Returns:
        Callable:
            A decorator that wraps the function and filters out invalid keyword arguments.

    Example usage:

        ```python
        @filter_out_non_signature_kwargs(extra=["allowed_extra_arg"])
        def my_function(arg1, arg2, **kwargs):
            print(arg1, arg2, kwargs)

        my_function(arg1=1, arg2=2, allowed_extra_arg=3, invalid_arg=4)
        # This will print: 1 2 {"allowed_extra_arg": 3}
        # And issue a warning: "The following named arguments are not valid for `my_function` and were ignored: 'invalid_arg'"
        ```
    c                 óì   •‡ ‡‡‡— t        j                  ‰ «      }t        |j                  j	                  «       «      }|j                  ‰«      Šd|v Šd|v Šd‰ _        t        ‰ «      ˆ ˆˆˆfd„«       }|S )NrÂ   r»   Tc                  óˆ  •— i }i }|j                  «       D ]  \  }}|‰v r|||<   Œ|||<   Œ |rˆ|D �cg c]  }d|› d�‘Œ
 }}dj                  |«      }‰
r| d   j                  j                  dz   }n‰	r| d   j                  dz   }nd}t	        j
                  d|› ‰j                  › d|› �t        d¬	«        ‰| i |¤ŽS c c}w )
Nú'z, r   r³   r?  z1The following named arguments are not valid for `z` and were ignored: r   )Ú
stacklevel)r“   ÚjoinrÀ   rº   ÚwarningsÚwarnÚUserWarning)rÃ   rÄ   Úvalid_kwargsÚinvalid_kwargsrœ   r�   Úinvalid_kwargs_namesÚ
cls_prefixÚfuncÚis_class_methodÚis_instance_methodÚvalid_kwargs_to_passs           €€€€r/   ÚwrapperzCfilter_out_non_signature_kwargs.<locals>.decorator.<locals>.wrapper  sý   ø€ àˆLØˆNàŸ™›ò *‘��1ØÐ,Ñ,Ø&'�L ’Oà()�N 1Ò%ð	*ñ Ø:HÖ'I°Q¨!¨A¨3¨aªÐ'IÐ$Ð'IØ'+§y¡yÐ1EÓ'FÐ$ñ &Ø!% a¡×!2Ñ!2×!;Ñ!;¸cÑ!A‘JÙ$Ø!% a¡×!1Ñ!1°CÑ!7‘Jà!#�Jä—‘ØGÈ
À|ÐTX×TaÑTaÐSbð c*Ø*>Ð)?ðAäØ õ	ñ ˜Ð. Ñ.Ð.ùò% (Js   ³B?)r'  r(  Úsetr,  rí   ÚunionÚ _filter_out_non_signature_kwargsr   )r~  ÚsigÚfunction_named_argsr‚  r  r€  r�  Úextra_params_to_passs   `   @@@€r/   Ú	decoratorz2filter_out_non_signature_kwargs.<locals>.decoratorÿ  s}   ü€ Ü×Ñ Ó%ˆÜ! #§.¡.×"5Ñ"5Ó"7Ó8ÐØ2×8Ñ8Ð9MÓNÐð $Ð':Ð:ÐØÐ#6Ð6ˆð 15ˆÔ-ä	ˆt‹ö	/ó 
ð	/ð> ˆr1   )rƒ  )rp  r‰  rˆ  s     @r/   Úfilter_out_non_signature_kwargsrŠ  á  s&   ø€ ð6 ŠK�R€EÜ˜u›:Ðô,ð\ Ðr1   c                   ó’   — e Zd ZU dZed   ed<   ee   ed<   ee   ed<   ee   ed<   ed   ed<   ed   ed	<   ee   ed
<   ee   ed<   y)ÚTransformersKwargsat  
    Keyword arguments to be passed to the forward pass of a `PreTrainedModel`.

    Attributes:
        num_items_in_batch (`Optional[torch.Tensor]`, *optional*):
            Number of items in the batch. It is recommended to pass it when you are doing gradient accumulation.
        output_hidden_states (`Optional[bool]`, *optional*):
            Most of the models support outputting all hidden states computed during the forward pass.
        output_attentions (`Optional[bool]`, *optional*):
            Turn this on to return the intermediary attention scores.
        output_router_logits (`Optional[bool]`, *optional*):
            For MoE models, this allows returning the router logits to compute the loss.
        cu_seq_lens_q (`torch.LongTensor`, *optional*)
            Gets cumulative sequence length for query state.
        cu_seq_lens_k (`torch.LongTensor`, *optional*)
            Gets cumulative sequence length for key state.
        max_length_q (`int`, *optional*):
            Maximum sequence length for query state.
        max_length_k (`int`, *optional*):
            Maximum sequence length for key state.
    ztorch.TensorÚnum_items_in_batchÚoutput_hidden_statesÚoutput_attentionsÚoutput_router_logitsztorch.LongTensorÚcu_seq_lens_qÚcu_seq_lens_kÚmax_length_qÚmax_length_kN)rº   r¹   rü   rý   r   Ú__annotations__Úboolr�   r©   r1   r/   rŒ  rŒ  0  s^   … ñð, ! Ñ0Ó0Ø" 4™.Ó(Ø ‘~Ó%Ø" 4™.Ó(ØÐ.Ñ/Ó/ØÐ.Ñ/Ó/Ø˜3‘-ÓØ˜3‘-Ôr1   rŒ  )ÚtotalÚconfig_dictc                 ó
   — d| v S )z3Checks whether a config dict is a timm config dict.Úpretrained_cfgr©   )r˜  s    r/   Úis_timm_config_dictr›  Q  s   € à˜{Ð*Ð*r1   Úpretrained_model_pathc                 ó¤  — | €yt        | «      } t        j                  j                  | «      }t        j                  j	                  | «      }|rE| j                  d«      r4t        | «      5 }t        j                  |«      }ddd«       t        |«      S |r�t        j                  j                  t        j                  j                  | d«      «      rRt        t        j                  j                  | d«      «      5 }t        j                  |«      }ddd«       t        |«      S y# 1 sw Y   t        «      S xY w# 1 sw Y   t        «      S xY w)zA
    Checks whether a checkpoint is a timm model checkpoint.
    NFz.jsonzconfig.json)r8   ÚosÚpathÚisfileÚisdirÚendswithÚopenÚjsonÚloadr›  Úexistsrv  )rœ  Úis_fileÚis_dirr'   r˜  s        r/   Úis_timm_local_checkpointr©  V  s  € ð Ð$Øô  Ð 5Ó6Ðä�g‰g�n‰nÐ2Ó3€GÜ�W‰W�]‰]Ð0Ó1€Fñ Ð(×1Ñ1°'Ô:ÜÐ'Ó(ð 	'¨AÜŸ)™) A›,ˆK÷	'ä" ;Ó/Ð/ñ ”"—'‘'—.‘.¤§¡§¡Ð.CÀ]Ó!SÔTÜ”"—'‘'—,‘,Ð4°mÓDÓEð 	'ÈÜŸ)™) A›,ˆK÷	'ä" ;Ó/Ð/à÷	'ä" ;Ó/Ð/ú÷	'ä" ;Ó/Ð/ús   Á+D&Ã<D<Ä&D9Ä<Erf  ztorch.nn.Modulerò   rð   c                 ób   — t        | ||«       | j                  «       D ]  }t        |||«       Œ y)z5
    Set a value to a module and all submodules.
    N)rÓ   ÚchildrenÚset_attribute_for_modules)rf  rò   rð   Ú	submodules       r/   r¬  r¬  r  s2   € ô ˆF�C˜ÔØ—_‘_Ó&ò 9ˆ	Ü! )¨S°%Õ8ñ9r1   c                 óv   — t        | |«      rt        | |«       | j                  «       D ]  }t        ||«       Œ y)z:
    Delete a value from a module and all submodules.
    N)rf   Údelattrr«  Údel_attribute_from_modules)rf  rò   r­  s      r/   r°  r°  {  s8   € ô
 ˆv�sÔÜ�˜Ôà—_‘_Ó&ò 3ˆ	Ü" 9¨cÕ2ñ3r1   c                 ó.   ‡ — t        ‰ «      ˆ fd„«       }|S )zö
    Decorator to wrap model method, to call output.to_tuple() if return_dict=False passed as a kwarg or
    use_return_dict=False is set in the config.

    Note:
        output.to_tuple() convert output to tuple skipping all `None` values.
    c                 óØ   •— t        | d«      r| j                  j                  nd}|j                  d|«      }|�|} ‰| g|¢­i |¤Ž}|s t	        |t
        «      s|j                  «       }|S )NÚconfigTÚreturn_dict)rf   r³  r´  rå   rN   r–   ré   )rÂ   rÃ   rÄ   r´  Úreturn_dict_passedrÿ   r~  s         €r/   r‚  z!can_return_tuple.<locals>.wrapper�  sj   ø€ ä18¸¸xÔ1H�d—k‘k×-Ò-ÈdˆØ#ŸZ™Z¨°{ÓCÐØÐ)Ø,ˆKÙ�dÐ,˜TÒ, VÑ,ˆÙ¤:¨f´eÔ#<Ø—_‘_Ó&ˆFØˆr1   ©r   )r~  r‚  s   ` r/   Úcan_return_tupler·  ‡  s"   ø€ ô ˆ4ƒ[óó ðð €Nr1   )rZ   )Úbackendsc                   óR   — e Zd ZU dZded<   dZeed<   dZee	   ed<   dZ
ee	   ed<   y)	ÚOutputRecordera  
    Configuration for recording outputs from a model via hooks.

    Attributes:
        target_class (Type): The class (e.g., nn.Module) to which the hook will be attached.
        index (Optional[int]): If the output is a tuple/list, optionally record only at a specific index.
        layer_name (Optional[str]): Name of the submodule to target (if needed), e.g., "transformer.layer.3.attn".
        class_name (Optional[str]): Name of the class to which the hook will be attached. Could be the suffix of class name in some cases.
    ztype[torch.nn.Module]Útarget_classr   ÚindexNÚ
layer_nameÚ
class_name)rº   r¹   rü   rý   r•  r¼  r�   r½  r   r8   r¾  r©   r1   r/   rº  rº     s4   … ñð *Ó)Ø€Eˆ3ƒNØ $€J�˜‘Ó$Ø $€J�˜‘Ô$r1   rº  T)Útie_last_hidden_statesc                ó&   ‡— ˆfd„}| � || «      S |S )a   
    Decorator to intercept specific layer outputs without using hooks.
    Compatible with torch.compile (Dynamo tracing).

    Args:
        tie_last_hidden_states (`bool`, *optional*, defaults to `True`):
            Whether to overwrite `out.hidden_states[-1]` with the `out.last_hidden_state`.
            This is true for all language models and should be toggled off only if
            `out.hidden_states[-1]` has to be the hidden state before last layer norm, which
            is needed for some vision models (e.g. CLIP, SigLIP)
    c                 ó2   •‡ — t        ‰ «      ˆ ˆfd„«       }|S )Nc                 ó~
  •‡‡— |j                  d«      �|d   nt        | j                  dd «      }|�7t        | dd«      r%| j                  r|rt        j                  d«       d}||d<   |j                  dd «      }|€t        | j                  dd«      }|j                  «       }d|v r |d   j                  «       D ]
  \  }}|||<   Œ t        j                  t        | j                  «      i «      }|D �ci c]X  }d|› �|j                  d|› �t        | j                  d|› �|j                  d	t        | j                  d	d«      «      «      «      “ŒZ }	}d	|	v r|	d	   |	d
<   t        t        «      Šg }
|	j                  d	d«      r¦g d¢Št        | j                  dd «      }| j                  j                  D �cg c]  }t        | j                  |d «      ‘Œ }}|D �cg c]  }|€Œt        |dd «      ‘Œ }}|‰vst        ˆfd„|D «       «      rt!        j"                  d‰› d�t$        «       ˆfd„}t        |	j'                  «       «      �rlg }|j                  «       D ]–  \  }}|	j                  d|› �d«      sŒt)        |t*        «      s|g}|D ]c  }t)        |t,        «      s>d|v rdnd}t)        |t        «      sd n|}t)        |t        «      s|nd }t-        |||¬«      }|j/                  ||f«       Œe Œ˜ | j1                  «       D ]®  \  }}|D ]¤  \  }}|j2                  �t)        ||j2                  «      s)|j4                  €Œ5|j7                  |j4                  «      sŒQ|j8                  �|j8                  |vrŒl|j:                  } |||||j<                  «      |_        |
j/                  ||f«       Œ¦ Œ° 	  ‰| g|¢­i |¤Ž}|
D ]  \  }}||_        Œ ‰D ]Ì  }|dk(  rk‰ sn_tC        |d«      r$‰|   d d ‰|<   ‰|xx   |jD                  fz  cc<   n/tC        |d«      r#‰|   d d ‰|<   ‰|xx   |jF                  fz  cc<   ‰|   ||<   Œs|dk(  rMt)        ||   t*        «      r1tI        ||   «      dk(  r ‰|   dd d…   ||<   ‰|   dd d…   |d|z   <   Œ¼‰|   ||<   ŒÅ‰|   ||<   ŒÎ |du r|jK                  «       }|S c c}w c c}w c c}w # t>        $ rj}|j                  «       D ��ci c]  \  }}||	vsŒ||“Œ nc c}}w }}}	  ‰| g|¢­i |¤Ž}n# t>        $ r |‚w xY wt?        d‰j@                  › d�«      ‚d }~ww xY w)NÚ	use_cacheÚgradient_checkpointingFzX`use_cache=True` is incompatible with gradient checkpointing. Setting `use_cache=False`.r´  TrÄ   Úoutput_r�  Úoutput_cross_attentions)ÚeagerÚeager_pagedÚflex_attentionÚ_attn_implementationc              3   ó&   •K  — | ]  }|‰v–— Œ
 y ­wrS   r©   )rÉ   ÚattnÚsupported_attns     €r/   rË   zJcheck_model_inputs.<locals>.wrapped_fn.<locals>.wrapper.<locals>.<genexpr>õ  s   øè ø€ Ò;tÐ[_¸DÈÔ<VÑ;tùs   ƒzP`output_attentions=True` is not supported with `attn_implementation` other than z\. Please use `model.set_attn_implementation('eager')` to enable capturing attention outputs.c                 ó>   •‡ ‡‡‡— t        ‰«      ˆˆˆˆ ˆfd„«       }|S )Nc                  ó¨  •— ‰dk(  r"t        ‰‰   «      dk(  r‰‰xx   | d   fz  cc<   |j                  dd«      r>t        ‰|j                  dd«      |j                  d«      «      5   ‰| i |¤Ž}d d d «       n ‰| i |¤Ž}t        t        «      s‰‰xx   |fz  cc<   |S |‰   � ‰‰vr|‰   f‰‰<   |S ‰‰xx   |‰   fz  cc<   |S # 1 sw Y   ŒPxY w)NÚhidden_statesr   Údebug_ioFÚdebug_io_dirz~/model_debugÚprune_layers)rÐ   Úgetr   rN   r–   )rÃ   rÄ   rÿ   Úcollected_outputsr¼  rò   rf  Úorig_forwards      €€€€€r/   Úwrapped_forwardzncheck_model_inputs.<locals>.wrapped_fn.<locals>.wrapper.<locals>.make_capture_wrapper.<locals>.wrapped_forwardý  s  ø€ à˜oÒ-´#Ð6GÈÑ6LÓ2MÐQRÒ2RØ)¨#Ó.°4¸±7°*Ñ<Ó.Ø—z‘z *¨eÔ4Ü<Ø" F§J¡J¨~¸Ó$OÐQW×Q[ÑQ[Ð\jÓQkóñ Cñ &2°4Ð%B¸6Ñ%B˜F÷Cð Cñ
 ".¨tÐ!>°vÑ!>˜Ü% f¬eÔ4Ø)¨#Ó.°6°)Ñ;Ó.ð "�Mð   ™Ð2ØÐ&7Ñ7Ø6<¸U±mÐ5EÐ-¨cÑ2ð "�Mð .¨cÓ2°v¸e±}Ð6FÑFÓ2Ø!�M÷Cð Cús   Á'	CÃCr¶  )rf  rÖ  rò   r¼  r×  rÕ  s   ```` €r/   Úmake_capture_wrapperzUcheck_model_inputs.<locals>.wrapped_fn.<locals>.wrapper.<locals>.make_capture_wrapperü  s"   ü€ Ü�|Ó$÷"ó %ð"ð& 'Ð&r1   rÐ  r   r   )r»  r¼  r¾  zUMissing `**kwargs` in the signature of the `@check_model_inputs`-decorated function (ú)Úvision_hidden_stateséÿÿÿÿÚlast_hidden_stateÚ
attentionsr   Úcross_)&rÔ  rg   r³  ÚtrainingÚloggerÚwarning_oncerå   Úcopyr“   Ú_CAN_RECORD_REGISTRYr8   rÀ   r   r–   Úsub_configsÚanyrw  rx  ry  rL   rN   r•   rº  rD   Únamed_modulesr»  r¾  r¢  r½  r*  r¼  rÁ   rü   rf   rÚ  rÜ  rÐ   ré   )!rÂ   rÃ   rÄ   rÃ  r´  Úall_argsrœ   r�   Úcapture_flagsÚrecordable_keysÚmonkey_patched_layersÚconfig_attnrò   rä  r³  Úsub_configs_attnrØ  Úcapture_tasksÚlayer_specsÚspecsr¼  r¾  r»  rÎ   rf  Úoriginal_forwardÚoutputsÚoriginal_exceptionÚkwargs_without_recordablerÕ  rÍ  r~  r¿  s!                                @@€€r/   r‚  z7check_model_inputs.<locals>.wrapped_fn.<locals>.wrapperÁ  s  ú€ ð (.§z¡z°+Ó'>Ð'J��{Ò#ÔPWÐX\×XcÑXcÐepÐrvÓPwð ð Ð$Ü˜4Ð!9¸5ÔAÀdÇmÂmÑXaÜ×'Ñ'Ørôð !&�Ià&/��{Ñ#à Ÿ*™* ]°DÓ9ˆKØÐ"Ü% d§k¡k°=À$ÓG�à—{‘{“}ˆHØ˜8Ñ#Ø$ XÑ.×4Ñ4Ó6ò $‘D�A�qØ"#�H˜Q’Kð$ô 1×4Ñ4´S¸¿¹Ó5HÈ"ÓMˆMð 'ö
ð ð ˜!˜�˜xŸ|™|Ø˜a˜S�MÜØŸ™Ø! ! ˜Ø Ÿ™Ð%8¼'À$Ç+Á+ÐObÐdiÓ:jÓkóó ñ ð
ˆOð 
ð # oÑ5Ø=LÐM`Ñ=a�Ð 9Ñ:ä +¬EÓ 2ÐØ$&Ð!ð ×"Ñ"Ð#6¸Ô>Ú!K�Ü% d§k¡kÐ3IÈ4ÓP�ØJNÏ+É+×JaÑJaÖbÀ3œw t§{¡{°C¸Õ>Ðb�ÐbàP[ö$ØFLÐ_eÑ_q”G˜FÐ$:¸DÕAð$Ð ð $ð  nÑ4¼Ó;tÐcsÔ;tÔ8tÜ—M‘MØjÐkyÐjzð {uð uä#ôô'ô. �?×)Ñ)Ó+Õ,Ø "�Ø(5×(;Ñ(;Ó(=ò ;Ñ$�C˜Ø*×.Ñ.°¸¸¨ÀÔFØ Ü% k´4Ô8Ø'2 m˜Ø!,ò ;˜Ü)¨%´Ô@Ø)8¸CÑ)?¡AÀQ˜EÜ5?ÀÄsÔ5K©ÐQV˜JÜ8BÀ5Ì#Ô8N©5ÐTX˜LÜ$2ÀÐTYÐfpÔ$q˜EØ%×,Ñ,¨c°5¨\Õ:ñ;ð;ð %)×$6Ñ$6Ó$8ò U‘L�D˜&Ø&3ò 
U™
˜˜Uà!×.Ñ.Ð:¼zÈ&ÐRW×RdÑRdÔ?eØ!×,Ñ,Ñ8¸T¿]¹]È5×K[ÑK[Õ=\à$×/Ñ/Ð;À×@PÑ@PÐX\Ñ@\Ø (à/5¯~©~Ð,Ù-AÀ&ÐJZÐ\_Ðaf×alÑalÓ-m˜FœNØ1×8Ñ8¸&ÐBRÐ9SÕTñ
UðUðÙ˜tÐ5 dÒ5¨fÑ5�ð  -Bò 2Ñ(�Ð(Ø!1�•ð2ð )ò :�Ø˜/Ò)Ù1ØÜ  Ð*@ÔAØ1BÀ3Ñ1GÈÈÐ1LÐ)¨#Ñ.Ø)¨#Ó.°7×3OÑ3OÐ2QÑQÔ.Ü  Ð*=Ô>Ø1BÀ3Ñ1GÈÈÐ1LÐ)¨#Ñ.Ø)¨#Ó.°7×3LÑ3LÐ2NÑNÓ.à#4°SÑ#9�G˜C’LØ˜LÒ(Ü! -°Ñ"4´dÔ;ÄÀMÐRUÑDVÓ@WÐ[\Ò@\Ø'8¸Ñ'=¸a¸dÀ¸dÑ'C˜ ™Ø2CÀCÑ2HÈÈÈAÈÑ2N˜ ¨3¡Ò/à'8¸Ñ'=˜ šà#4°SÑ#9�G˜C’Lð':ð( ˜eÑ#Ø!×*Ñ*Ó,�ØˆNùòC
ùò0 cùò$øô~ ò ð ?E¿l¹l»n×,i±d°a¸ÐPQÐYhÒPh¨Q°©TÑ,iùÓ,iÐ)Ñ,ið-Ù" 4ÐL¨$ÒLÐ2KÑL‘GøÜ ò -Ø,Ð,ð-úäðØ×)Ñ)Ð*¨!ð-óð ûðús[   Ã6AR:Æ7R?ÇSÇ#SÎ6S	 Ó		T<ÓT7Ó%S8Ó2S8Ó7
T7ÔTÔT7ÔTÔT7Ô7T<r¶  )r~  r‚  r¿  s   ` €r/   Ú
wrapped_fnz&check_model_inputs.<locals>.wrapped_fnÀ  s#   ù€ Ü	ˆt‹ôX	ó 
ðX	ðt ˆr1   r©   )r~  r¿  rô  s    ` r/   Úcheck_model_inputsrõ  ³  s#   ø€ ô\ð| ÐÙ˜$ÓÐØÐr1   c                   ód   — e Zd ZdZi Zd„ Zd„ Zd„ Zd„ Zd„ Z	d„ Z
eded	efd
„«       Zdee   fd„Zy)ÚGeneralInterfacezé
    Dict-like object keeping track of a class-wide mapping, as well as a local one. Allows to have library-wide
    modifications though the class mapping, as well as local modifications in a single file with the local mapping.
    c                 ó   — i | _         y rS   ©Ú_local_mappingrû   s    r/   r¿   zGeneralInterface.__init__m  s
   € Ø ˆÕr1   c                 óZ   — || j                   v r| j                   |   S | j                  |   S rS   )rú  Ú_global_mapping©rÂ   rò   s     r/   rë   zGeneralInterface.__getitem__p  s2   € à�$×%Ñ%Ñ%Ø×&Ñ& sÑ+Ð+Ø×#Ñ# CÑ(Ð(r1   c                 ó>   — | j                   j                  ||i«       y rS   )rú  rç   )rÂ   rò   rð   s      r/   rî   zGeneralInterface.__setitem__v  s   € à×Ñ×"Ñ" C¨ <Õ0r1   c                 ó   — | j                   |= y rS   rù  rý  s     r/   rá   zGeneralInterface.__delitem__z  s   € Ø×Ñ Ñ$r1   c                 óH   — t        i | j                  ¥| j                  ¥«      S rS   )rÒ   rü  rú  rû   s    r/   Ú__iter__zGeneralInterface.__iter__}  s$   € äÐC�t×+Ñ+ÐC¨t×/BÑ/BÐCÓDÐDr1   c                 ó~   — t        | j                  j                  «       | j                  j                  «       z  «      S rS   )rÐ   rü  rí   rú  rû   s    r/   Ú__len__zGeneralInterface.__len__�  s0   € Ü�4×'Ñ'×,Ñ,Ó.°×1DÑ1D×1IÑ1IÓ1KÑKÓLÐLr1   rò   rð   c                 ó>   — | j                   j                  ||i«       y rS   )rü  rç   )r»   rò   rð   s      r/   ÚregisterzGeneralInterface.register„  s   € à×Ñ×"Ñ" C¨ <Õ0r1   r®   c                 ó4   — t        | j                  «       «      S rS   )r•   rí   rû   s    r/   Ú
valid_keyszGeneralInterface.valid_keysˆ  s   € Ü�D—I‘I“KÓ Ð r1   N)rº   r¹   rü   rý   rü  r¿   rë   rî   rá   r  r  r	  r8   r   r  r•   r  r©   r1   r/   r÷  r÷  c  s`   „ ñð €Oò!ò)ò1ò%òEòMð ð1˜3ð 1 xò 1ó ð1ð!˜D ™Iô !r1   r÷  rS   r>  )F)nrý   r'  r¤  rž  rB  rw  Úcollectionsr   r   r   Úcollections.abcr   r   Ú
contextlibr   r	   r
   Údataclassesr   r   r   Úenumr   Ú	functoolsr   r   Útypingr   r   r   r   rx   r6   Úutilsr   Úimport_utilsr   r   r   r   r   r   rã  Ú
get_loggerrº   rà  rZ   Úmodel_debugging_utilsr   r0   r=   rI   rQ   rV   rB   r]   r?   rb   rd   ri   rk   ro   r@   rs   ru   rz   rA   r�   rC   r”   rª   r­   r¶   Ú_pytreeÚ_torch_pytreer–   r•   r·   r¸   r°   r¹   r8   r  r  r  r  r/  r6  r<  r–  rF  rJ  rN  rU  rX  r]  r&  rl  ro  rŠ  rŒ  r’   r›  r©  r¬  r°  r·  rº  rõ  r÷  r©   r1   r/   ú<module>r     sò  ðñó Û Û 	Û Û ß :Ñ :ß 4ß HÑ Hß 7Ñ 7Ý ß $ß 5Ó 5ã å ÷÷ ð Ð ð 
ˆ×	Ñ	˜HÓ	%€áÔãåGò5òò$9ò*ò0%òò'ò?ò'òFò&òEò$òAò$òIò&ò<ò#ò;ò"òJô4M3�+ô M3ñ` Ôß/Ð/ð: kð :°e¸DÀ¹IÐG^Ð<^Ñ6_ó :ð ñ9Ø˜‘ð9à(ð9ð 
ó	9ð '€M×&Ñ&ØØÙÐ'°[ÔAØ +× 6Ñ 6Ð7°q¸×9MÑ9MÐ8NÐOõ	ô	
�3˜ô 	
ô�lô ô
�ô 
÷-ñ -ò$ò,Añ,9�Nð 9°ð 9ÀSó 9ð ñ°4ò ó ðóNò*Ló*Lò*Pò*Pò$Lò"	cò	eñL¨8°D©>ó Lô^ ˜¨%õ  ðB+ T¨#¨s¨(¡^ð +¸ó +ð
°Cð ¸Dó ð89Ð&7ð 9¸cð 9È#ó 9ð	3Ð'8ð 	3¸só 	3òð2 Ù	�:Ô÷%ð %ó ó ð%ð"m¸Dô mô`&!�~õ &!r1   