
    wi|B                        d 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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 d
dl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' d
dl(m)Z) erd
dl*m+Z+  e j,        e-          Z. ej/        d          Z0dZ1dddZ2e G d d                      Z3e"	 	 	 	 d;dee3         dee4         de4de4dee4         dee4         deee4e4f                  deee4                  deee5         ee5         ee4         f         fd            Z6 G d  d!e          Z7 G d" d#e          Z8	 	 	 d<d$d%d&edee4         deee4e4f                  dee4         ddfd'Z9d(e5fd)Z:d*e5fd+Z;d,e5fd-Z<d$d%d.e4ddfd/Z=d$d%d0ed1e>d.e4ddf
d2Z?d0ed3e3d1e>dee4         fd4Z@d5ee         d6e4de8fd7ZAd$d%d8ee4         d1e>dee         fd9ZBd$d%d8ee4         d1e>dee         fd:ZCdS )=z.Git LFS related type definitions and utilities    N)	dataclass)ceil)getsize)Path)TYPE_CHECKINGBinaryIODictIterableListOptionalTuple	TypedDict)unquote)	constants   )build_hf_headersfix_hf_endpoint_in_urlget_sessionhf_raise_for_statushttp_backoffloggingtqdmvalidate_hf_hub_args)SliceFileObj)sha256sha_fileobj)is_tqdm_disabled)CommitOperationAddz^[0-9a-f]{40}$zlfs-multipart-uploadzapplication/vnd.git-lfs+json)AcceptzContent-Typec                       e Zd ZU dZeed<   eed<   eed<   edefd            Z	edefd            Z
ed	efd
            ZdS )
UploadInfoad  
    Dataclass holding required information to determine whether a blob
    should be uploaded to the hub using the LFS protocol or the regular protocol

    Args:
        sha256 (`bytes`):
            SHA256 hash of the blob
        size (`int`):
            Size in bytes of the blob
        sample (`bytes`):
            First 512 bytes of the blob
    r   sizesamplepathc                     t          |          }t          j        |d          5 }|                    d          d d         }t	          |          }d d d            n# 1 swxY w Y    | |||          S )Nrb   r"   r   r#   )r   ioopenpeekr   )clsr$   r"   filer#   shas         k/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/huggingface_hub/lfs.py	from_pathzUploadInfo.from_pathO   s    t}}WT4   	$DYYs^^DSD)Fd##C	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ 	$ sS8888s   -AA"%A"datac                     t          |                                          } | t          |          |d d         |          S )Nr'   )r"   r#   r   )r   digestlen)r,   r1   r.   s      r/   
from_byteszUploadInfo.from_bytesW   s>    Tll!!##sD		$tt*SAAAA    fileobjc                    |                     d          }|                    dt          j                   t	          |          }|                                }|                    dt          j                    | |||          S )Nr'   r   r(   )readseekr)   SEEK_SETr   tell)r,   r7   r#   r.   r"   s        r/   from_fileobjzUploadInfo.from_fileobj\   sp    c""Q$$$'""||~~Q$$$sS8888r6   N)__name__
__module____qualname____doc__bytes__annotations__intclassmethodstrr0   r5   r   r=    r6   r/   r!   r!   <   s           MMM
IIIMMM9S 9 9 9 [9 Be B B B [B 98 9 9 9 [9 9 9r6   r!   upload_infostoken	repo_typerepo_idrevisionendpointheaders	transfersreturnc                    ||nt           j        }d}|t           j        v rt           j        |         }| d| | d}	d||nddgd | D             d	d
}
|dt          |          i|
d<   i t          t          |          |pi }t                                          |	||
          }t          |           |	                                }|
                    dd          }t          |t                    st          d          |
                    d          }t          |t                    r|nd}d |D             d |D             |fS )a  
    Requests the LFS batch endpoint to retrieve upload instructions

    Learn more: https://github.com/git-lfs/git-lfs/blob/main/docs/api/batch.md

    Args:
        upload_infos (`Iterable` of `UploadInfo`):
            `UploadInfo` for the files that are being uploaded, typically obtained
            from `CommitOperationAdd.upload_info`
        repo_type (`str`):
            Type of the repo to upload to: `"model"`, `"dataset"` or `"space"`.
        repo_id (`str`):
            A namespace (user or an organization) and a repo name separated
            by a `/`.
        revision (`str`, *optional*):
            The git revision to upload to.
        headers (`dict`, *optional*):
            Additional headers to include in the request
        transfers (`list`, *optional*):
            List of transfer methods to use. Defaults to ["basic", "multipart"].

    Returns:
        `LfsBatchInfo`: 3-tuple:
            - First element is the list of upload instructions from the server
            - Second element is a list of errors, if any
            - Third element is the chosen transfer adapter if provided by the server (e.g. "basic", "multipart", "xet")

    Raises:
        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
            If an argument is invalid or the server response is malformed.
        [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
            If the server returned an error.
    N /z.git/info/lfs/objects/batchuploadbasic	multipartc                 P    g | ]#}|j                                         |j        d $S )oidr"   )r   hexr"   ).0rT   s     r/   
