Ë
    )täiÛ™  ã            $       óþ  — 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 ddlm	Z	 ddl
mZ ddlmZ ddlZddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZ ddlmZ dd	l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z* d
dl+m,Z,m-Z- d
dl.m/Z/m0Z0m1Z1m2Z2 dZ3dZ4dZ5 e-jl                  e7«      Z8 G d„ ded¬«      Z9 ejt                  dejv                  jy                  ejz                  d«      «      Z>dZ? e«       j€                  ZAdZBdZC	 	 	 dCdeDdeDdeDe	z  dz  deDdz  deDdz  f
d„ZEddddœd eDd!eFdeDdz  deDdz  d"eDeFz  dz  d#eGeD   fd$„ZHd%„ ZIdDd&eJeDz  dz  d#eDfd'„ZKd(eDdz  d)eDdz  d#eDdz  fd*„ZLdeDejš                  z  d+eDd#eDdz  fd,„ZN	 	 	 	 	 	 	 	 	 	 	 	 	 	 dEdeDejš                  z  d-eGeD   deDejš                  z  dz  d.eFd/eJeDeDf   dz  d"eFeDz  dz  deDdz  d!eFd0eDdeDdz  d&eDeJeDeDf   z  dz  d1eFd2eFd3eFd4eDdz  d5eOdz  d#eGeD   dz  f"d6„ZP	 	 	 dCdddd7œd8eDejš                  z  d+eDdeDdz  d/eJeDeDf   dz  d"eFeDz  dz  d!eFdeDe	z  dz  deDdz  fd9„ZQ G d:„ d;«      ZRd<eSeDz  fd=„ZT	 	 	 	 	 	 	 	 	 	 dFd>„ZUdGd eDd?eGeD   dz  d"eDdz  d#efd@„ZV G dA„ dB«      ZWy)Hz?
Hub utilities: utilities related to download and cache models
é    N)Úfutures)ÚPath)Ú	TypedDict)Úuuid4)Ú_CACHED_NO_EXISTÚCommitOperationAddÚ	ModelCardÚModelCardDataÚ	constantsÚcreate_branchÚcreate_commitÚcreate_repoÚhf_hub_downloadÚ
hf_hub_urlÚis_offline_modeÚlist_repo_treeÚsnapshot_downloadÚtry_to_load_from_cache)ÚREGEX_COMMIT_HASH)
ÚEntryNotFoundErrorÚGatedRepoErrorÚHfHubHTTPErrorÚLocalEntryNotFoundErrorÚOfflineModeIsEnabledÚRepositoryNotFoundErrorÚRevisionNotFoundErrorÚbuild_hf_headersÚget_sessionÚhf_raise_for_statusé   )Ú__version__Úlogging)ÚENV_VARS_TRUE_VALUESÚget_torch_versionÚis_torch_availableÚis_training_run_on_sagemakerzchat_template.jsonzchat_template.jinjaÚadditional_chat_templatesc                   ó¶   — e Zd ZU eej
                  z  dz  ed<   eed<   eeef   dz  ed<   eed<   eez  dz  ed<   edz  ed<   eed<   edz  ed	<   e	dz  ed
<   y)ÚDownloadKwargsNÚ	cache_dirÚforce_downloadÚproxiesÚlocal_files_onlyÚtokenÚrevisionÚ	subfolderÚcommit_hashÚ
tqdm_class)
Ú__name__Ú
__module__Ú__qualname__ÚstrÚosÚPathLikeÚ__annotations__ÚboolÚdictÚtype© ó    úe/Volumes/fast/ai/experiments/MLX_z-image/.venv/lib/python3.12/site-packages/transformers/utils/hub.pyr)   r)   L   sg   … Ø�R—[‘[Ñ  4Ñ'Ó'ØÓØ�#�s�(‰^˜dÑ"Ó"ØÓØ�‰:˜ÑÓØ�D‰jÓØƒNØ�t‘ÓØ�t‘Ôr>   r)   F)ÚtotalÚHF_MODULES_CACHEÚmodulesÚtransformers_modulesz3https://s3.amazonaws.com/models.huggingface.co/bertzhttps://cdn.huggingface.coÚpath_or_repo_idÚfull_filenamer*   r/   Ú	repo_typec                 ó>   — t        | ||||¬«      }|�|t        k7  r|S y )N©r*   r/   rF   )r   r   )rD   rE   r*   r/   rF   Úresolved_files         r?   Ú_get_cache_file_to_returnrJ   d   s3   € ô +Ø˜°)ÀhÐZcô€Mð Ð  ]Ô6FÒ%FØÐØr>   )r/   r*   r.   Úrepo_idr-   r.   Úreturnc                óv  — |s^	 t        | |t        d|¬«      D �cg c]?  }|j                  j                  d«      r"|j                  j	                  t        › d�«      ‘ŒA c}S 	 t        | ||d¬«      }t        |t        «      }|j                  «       sg S |j!                  «       D �cg c];  }|j#                  «       sŒ|j$                  j                  d«      sŒ0|j&                  ‘Œ= c}S c c}w # t
        t        t        f$ r ‚ t        t        t        j                  f$ r Y ŒÀw xY w# t        $ r g cY S w xY wc c}w )zöList template files from a repo.

    A template is a jinja file located under the `additional_chat_templates/` folder.
    If working in offline mode or if internet is down, the method will list jinja template from the local cache - if any.
    F)rK   r/   Úpath_in_repoÚ	recursiver.   z.jinjaÚ/T)rK   r/   r*   r-   )r   ÚCHAT_TEMPLATE_DIRÚpathÚendswithÚremoveprefixr   r   r   r   r   ÚhttpxÚNetworkErrorr   r   r   Úis_dirÚiterdirÚis_fileÚnameÚstem)rK   r-   r/   r*   r.   ÚentryÚsnapshot_dirÚtemplates_dirs           r?   Úlist_repo_templatesr_   t   sA  € ñ ð	ô ,Ø#Ø%Ü!2Ø#Øõó
ñ�Eð —:‘:×&Ñ& xÔ0ð —
‘
×'Ñ'Ô+<Ð*=¸QÐ(?Õ@ðñ
ð 
ð"Ü(Ø h¸)ÐVZô
ˆô
 ˜Ô'8Ó9€MØ×ÑÔ!Øˆ	Ø$1×$9Ñ$9Ô$;ÓqÑ$;˜5¸u¿}¹}½ÐSX×S]ÑS]×SfÑSfÐgoÕSpˆE�J‹JÐ$;ÑqÐqùò5
øô Ô 7Ô9NÐOò 	ØÜÔ 4´e×6HÑ6HÐIò 	Ùð	ûô #ò ØŠ	ðüò
 rsG   „C- šAC(ÁC- Á"D% Â%D6Â;D6ÃD6Ã(C- Ã-2D"Ä!D"Ä%D3Ä2D3c            	      ó8  — 	 t        j                  t        j                  d   «      j	                  «       } | d   }| d   j                  d«      d   }t	        j                  t        j                  dd«      «      }d|v }t        j                  d«      }|�|j                  d«      d	   nd }t        j                  d
d «      t        j                  dd «      t        j                  dd«      t        j                  dd«      ||||dœ}|S # t        $ r d }d }Y ŒÆw xY w)NÚECS_CONTAINER_METADATA_URIÚImageÚ:r    ÚSM_FRAMEWORK_PARAMSz{}Ú*sagemaker_distributed_dataparallel_enabledÚTRAINING_JOB_ARNé   ÚSM_FRAMEWORK_MODULEÚ
AWS_REGIONÚSM_NUM_GPUSÚ0ÚSM_NUM_CPUS)Úsm_frameworkÚ	sm_regionÚsm_number_gpuÚsm_number_cpuÚsm_distributed_trainingÚsm_deep_learning_containerÚsm_deep_learning_container_tagÚsm_account_id)	rU   Úgetr7   ÚenvironÚjsonÚsplitÚ	ExceptionÚloadsÚgetenv)Úinstance_dataÚdlc_container_usedÚdlc_tagÚsagemaker_paramsÚruns_distributed_trainingÚtraining_job_arnÚ
account_idÚsagemaker_objects           r?   Údefine_sagemaker_informationr„   ¡   s  € ðÜŸ	™	¤"§*¡*Ð-IÑ"JÓK×PÑPÓRˆØ*¨7Ñ3ÐØ Ñ(×.Ñ.¨sÓ3°AÑ6ˆô
 —z‘z¤"§)¡)Ð,AÀ4Ó"HÓIÐØ LÐP`Ð `ÐÜ—y‘yÐ!3Ó4ÐØ3CÐ3OÐ!×'Ñ'¨Ó,¨QÒ/ÐUY€Jô Ÿ	™	Ð"7¸Ó>Ü—Y‘Y˜|¨TÓ2ÜŸ™ =°#Ó6ÜŸ™ =°#Ó6Ø#<Ø&8Ø*1Ø#ñ	Ðð Ðøô' ò Ø!ÐØŠðús   ‚AD	 Ä	DÄDÚ
user_agentc                 ób  — dt         › dt        j                  j                  «       d   › dt        › �}t        «       r|dt        «       › �z  }t        j                  r|dz   S t        «       r4|ddj                  d„ t        «       j                  «       D «       «      z   z  }t        j                  j                  d	d
«      j!                  «       t"        v r|dz  }t%        | t&        «      r.|ddj                  d„ | j                  «       D «       «      z   z  }|S t%        | t(        «      r|d| z   z  }|S )zF
    Formats a user-agent string with basic info about a request.
    ztransformers/z	; python/r   z; session_id/z; torch/z; telemetry/offz; c              3   ó0   K  — | ]  \  }}|› d |› �–— Œ y­w©rP   Nr=   ©Ú.0ÚkÚvs      r?   Ú	<genexpr>z"http_user_agent.<locals>.<genexpr>Æ   s!   è ø€ Ð]Ñ6\©d¨a° !  A a SœzÑ6\ùó   ‚ÚTRANSFORMERS_IS_CIÚ z; is_ci/truec              3   ó0   K  — | ]  \  }}|› d |› �–— Œ y­wrˆ   r=   r‰   s      r?   r�   z"http_user_agent.<locals>.<genexpr>Ë   s!   è ø€ ÐIÑ6H©d¨a° !  A a SœzÑ6HùrŽ   )r!   ÚsysÚversionrx   Ú