<listcomp>z'post_lfs_batch_info.<locals>.<listcomp>   sG     
 
 

  }((** 
 
 
r6   r   )	operationrO   objects	hash_algonameref)rI   rN   jsonr^   zMalformed response from servertransferc                 4    g | ]}d |vt          |          S error)_validate_batch_actionsr[   objs     r/   r\   z'post_lfs_batch_info.<locals>.<listcomp>   s+    OOO#G3<N<N	 	%	%<N<N<Nr6   c                 4    g | ]}d |v t          |          S rf   )_validate_batch_errorri   s     r/   r\   z'post_lfs_batch_info.<locals>.<listcomp>   s&    III'S..	s	#	#...r6   )r   ENDPOINTREPO_TYPES_URL_PREFIXESr   LFS_HEADERSr   r   postr   rc   get
isinstancelist
ValueErrorrF   )rH   rI   rJ   rK   rL   rM   rN   rO   
url_prefix	batch_urlpayloadresp
batch_infor^   chosen_transfers                  r/   post_lfs_batch_infor{   f   s   X $/xxY5GHJI5556yA
NNjN'NNNI"+"7YYg{=S
 

 '
 
 
  G  '("3"34


'
'
' =bG
 ==iwGGDJnnY--Ggt$$ ;9::: nnZ00O)3OS)I)ISootO 	POOOOIIwIII r6   c                   $    e Zd ZU eed<   eed<   dS )PayloadPartT
partNumberetagN)r>   r?   r@   rD   rC   rF   rG   r6   r/   r}   r}      s"         OOO
IIIIIr6   r}   c                   4    e Zd ZU dZeed<   ee         ed<   dS )CompletionPayloadTz?Payload that will be sent to the Hub when uploading multi-part.rY   partsN)r>   r?   r@   rA   rF   rC   r   r}   rG   r6   r/   r   r      s2         II	HHHr6   r   r]   r   lfs_batch_actionc                    t          |           |                    d          }|%t                              d| j         d           dS |d         d         }t          |           |d                             d          }|t          |           |                    di           }|                    d          }	t          |d	         |
          }