SESSION_IDr%   r$   r   ÚHF_HUB_DISABLE_TELEMETRYr&   Újoinr„   Úitemsr7   rv   ru   Úupperr#   Ú
isinstancer;   r6   )r…   Úuas     r?   Úhttp_user_agentr›   ¼   s  € ð œ˜ Y¬s¯{©{×/@Ñ/@Ó/BÀ1Ñ/EÐ.FÀmÔT^ÐS_Ð	`€BÜÔØ
�Ô*Ó,Ð-Ð.Ñ.ˆÜ×)Ò)ØÐ%Ñ%Ð%Ü#Ô%Ø
ˆd�T—Y‘YÑ]Ô6RÓ6T×6ZÑ6ZÔ6\Ó]Ó]Ñ]Ñ]ˆä	‡z�z‡~�~Ð*¨BÓ/×5Ñ5Ó7Ô;OÑOØ
ˆnÑˆÜ�*œdÔ#Ø
ˆd�T—Y‘YÑI°j×6FÑ6FÔ6HÓIÓIÑIÑIˆð €Iô 
�J¤Ô	$Ø
ˆd�ZÑÑˆØ€Ir>   rI   r1   c                 óÜ   — | �|�|S t        t        | «      j                  «       «      } t        j                  d| «      }|€y|j                  «       d   }t        j                  |«      r|S dS )zP
    Extracts the commit hash from a resolved filename toward a cache file.
    Nzsnapshots/([^/]+)/r   )r6   r   Úas_posixÚreÚsearchÚgroupsr   Úmatch)rI   r1   rŸ   s      r?   Úextract_commit_hashr¢   Ñ   sn   € ð Ð Ð 7ØÐÜœ˜]Ó+×4Ñ4Ó6Ó7€MÜ�Y‰YÐ,¨mÓ<€FØ€~ØØ—-‘-“/ !Ñ$€KÜ+×1Ñ1°+Ô>ˆ;ÐHÀDÐHr>   Úfilenamec                 ó:   — t        d| |gdœ|¤Ž}|�|d   }|S |}|S )aç	  
    Tries to locate a file in a local folder and repo, downloads and cache it if necessary.

    Args:
        path_or_repo_id (`str` or `os.PathLike`):
            This can be either:
            - a string, the *model id* of a model repo on huggingface.co.
            - a path to a *directory* potentially containing the file.
        filename (`str`):
            The name of the file to locate in `path_or_repo`.
        cache_dir (`str` or `os.PathLike`, *optional*):
            Path to a directory in which a downloaded pretrained model configuration should be cached if the standard
            cache should not be used.
        force_download (`bool`, *optional*, defaults to `False`):
            Whether or not to force to (re-)download the configuration files and override the cached versions if they
            exist.
        proxies (`dict[str, str]`, *optional*):
            A dictionary of proxy servers to use by protocol or endpoint, e.g., `{'http': 'foo.bar:3128',
            'http://hostname': 'foo.bar:4012'}.` The proxies are used on each request.
        token (`str` or *bool*, *optional*):
            The token to use as HTTP bearer authorization for remote files. If `True`, will use the token generated
            when running `hf auth login` (stored in `~/.huggingface`).
        revision (`str`, *optional*, defaults to `"main"`):
            The specific model version to use. It can be a branch name, a tag name, or a commit id, since we use a
            git-based system for storing models and other artifacts on huggingface.co, so `revision` can be any
            identifier allowed by git.
        local_files_only (`bool`, *optional*, defaults to `False`):
            If `True`, will only try to load the tokenizer configuration from local files.
        subfolder (`str`, *optional*, defaults to `""`):
            In case the relevant files are located inside a subfolder of the model repo on huggingface.co, you can
            specify the folder name here.
        repo_type (`str`, *optional*):
            Specify the repo type (useful when downloading from a space for instance).

    <Tip>

    Passing `token=True` is required when you want to use a private model.

    </Tip>

    Returns:
        `Optional[str]`: Returns the resolved file (to the cache folder if downloaded from a repo).

    Examples:

    ```python
    # Download a model weight from the Hub and cache it.
    model_weights_file = cached_file("google-bert/bert-base-uncased", "pytorch_model.bin")
    ```
    )rD   Ú	filenamesr   r=   )Úcached_files)rD   r£   ÚkwargsÚfiles       r?   Úcached_filer©   ß   s;   € ôn ÐX¨ÀHÀ:ÑXÐQWÑX€DØÐ&ˆ4�‰7€DØ€Kð -1€DØ€Kr>   r¥   r+   r,   r0   Ú _raise_exceptions_for_gated_repoÚ%_raise_exceptions_for_missing_entriesÚ'_raise_exceptions_for_connection_errorsÚ_commit_hashr2   c                 óÄ	  — t        «       r|st        j                  d«       d}|€d}|D �cg c]"  }t        j                  j                  ||«      ‘Œ$ }}t        | «      } g }|D ]µ  }t        j                  j                  | «      sŒ#t        j                  j                  | |«      }t        j                  j                  |«      sC|r@|t        j                  j                  |d«      k7  r|€dn|}t        | › d|› d| › d	|› d
�«      ‚Œ¥|j                  |«       Œ· t        j                  j                  | «      r|r|S dS |€t        j                  }t        |t        «      rt        |«      }g }d}|�T|sR|D ]M  }t        | ||||	¬«      }|€Œ|t         ur|dz  }|j                  |«       Œ5|s|dz  }Œ=t        d|› d| › d�«      ‚ |t#        |«      k(  rt#        |«      dkD  r|S dS t%        |
«      }
	 t#        |«      dk(  r+t'        | |d   t#        |«      dk(  rdn||	|||
|||||¬«       nt)        | ||	|||
|||||¬«       |D �cg c]  }t9        | |||«      ‘Œ }}tE        d „ |D «       «      r“|r‘tG        ||«      D ��cg c]
  \  }}|�Œ	|‘Œ }}}t#        |«      dk(  r'|d   t        j                  j                  |d«      k(  ry|€dn|}t#        |«      dk(  rd!|d   › �nd"g |¢­› �}t        | › d#|› d| › d	|› d
�«      ‚|D �cg c]  }|€Œ|‘Œ	 }}t#        |«      dk(  rd}|S |}|S c c}w # t*        $ �r•}t        |t,        «      rt        |t.        «      st        | › d�«      |‚t        |t0        «      rt        |› d| › d�«      |‚t        |t2        «      rt        d|j4                  › d| › d�«      |‚t        |t6        «      rt        |› «      |‚|D �cg c]  }t9        | ||||	«      ‘Œ nc c}w }}t;        d„ |D «       «      r|cY d}~S t        |t.        «      r"|sY d}~yt        d| › dt        |«      › �«      |‚t        |t<        «      r'|sY d}~y|rit        dt        j>                  › d�«      |‚t        |t@        «      r)t        |tB        «      s|sY d}~yt        d| › d|› �«      |‚t        |tB        «      s|‚Y d}~�Œ‡d}~ww xY wc c}w c c}}w c c}w )$a¸  
    Tries to locate several files in a local folder and repo, downloads and cache them if necessary.

    Args:
        path_or_repo_id (`str` or `os.PathLike`):
            This can be either:
            - a string, the *model id* of a model repo on huggingface.co.
            - a path to a *directory* potentially containing the file.
        filenames (`list[str]`):
            The name of all the files to locate in `path_or_repo`.
        cache_dir (`str` or `os.PathLike`, *optional*):
            Path to a directory in which a downloaded pretrained model configuration should be cached if the standard
            cache should not be used.
        force_download (`bool`, *optional*, defaults to `False`):
            Whether or not to force to (re-)download the configuration files and override the cached versions if they
            exist.
        proxies (`dict[str, str]`, *optional*):
            A dictionary of proxy servers to use by protocol or endpoint, e.g., `{'http': 'foo.bar:3128',
            'http://hostname': 'foo.bar:4012'}.` The proxies are used on each request.
        token (`str` or *bool*, *optional*):
            The token to use as HTTP bearer authorization for remote files. If `True`, will use the token generated
            when running `hf auth login` (stored in `~/.huggingface`).
        revision (`str`, *optional*, defaults to `"main"`):
            The specific model version to use. It can be a branch name, a tag name, or a commit id, since we use a
            git-based system for storing models and other artifacts on huggingface.co, so `revision` can be any
            identifier allowed by git.
        local_files_only (`bool`, *optional*, defaults to `False`):
            If `True`, will only try to load the tokenizer configuration from local files.
        subfolder (`str`, *optional*, defaults to `""`):
            In case the relevant files are located inside a subfolder of the model repo on huggingface.co, you can
            specify the folder name here.
        repo_type (`str`, *optional*):
            Specify the repo type (useful when downloading from a space for instance).

    Private args:
        _raise_exceptions_for_gated_repo (`bool`):
            if False, do not raise an exception for gated repo error but return None.
        _raise_exceptions_for_missing_entries (`bool`):
            if False, do not raise an exception for missing entries but return None.
        _raise_exceptions_for_connection_errors (`bool`):
            if False, do not raise an exception for connection errors but return None.
        _commit_hash (`str`, *optional*):
            passed when we are chaining several calls to various files (e.g. when loading a tokenizer or
            a pipeline). If files are cached for this commit hash, avoid calls to head and get from the cache.

    <Tip>

    Passing `token=True` is required when you want to use a private model.

    </Tip>

    Returns:
        `Optional[str]`: Returns the resolved file (to the cache folder if downloaded from a repo).

    Examples:

    ```python
    # Download a model weight from the Hub and cache it.
    model_weights_file = cached_file("google-bert/bert-base-uncased", "pytorch_model.bin")
    ```
    z+Offline mode: forcing local_files_only=TrueTNr�   zconfig.jsonÚmainz& does not appear to have a file named z#. Checkout 'https://huggingface.co/z/tree/z' for available files.r   rH   r    zCould not locate z inside Ú.)
r0   rF   r/   r*   r…   r+   r,   r.   r-   r2   )
Úallow_patternsrF   r/   r*   r…   r+   r,   r.   r-   r2   a   is not a local folder and is not a valid model identifier listed on 'https://huggingface.co/models'
If this is a private repository, make sure to pass a token having permission to this repo either by logging in with `hf auth login` or by passing `token=<your_token>`ú• is not a valid git identifier (branch name, tag name or commit id) that exists for this model name. Check the model page at 'https://huggingface.co/ú' for available revisions.zPermissionError at z when downloading z¼. Check cache directory permissions. Common causes: 1) another user is downloading the same model (please wait); 2) a previous download was canceled and the lock file needs manual removal.c              3   ó$   K  — | ]  }|d u–— Œ
 y ­w©Nr=   ©rŠ   r¨   s     r?   r�   zcached_files.<locals>.<genexpr>à  s   è ø€ Ð;©N Dˆt˜4Ô©Nùó   ‚z`You are trying to access a gated repo.
Make sure to have access to it at https://huggingface.co/z.
zWe couldn't connect to 'zÖ' to load the files, and couldn't find them in the cached files.
Check your internet connection or see how to run the library in offline mode at 'https://huggingface.co/docs/transformers/installation#offline-mode'.z:There was a specific connection error when trying to load z:
c              3   ó$   K  — | ]  }|d u –— Œ
 y ­wrµ   r=   r¶   s     r?   r�   zcached_files.<locals>.<genexpr>  s   è ø€ Ð
3¡N˜Dˆ4�4Œ<¡Nùr·   za file named zfiles named z does not appear to have )$r   ÚloggerÚinfor7   rR   r–   r6   ÚisdirÚisfileÚOSErrorÚappendr   ÚHF_HUB_CACHEr™   r   r   r   Úlenr›   r   r   ry   r   r   r   ÚPermissionErrorr£   Ú
ValueErrorrJ   Úallr   ÚENDPOINTr   r   ÚanyÚzip)rD   r¥   r*   r+   r,   r.   r/   r-   r0   rF   r…   rª   r«   r¬   r­   r2   Údeprecated_kwargsr¨   Úfull_filenamesÚexisting_filesr£   rI   Ú	revision_Úfile_counterÚeÚresolved_filesÚoriginalÚresolvedÚmissing_entriesÚmsgs                                 r?   r¦   r¦     sé  € ô` ÔÑ!1Ü�‰ÐAÔBØÐØÐØˆ	ñ AJÓJÁ	¸”b—g‘g—l‘l 9¨dÕ3À	€NÐJä˜/Ó*€OØ€NÛ"ˆÜ�7‰7�=‰=˜Õ)ÜŸG™GŸL™L¨¸(ÓCˆMÜ—7‘7—>‘> -Ô0Ù8¸XÌÏÉÏÉÐV_ÐanÓIoÒ=oØ*2Ð*:¡À�IÜ!Ø*Ð+Ð+QÐRZÐQ[ð \3Ø3BÐ2CÀ6È)ÈÐTjðlóð ð
 Ø×!Ñ! -Õ0ð #ô 
‡w�w‡}�}�_Ô%Ù!/ˆ~Ð9°TÐ9àÐÜ×*Ñ*ˆ	Ü�)œTÔ"Ü˜	“Nˆ	à€NØ€LØÐ©Û&ˆHä2Ø °YÈÐajôˆMð Ñ(Ø Ô(8Ñ8Ø  AÑ%�LØ"×)Ñ)¨-Õ8Ù>Ø  AÑ%‘Lä!Ð$5°h°Z¸xÈÐGXÐXYÐ"ZÓ[Ð[ð 'ð ”s˜>Ó*Ò*Ü!$ ^Ó!4°qÒ!8ˆ~ÐB¸dÐBä  Ó,€Jð]Üˆ~Ó !Ò#äØØ˜!‘Ü"% i£.°AÒ"5™$¸9Ø#Ø!Ø#Ø%Ø-ØØØ!1Ø%öô ØØ-Ø#Ø!Ø#Ø%Ø-ØØØ!1Ø%õñ\ cqóÙbpÐV^Ô! /°8¸YÈÕQÐbpð ð ô Ñ
3¡NÓ
3Ô3Ñ8]Ü>AÀ.ÐR`Ô>aÔvÑ>aÑ(:¨°(ÐemÑeuš8Ð>aˆÑväˆ~Ó !Ò#¨¸Ñ(:¼b¿g¹g¿l¹lÈ9ÐVcÓ>dÒ(dØà&Ð.‘F°Hˆ	ä47¸Ó4HÈAÒ4Mˆm˜O¨AÑ.Ð/Ñ0ÐUaÐbuÐdsÑbuÐavÐSwð 	ô ØÐÐ8¸¸Ð=`ÐapÐ`qÐqwð  yBð  xCð C$ð $ó
ð 	
ñ (6ÓJ¡~˜t¸Ñ9I’d ~€NÐJä  Ó0°AÒ5�T€NàÐð <J€NàÐùòQ Køôb ó =ä�aÔ0Ô1¼*ÀQÌÔ:WÜØ"Ð#ð $'ð 'óð
 ðô ˜Ô0Ô1ÜØ�*ð +à+:Ð*;Ð;UðWóð ð	ô
 ˜œ?Ô+ÜØ% a§j¡j \Ð1CÀOÐCTð U^ð ^óð ð	ô
 ˜œ:Ô&Ü˜Q˜C“/ qÐ(ñ
 +ó
á*�ô & o°xÀÈHÐV_Õ`Ù*ùò
ˆð 
ô Ñ;©NÓ;Ô;Ø!Õ!ô �aœÔ(Ù3ÜÜð*Ø*9Ð):¸#¼cÀ!»f¸XðGóð ðô ˜Ô2Ô3Ù:Üñ 7ÜØ.¬y×/AÑ/AÐ.Bð C]ð ]óð ð	ô ˜œ>Ô*´:¸aÔASÔ3TÙ:ÜÜÐVÐWfÐVgÐgjÐklÐjmÐnÓoÐuvÐvô ˜AÔ1Ô2ØˆGÿùð{=üò~ùó
 wùò Ksh   ¬'L+Ç4AL0 ÉSÊ
SÊSÌSÌSÌ0
SÌ:BS
ÏO0Ï/S
Ð
SÐS
Ð'-S
ÑAS
Ò $S
Ó
S)r-   r*   rF   Úpath_or_repoc                ó€  — t         j                  j                  | «      r=t         j                  j                  t         j                  j	                  | |«      «      S t        | ||||¬«      }	t        |	t        «      }
|r|
S 	 t        «       j                  t        | |||¬«      t        |t        «       ¬«      dd¬«      }	 t%        |«       y# t        j                  $ r ‚ t        j                  t        j                   t"        f$ r |
cY S w xY w# t&        $ r,}t(        j+                  |«       t-        | › d| › d	�«      |‚d
}~wt.        $ r)}t(        j+                  |«       t-        | › d�«      |‚d
}~wt0        $ r,}t(        j+                  |«       t-        |› d| › d�«      |‚d
}~wt2        $ r Y yt4        $ r |
cY S w xY w)aŸ  
    Checks if a repo contains a given file without downloading it. Works for remote repos and local folders.

    If offline mode is enabled, checks if the file exists in the cache.

    <Tip warning={false}>

    This function will raise an error if the repository `path_or_repo` is not valid or if `revision` does not exist for
    this repo, but will return False for regular connection errors.

    </Tip>
    )rK   r£   r/   rF   r*   )r£   r/   rF   )r.   r…   Fé
   )ÚheadersÚfollow_redirectsÚtimeoutTzN is a gated repository. Make sure to request access at https://huggingface.co/z~ and pass a token having permission to this repo either by logging in with `hf auth login` or by passing `token=<your_token>`.NzE is not a local folder or a valid repository name on 'https://hf.co'.r²   r³   )r7   rR   r»   r¼   r–   r   r™   r6   r   Úheadr   r   r›   rU   Ú
ProxyErrorÚConnectErrorÚTimeoutExceptionr   r   r   r¹   Úerrorr½   r   r   r   r   )rÒ   r£   r/   r,   r.   r-   r*   rF   rÇ   Úcached_pathÚhas_file_in_cacheÚresponserÌ   s                r?   Úhas_filerà     sÅ  € ô2 
‡w�w‡}�}�\Ô"Ü�w‰w�~‰~œbŸg™gŸl™l¨<¸ÓBÓCÐCô )ØØØØØô€Kô # ;´Ó4Ðñ Ø Ð ð!Ü“=×%Ñ%Ü�|¨hÀÐU^Ô_Ü$¨5¼_Ó=NÔOØ"Øð	 &ó 
ˆð!Ü˜HÔ%Øøô ×Ñò àÜ×Ñ¤× 6Ñ 6Ô8LÐMò !Ø Ò ð!ûô ò Ü�‰�QŒÜØˆnð &Ø&2 ^ð 4RðRó
ð ð		ûô
 #ò uÜ�‰�QŒÜ˜˜Ð&kÐlÓmÐstÐtûÜ ò Ü�‰�QŒÜØˆjð KØKWÈ.ÐXrðtó
ð ð	ûô ò ÙÜò !à Ò ð!úsN   Â=C Ã D Ã=DÄDÄ	F=Ä'D?Ä?F=Å$E/Å/F=Å;'F"Æ"F=Æ0
F=Æ<F=c                   ó2  — e Zd ZdZdeej                  z  fd„Z	 	 	 	 	 ddeej                  z  dedeee	f   dedz  d	e
ez  dz  d
e
dedz  dedz  fd„Zd„ Zdddddddddœdededz  dedz  de
dz  d	e
ez  dz  dedz  d
e
deez  dz  dee   dz  defd„Zy)ÚPushToHubMixinzW
    A Mixin containing the functionality to push a model or tokenizer to the hub.
    Úworking_dirc           
      óÊ   — t        j                  |«      D �ci c]@  }|t         j                  j                  t         j                  j	                  ||«      «      “ŒB c}S c c}w )zS
        Returns the list of files with their last modification timestamp.
        )r7   ÚlistdirrR   Úgetmtimer–   )Úselfrã   Úfs      r?   Ú_get_files_timestampsz$PushToHubMixin._get_files_timestampsw  sM   € ô LNÏ:É:ÐVaÔKbÓcÑKbÀa�”2—7‘7×#Ñ#¤B§G¡G§L¡L°¸aÓ$@ÓAÑAÐKbÑcÐcùÒcs   ˜AA NFrK   Úfiles_timestampsÚcommit_messager.   Ú	create_prr/   Úcommit_descriptionc	                 óŠ  — |€ d| j                   j                  v rd}n…d| j                   j                  v rd}njd| j                   j                  v rd}nOd| j                   j                  v rd	}n4d
| j                   j                  v rd}nd| j                   j                  › �}t        j                  |«      D �	cg c]K  }	|	|vsCt        j                  j                  t        j                  j                  ||	«      «      ||	   kD  r|	‘ŒM }
}	|
D �	cg c]~  }	t        j                  j                  t        j                  j                  ||	«      «      s=t        j                  j                  t        j                  j                  ||	«      «      r|	‘Œ€ }
}	g }|
D �]  }t        j                  j                  t        j                  j                  ||«      «      r’t        j                  t        j                  j                  ||«      «      D ][  }	|j                  t        t        j                  j                  |||	«      t        j                  j                  ||	«      ¬«      «       Œ] ŒÓ|j                  t        t        j                  j                  ||«      |¬«      «       �Œ |�!|j                  d«      s	 t        |||d¬«       t         j#                  d|› ddj                  |
«      › �«       t%        |||||||¬«      S c c}	w c c}	w # t        $ r'}|j                  j                  dk(  r|rn‚ Y d}~Œqd}~ww xY w)zh
        Uploads all modified files in `working_dir` to `repo_id`, based on `files_timestamps`.
        NÚModelzUpload modelÚConfigzUpload configÚ	TokenizerzUpload tokenizerÚFeatureExtractorzUpload feature extractorÚ	ProcessorzUpload processorzUpload )Úpath_or_fileobjrN   zrefs/prT)rK   Úbranchr.   Úexist_oki“  z!Uploading the following files to z: Ú,)rK   Ú
operationsrë   rí   r.   rì   r/   )Ú	__class__r3   r7   rå   rR   ræ   r–   r¼   r»   r¾   r   Ú
startswithr   r   rß   Ústatus_coder¹   rº   r   )rç   rã   rK   rê   rë   r.   rì   r/   rí   rè   Úmodified_filesrø   r¨   rÌ   s                 r?   Ú_upload_modified_filesz%PushToHubMixin._upload_modified_files}  sÅ  € ð Ð!Ø˜$Ÿ.™.×1Ñ1Ñ1Ø!/‘Ø˜TŸ^™^×4Ñ4Ñ4Ø!0‘Ø §¡× 7Ñ 7Ñ7Ø!3‘Ø# t§~¡~×'>Ñ'>Ñ>Ø!;‘Ø §¡× 7Ñ 7Ñ7Ø!3‘à#*¨4¯>©>×+BÑ+BÐ*CÐ!D�ô —Z‘Z Ô,ó
á,�ØÐ(Ñ(¬B¯G©G×,<Ñ,<¼R¿W¹W¿\¹\È+ÐWXÓ=YÓ,ZÐ]mÐnoÑ]pÒ,pò Ø,ð 	ð 
ñ $ó
á#�Ü�w‰w�~‰~œbŸg™gŸl™l¨;¸Ó:Ô;¼r¿w¹w¿}¹}ÌRÏWÉWÏ\É\ÐZeÐghÓMiÔ?jò Ø#ð 	ð 
ð ˆ
ä"ˆDÜ�w‰w�}‰}œRŸW™WŸ\™\¨+°tÓ<Ô=äŸ™¤B§G¡G§L¡L°¸dÓ$CÖD�AØ×%Ñ%Ü*Ü,.¯G©G¯L©L¸ÀdÈAÓ,NÔ]_×]dÑ]d×]iÑ]iÐjnÐpqÓ]rôõñ Eð ×!Ñ!Ü&´r·w±w·|±|ÀKÐQUÓ7VÐeiÔjöð #ð Ð¨×(;Ñ(;¸IÔ(Fð	Ü g°hÀeÐVZÕ[ô 	�‰Ð7¸°yÀÀ3Ç8Á8ÈNÓC[ÐB\Ð]Ô^ÜØØ!Ø)Ø1ØØØô
ð 	
ùòU
ùò
øô2 "ò Ø—:‘:×)Ñ)¨SÒ0±Yð àô ûðús&   Â:ALÄBLÊ=L Ì	MÌL=Ì=Mc                 óF   — t        | j                  j                  › d�«      ‚)Nz7 must implement `save_pretrained` to use `push_to_hub`.)ÚNotImplementedErrorrù   r3   )rç   Úargsr§   s      r?   Úsave_pretrainedzPushToHubMixin.save_pretrainedÌ  s    € ä! T§^¡^×%<Ñ%<Ð$=Ð=tÐ"uÓvÐvr>   Ú50GB)rë   rí   Úprivater.   r/   rì   Úmax_shard_sizeÚtagsr  r  r  rL   c                óZ  — t        |||d¬«      j                  }t        ||	|¬«      }
t        j                  «       5 }| j                  ||¬«       |
j                  t        j                  j                  |d«      «       | j                  ||i |||||¬«      cddd«       S # 1 sw Y   yxY w)u‹  
        Upload the {object_files} to the ðŸ¤— Model Hub.

        Parameters:
            repo_id (`str`):
                The name of the repository you want to push your {object} to. It should contain your organization name
                when pushing to a given organization.
            commit_message (`str`, *optional*):
                Message to commit while pushing. Will default to `"Upload {object}"`.
            commit_description (`str`, *optional*):
                The description of the commit that will be created
            private (`bool`, *optional*):
                Whether to make the repo private. If `None` (default), the repo will be public unless the organization's default is private. This value is ignored if the repo already exists.
            token (`bool` or `str`, *optional*):
                The token to use as HTTP bearer authorization for remote files. If `True` (default), will use the token generated
                when running `hf auth login` (stored in `~/.huggingface`).
            revision (`str`, *optional*):
                Branch to push the uploaded files to.
            create_pr (`bool`, *optional*, defaults to `False`):
                Whether or not to create a PR with the uploaded files or directly commit.
            max_shard_size (`int` or `str`, *optional*, defaults to `"50GB"`):
                Only applicable for models. The maximum size for a checkpoint before being sharded. Checkpoints shard
                will then be each of size lower than this size. If expressed as a string, needs to be digits followed
                by a unit (like `"5MB"`).
            tags (`list[str]`, *optional*):
                List of tags to push on the Hub.

        Examples:

        ```python
        from transformers import {object_class}

        {object} = {object_class}.from_pretrained("google-bert/bert-base-cased")

        # Push the {object} to your namespace with the name "my-finetuned-bert".
        {object}.push_to_hub("my-finetuned-bert")

        # Push the {object} to an organization with the name "my-finetuned-bert".
        {object}.push_to_hub("huggingface/my-finetuned-bert")
        ```
        T)r  r.   rö   ©r.   )r  z	README.md)rê   rë   r.   rì   r/   rí   N)r   rK   Úcreate_and_tag_model_cardÚtempfileÚTemporaryDirectoryr  Úsaver7   rR   r–   rý   )rç   rK   rë   rí   r  r.   r/   rì   r  r  Ú
model_cardÚtmp_dirs               r?   Úpush_to_hubzPushToHubMixin.push_to_hubÐ  s¢   € ôt ˜g¨w¸eÈdÔS×[Ñ[ˆô /¨w¸ÀEÔJˆ
ä×(Ñ(Ô*¨gà× Ñ  ¸Ð ÔHð �O‰OœBŸG™GŸL™L¨°+Ó>Ô?ð ×.Ñ.ØØØ!#Ø-ØØ#Ø!Ø#5ð /ó 	÷ +×*Ò*ús   ¼AB!Â!B*)NNFNN)r3   r4   r5   Ú__doc__r6   r7   r8   ré   r;   Úfloatr:   rý   r  ÚintÚlistr  r=   r>   r?   râ   râ   r  sp  „ ñðd°°r·{±{Ñ1Bó dð &*Ø#'ØØ#Ø)-ñM
à˜2Ÿ;™;Ñ&ðM
ð ðM
ð ˜s E˜zÑ*ð	M
ð
 ˜d™
ðM
ð �c‰z˜DÑ ðM
ð ðM
ð ˜‘*ðM
ð   $™JóM
ò^wð &*Ø)-à#Ø#'Ø#Øà+1Ø!%òPàðPð
 ˜d™
ðPð   $™JðPð ˜‘ðPð �c‰z˜DÑ ðPð ˜‘*ðPð ðPð ˜c™	 DÑ(ðPð �3‰i˜$ÑðPð 
ôPr>   râ   Úsizec                 ó  — t        | t        «      r| S | j                  «       j                  d«      rt        | dd «      dz  S | j                  «       j                  d«      rt        | dd «      dz  S | j                  «       j                  d«      rt        | dd «      dz  S | j                  «       j                  d	«      r)t        | dd
 «      dz  }| j                  d«      r|dz  S |S | j                  «       j                  d«      r)t        | dd
 «      dz  }| j                  d«      r|dz  S |S | j                  «       j                  d«      r)t        | dd
 «      dz  }| j                  d«      r|dz  S |S t	        d«      ‚)a'  
    Converts a size expressed as a string with digits an unit (like `"5MB"`) to an integer (in bytes).

    Args:
        size (`int` or `str`): The size to convert. Will be directly returned if an `int`.

    Example:
    ```py
    >>> convert_file_size_to_int("1MiB")
    1048576
    ```
    ÚGIBNéýÿÿÿi   @ÚMIBi   ÚKIBi   ÚGBéþÿÿÿi Êš;Úbé   ÚMBi@B ÚKBiè  zR`size` is not in a valid format. Use an integer followed by the unit, e.g., '5GB'.)r™   r  r˜   rS   rÂ   )r  Úint_sizes     r?   Úconvert_file_size_to_intr   #  s`  € ô �$œÔØˆØ‡z�zƒ|×Ñ˜UÔ#Ü�4˜˜�9‹~ Ñ'Ð'Ø‡z�zƒ|×Ñ˜UÔ#Ü�4˜˜�9‹~ Ñ'Ð'Ø‡z�zƒ|×Ñ˜UÔ#Ü�4˜˜�9‹~ Ñ'Ð'Ø‡z�zƒ|×Ñ˜TÔ"Ü�t˜C˜R�y“> UÑ+ˆØ $§¡¨cÔ 2ˆx˜1‰}Ð@¸Ð@Ø‡z�zƒ|×Ñ˜TÔ"Ü�t˜C˜R�y“> UÑ+ˆØ $§¡¨cÔ 2ˆx˜1‰}Ð@¸Ð@Ø‡z�zƒ|×Ñ˜TÔ"Ü�t˜C˜R�y“> UÑ+ˆØ $§¡¨cÔ 2ˆx˜1‰}Ð@¸Ð@Ü
ÐiÓ
jÐjr>   c                 óŠ  — t         j                  j                  |«      st        d|› d| › d�«      ‚t	        |«      5 }t        j                  |j                  «       «      }ddd«       t        t        d   j                  «       «      «      }|d   }t        |d   j                  «       «      |d<   |d   j                  «       |d<   t         j                  j                  | «      r2|D �cg c]#  }t         j                  j                  | |	|«      ‘Œ% }}||fS t!        | |||||||||	|
|¬«      }||fS # 1 sw Y   ŒÔxY wc c}w )	aÃ  
    For a given model:

    - download and cache all the shards of a sharded checkpoint if `pretrained_model_name_or_path` is a model ID on the
      Hub
    - returns the list of paths to all the shards, as well as some metadata.

    For the description of each arg, see [`PreTrainedModel.from_pretrained`]. `index_filename` is the full path to the
    index (downloaded and cached if `pretrained_model_name_or_path` is a model ID on the Hub).
    zCan't find a checkpoint index (z) in r°   NÚ