|	M	 t          |	          }	n(# t          t          f$ r t          d|	 d          w xY wt          | ||	|
           nt          | |
           |t          |           t          |d	         |          }t                                          |t          ||          | j        j                                        | j        j        d          }t'          |           t                              | j         d           dS )aw  
    Handles uploading a given object to the Hub with the LFS protocol.

    Can be a No-op if the content of the file is already present on the hub large file storage.

    Args:
        operation (`CommitOperationAdd`):
            The add operation triggering this upload.
        lfs_batch_action (`dict`):
            Upload instructions from the LFS batch endpoint for this object. See [`~utils.lfs.post_lfs_batch_info`] for
            more details.
        headers (`dict`, *optional*):
            Headers to include in the request, including authentication and user agent headers.

    Raises:
        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
            If `lfs_batch_action` is improperly formatted
        [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
            If the upload resulted in an error
    actionsNzContent of file z. is already present upstream - skipping uploadrT   verifyheader
chunk_sizehref)rM   zTMalformed response from LFS batch endpoint: `chunk_size` should be an integer. Got 'z'.)r]   r   r   
upload_url)r]   r   )rI   rN   rX   rb   z: Upload successful)rh   rq   loggerdebugpath_in_repo_validate_lfs_actionr   rD   rt   	TypeError_upload_multi_part_upload_single_partr   rp   r   upload_infor   rZ   r"   r   )r]   r   rI   rN   rM   r   upload_actionverify_actionr   r   r   
verify_urlverify_resps                r/   
lfs_uploadr      s   8 ,---""9--Gn	(>nnnooo %Y/9M'''$Y/33H==M ]+++ x,,FL))J'f(=QQQJ	ZJJI& 	 	 	ugquuu  	 	Yv*akllllliJGGGG  ]++++M&,A8LL
!mm(($5'BBB".599;;YEZE_`` ) 
 

 	K(((
LLI*???@@@@@s   C* *%D
lfs_actionc                     t          |                     d          t                    r=|                     d          7t          |                     d          t                    st	          d          | S ).validates response from the LFS batch endpointr   r   Nz"lfs_action is improperly formatted)rr   rq   rF   dictrt   )r   s    r/   r   r     se     	:>>&))3//?^^H%%-JNN8<T<TVZ1[1[-=>>>r6   lfs_batch_actionsc                    t          |                     d          t                    r(t          |                     d          t                    st	          d          |                     di                               d          }|                     di                               d          }|t          |           |t          |           | S )r   rY   r"   z)lfs_batch_actions is improperly formattedr   rT   r   )rr   rq   rF   rD   rt   r   )r   r   r   s      r/   rh   rh     s    (,,U33S99 FjIZI^I^_eIfIfhk>l>l FDEEE%)))R88<<XFFM%)))R88<<XFFM ]+++ ]+++r6   lfs_batch_errorc                    t          |                     d          t                    r(t          |                     d          t                    st	          d          |                     d          }t          |t
                    rPt          |                    d          t                    r(t          |                    d          t                    st	          d          | S )r   rY   r"   z'lfs_batch_error is improperly formattedrg   messagecode)rr   rq   rF   rD   rt   r   )r   
error_infos     r/   rl   rl   '  s    **511377 DJGZGZ[aGbGbdg<h<h DBCCC $$W--J:t$$Dz~~i00#66D z~~f--s33D
 BCCCr6   r   c                     |                      d          5 }t          d||          }t          |           ddd           dS # 1 swxY w Y   dS )a  
    Uploads `fileobj` as a single PUT HTTP request (basic LFS transfer protocol)

    Args:
        upload_url (`str`):
            The URL to PUT the file to.
        fileobj:
            The file-like object holding the data to upload.

    Returns: `requests.Response`

    Raises:
     [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError)
        If the upload resulted in an error.
    T	with_tqdmPUTr1   N)as_filer   r   )r]   r   r7   responses       r/   r   r   5  s      
		T		*	* &gz@@@H%%%& & & & & & & & & & & & & & & & & &s   "AA
A
r   r   c                    t          || j        |          }t          j        }t          j        rJt	          | j        t                    s0t	          | j        t                    st          j	        d           d}|rt          | ||          nt          | ||          }t                                          |t          || j        j                                                  t"                    }t%          |           dS )z@
    Uploads file using HF multipart LFS transfer protocol.
    )r   r   r   zlhf_transfer is enabled but does not support uploading from bytes or BinaryIO, falling back to regular uploadF)r]   sorted_parts_urlsr   )rc   rN   N)_get_sorted_parts_urlsr   r   HF_HUB_ENABLE_HF_TRANSFERrr   path_or_fileobjrF   r   warningswarn_upload_parts_hf_transfer_upload_parts_iterativelyr   rp   _get_completion_payloadr   rZ   ro   r   )r]   r   r   r   r   use_hf_transferresponse_headerscompletion_ress           r/   r   r   K  s   
 /f)J_lvwww  9O+	 94c::	  94d;;	 
 		
 	
 	
   	x!IIZgqrrrr&N_lvwww  !]]''$%5y7L7S7W7W7Y7YZZ (  N
 '''''r6   r   c                     d t          d |                                 D             d           D             }t          |          }|t          |j        |z            k    rt          d          |S )Nc                     g | ]\  }}|S rG   rG   )r[   _r   s      r/   r\   z*_get_sorted_parts_urls.<locals>.<listcomp>o  s,     
 
 
Az 	
 
 
r6   c                     g | ]>\  }}|                                 r%t          |          d k    ,t          |d          |f?S )r   
   )isdigitr4   rD   )r[   part_numr   s      r/   r\   z*_get_sorted_parts_urls.<locals>.<listcomp>r  s\       (Hj##%% +.h--!*;*; Xr""J/*;*;*;r6   c                     | d         S )Nr   rG   )ts    r/   <lambda>z(_get_sorted_parts_urls.<locals>.<lambda>w  s
    !A$ r6   )keyz0Invalid server response to upload large LFS file)sorteditemsr4   r   r"   rt   )r   r   r   sorted_part_upload_urls	num_partss        r/   r   r   n  s    
 