weight_mapÚmetadataÚall_checkpoint_keys)
r*   r+   r,   r-   r.   r…   r/   r0   r­   r2   )r7   rR   r¼   rÂ   Úopenrw   rz   ÚreadÚsortedÚsetÚvaluesr  ÚkeysÚcopyr»   r–   r¦   )Úpretrained_model_name_or_pathÚindex_filenamer*   r+   r,   r-   r.   r…   r/   r0   r­   r2   rÇ   rè   ÚindexÚshard_filenamesÚsharded_metadataÚcached_filenamess                     r?   Úget_checkpoint_shard_filesr2  D  sN  € ô2 �7‰7�>‰>˜.Ô)ÜÐ:¸>Ð:JÈ%ÐPmÐOnÐnoÐpÓqÐqä	ˆnÔ	 Ü—
‘
˜1Ÿ6™6›8Ó$ˆ÷ 
ô œS  |Ñ!4×!;Ñ!;Ó!=Ó>Ó?€OØ˜ZÑ(ÐÜ.2°5¸Ñ3F×3KÑ3KÓ3MÓ.NÐÐ*Ñ+Ø%*¨<Ñ%8×%=Ñ%=Ó%?Ð�\Ñ"ô 
‡w�w‡}�}Ð2Ô3Ù^mÓnÑ^mÐYZœ2Ÿ7™7Ÿ<™<Ð(EÀyÐRSÕTÐ^mˆÐnØÐ 0Ð0Ð0ô $Ø%ØØØ%ØØ)ØØØØØ!ØôÐð Ð-Ð-Ð-÷= 
Ð	üò os   ½$D4Ã+(E Ä4D=r  c                 ó„  — 	 t        j                  | |¬«      }|�l|j
                  j                  €g |j
                  _        |D ]@  }||j
                  j                  vsŒ|j
                  j                  j                  |«       ŒB |S # t        $ r- d}t        |€g n|d¬«      }t        j                  ||¬«      }Y Œ¥w xY w)a•  
    Creates or loads an existing model card and tags it.

    Args:
        repo_id (`str`):
            The repo_id where to look for the model card.
        tags (`list[str]`, *optional*):
            The list of tags to add in the model card
        token (`str`, *optional*):
            Authentication token, obtained with `huggingface_hub.HfApi.login` method. Will default to the stored token.
    r  u†   This is the model card of a ðŸ¤— transformers model that has been pushed on the Hub. This model card has been automatically generated.Útransformers)r  Úlibrary_name)Úmodel_description)r	   Úloadr   r
   Úfrom_templateÚdatar  r¾   )rK   r  r.   r  r6  Ú	card_dataÚ	model_tags          r?   r  r  �  sº   € ð]ä—^‘^ G°5Ô9ˆ
ð Ðà�?‰?×ÑÐ'Ø#%ˆJ�O‰OÔ ÛˆIØ 
§¡× 4Ñ 4Ò4Ø—‘×$Ñ$×+Ñ+¨IÕ6ð ð Ðøô ò ]ð eÐÜ!¨T¨\¡r¸tÐR`Ôaˆ	Ü×,Ñ,¨YÐJ[Ô\Š
ð	]ús   ‚B	 Â	3B?Â>B?c                   óP   — e Zd ZdZd	dej
                  dz  ddfd„Zd„ Zd„ Zd
d„Z	y)ÚPushInProgresszj
    Internal class to keep track of a push in progress (which might contain multiple `Future` jobs).
    NÚjobsrL   c                 ó&   — |€g | _         y || _         y rµ   )r>  )rç   r>  s     r?   Ú__init__zPushInProgress.__init__¦  s   € Ø˜,�Bˆ�	¨Dˆ�	r>   c                 ó:   — t        d„ | j                  D «       «      S )Nc              3   ó<   K  — | ]  }|j                  «       –— Œ y ­wrµ   )Údone)rŠ   Újobs     r?   r�   z)PushInProgress.is_done.<locals>.<genexpr>ª  s   è ø€ Ð3© #�3—8‘8—:©ùs   ‚)rÃ   r>  ©rç   s    r?   Úis_donezPushInProgress.is_done©  s   € ÜÑ3¨¯ªÓ3Ó3Ð3r>   c                 óB   — t        j                  | j                  «       y rµ   )r   Úwaitr>  rE  s    r?   Úwait_until_donezPushInProgress.wait_until_done¬  s   € Ü�‰�T—Y‘YÕr>   c                 óŒ   — | j                   D �cg c]$  }|j                  «       s|j                  «       s|‘Œ& c}| _         y c c}w rµ   )r>  ÚcancelrC  )rç   rD  s     r?   rK  zPushInProgress.cancel¯  s=   € ð —y’yó
á �à—J‘J”L C§H¡H¤Jò Ø ñ
ˆ�	ùò 
s   �)Arµ   )rL   N)
r3   r4   r5   r  r   ÚFuturer@  rF  rI  rK  r=   r>   r?   r=  r=  ¡  s2   „ ññ1˜WŸ^™^¨dÑ2ð 1¸dó 1ò4ò ô
r>   r=  )NNNrµ   )NFNNNFr�   NNTTTNN)
NFNFNNNr�   NN)NN)Xr  rw   r7   rž   r’   r	  Ú
concurrentr   Úpathlibr   Útypingr   Úuuidr   rU   Úhuggingface_hubr   r   r	   r
   r   r   r   r   r   r   r   r   r   r   Úhuggingface_hub.file_downloadr   Úhuggingface_hub.utilsr   r   r   r   r   r   r   r   r   r   r�   r!   r"   Úimport_utilsr#   r$   r%   r&   Ú#LEGACY_PROCESSOR_CHAT_TEMPLATE_FILEÚCHAT_TEMPLATE_FILErQ   Ú
get_loggerr3   r¹   r)   r{   rR   r–   ÚHF_HOMErA   Ú TRANSFORMERS_DYNAMIC_MODULE_NAMEÚhexr”   ÚS3_BUCKET_PREFIXÚCLOUDFRONT_DISTRIB_PREFIXr6   rJ   r:   r  r_   r„   r;   r›   r¢   r8   r©   r<   r¦   rà   râ   r  r   r2  r  r=  r=   r>   r?   Ú<module>r]     s  ðñó Û 	Û 	Û 
Û Ý Ý Ý Ý ã ÷÷ ÷ ÷ õ  <÷÷ ÷ ÷ #÷ó ð ';Ð #Ø*Ð Ø/Ð ð 
ˆ×	Ñ	˜HÓ	%€ô	�Y eõ 	ð  �2—9‘9Ð/°·±·±¸i×>OÑ>OÐQZÓ1[Ó\Ð Ø#9Ð  Ù‹W�[‰[€
àHÐ Ø8Ð ð $(ØØ ñØðàðð �T‰z˜DÑ ðð �D‰jð	ð
 �T‰zóð(  Ø Ø#ò*rØð*rð ð*rð �D‰jð	*rð
 �T‰zð*rð �‰:˜Ñð*rð 
ˆ#�Yó*ròZñ6  s¡
¨TÑ 1ð ¸Só ð*I s¨T¡zð IÀÀdÁ
ð IÈsÐUYÉzó Ið9Ø˜2Ÿ;™;Ñ&ð9àð9ð 	ˆ4�Zó	9ð~ +/Ø Ø%)Ø#ØØ"ØØ Ø.2Ø-1Ø26Ø48Ø#Ø"ñ!Ø˜2Ÿ;™;Ñ&ðà�C‰yðð �R—[‘[Ñ  4Ñ'ðð ð	ð
 �#�s�(‰^˜dÑ"ðð �#‰:˜Ñðð �D‰jðð ðð ðð �T‰zðð �d˜3 ˜8‘nÑ$ tÑ+ðð '+ðð ,0ðð .2ðð ˜‘*ðð  �t‘ð!ð$ 
ˆ#�Y�Ñó%ðJ  Ø%)Ø#ðR!ð #Ø#'Ø òR!Ø˜Ÿ™Ñ#ðR!àðR!ð �D‰jðR!ð �#�s�(‰^˜dÑ"ð	R!ð
 �#‰:˜ÑðR!ð ðR!ð �T‰z˜DÑ ðR!ð �T‰zóR!÷jnñ nðbk 3¨¡9ó kðH ØØØØ
ØØØØØó:.ñz sð °$°s±)¸dÑ2Bð ÐRUÐX\ÑR\ð Ðhqó ÷@
ò 
r>   