# ,2LLNN  
 
 
 

 
 
 +,,ID)J67777KLLL""r6   r   rY   c                     g }t          |           D ]U\  }}|                    d          }||dk    rt          d| d|dz              |                    |dz   |d           V||dS )Nr   rR   zInvalid etag (`z`) returned for part r   )r~   r   )rY   r   )	enumeraterq   rt   append)r   rY   r   part_numberr   r   s         r/   r   r     s     "E()9:: 	
 	
Vzz&!!<42::[t[[+XY/[[\\\)Ao 	
 	
 	
 	
 '''r6   r   c                 b   g }|                      d          5 }t          |          D ]m\  }}t          |||z  |          5 }t          d||          }t	          |           |                    |j                   d d d            n# 1 swxY w Y   n	 d d d            n# 1 swxY w Y   |S )NTr   )	seek_from
read_limitr   r   )r   r   r   r   r   r   rN   )	r]   r   r   rN   r7   part_idxpart_upload_urlfileobj_slicepart_upload_ress	            r/   r   r     sK    G			T		*	* 
8g)23D)E)E 		8 		8%Ho$x/%   8 ".uoM"Z"Z"Z#O44467778 8 8 8 8 8 8 8 8 8 8 8 8 8 8		8
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 Ns5   *B$<B?B$BB$BB$$B(+B(c                 t   	 ddl m} n# t          $ r t          d          w xY wdt	          j        |          j        v }|st          j        d           | j	        j
        }| j        }t          |          dk    rd|dd           }t          d	d
|d|t          t                                                    d          5 }	  |d| j        ||dddd|r	d|j        ini }n"# t&          $ r}	t)          d          |	d }	~	ww xY w|s|                    |           |cd d d            S # 1 swxY w Y   d S )Nr   )multipart_uploadzFast uploading using 'hf_transfer' is enabled (HF_HUB_ENABLE_HF_TRANSFER=1) but 'hf_transfer' package is not available in your environment. Try `pip install hf_transfer`.callbackzYou are using an outdated version of `hf_transfer`. Consider upgrading to latest version to enable progress bars using `pip install -U hf_transfer`.(   u   (…)iBTzhuggingface_hub.lfs_upload)unit
unit_scaletotalinitialdescdisabler`            )	file_path
parts_urlsr   	max_filesparallel_failuresmax_retriesz~An error occurred while uploading using `hf_transfer`. Consider disabling HF_HUB_ENABLE_HF_TRANSFER for better error handling.rG   )hf_transferr   ImportErrorrt   inspect	signature
parametersr   r   r   r"   r   r4   r   r   r   getEffectiveLevelr   update	ExceptionRuntimeError)
r]   r   r   r   supports_callbackr   r   progressoutputes
             r/   r   r     s   
0000000 
 
 
Q
 
 	

 #g&78H&I&I&TT 
 c	
 	
 	
 !&E!D
4yy2~~#tCDDz##	 !9!9!;!;<<)
 
 
  
	%% #3,%"%  5FMJ002 FF  	 	 	*  	
 ! 	#OOE"""5                 s>   	 #D-C&%D-&
D0D  DD--D14D1)NNNN)NNN)DrA   r   r)   rer   dataclassesr   mathr   os.pathr   pathlibr   typingr   r   r	   r
   r   r   r   r   urllib.parser   huggingface_hubr   utilsr   r   r   r   r   r   r   r   
utils._lfsr   	utils.shar   r   
utils.tqdmr   _commit_apir   
get_loggerr>   r   compile	OID_REGEXLFS_MULTIPART_UPLOAD_COMMANDro   r!   rF   r   r{   r}   r   r   r   rh   rl   r   rD   r   r   r   r   r   rG   r6   r/   <module>r     s\   5 4  				 				  ! ! ! ! ! !                   \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \             % % % % % %	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 % $ $ $ $ $ * * * * * * * * ( ( ( ( ( (  0//////		H	%	%BJ())	5  -2  &9 &9 &9 &9 &9 &9 &9 &9R  #"(,%)S S:&SC=S S 	S
 smS smS d38n%S S	"S 4:tDz8C=01S S S Sl    9   
         (,"CA CA#CACA C=CA d38n%	CA
 smCA 
CA CA CA CALT    t    4    &#7 &S &T & & & &, ("6  (  (RU  (cf  (ko  (  (  (  (F#4 #j #c #VZ[^V_ # # # #$(d4j (s (GY ( ( ( (#8<S	OR	$Z   $1#18<S	1OR1	$Z1 1 1 1 1 1r6   