
    Ki3                     6   S SK r S SKrS SKrS SKJrJrJrJr  S SKJ	r	  SSK
JrJr  SSKJrJr  \R                   \R"                  \R$                  \R&                  \R(                  S.r " S S	\5      r " S
 S\5      r " S S\5      r " S S\5      rSS jrg)    N)FTPFTP_TLSError
error_perm)Any   )AbstractBufferedFileAbstractFileSystem)infer_storage_options
isfilelike)tlstlsv1tlsv1_1tlsv1_2sslv23c                   `   ^  \ rS rSrSrU 4S jr\S 5       r\R                  S 5       rSr	U =r
$ )ImplicitFTPTLS   zT
FTP_TLS subclass that automatically wraps sockets in SSL
to support implicit FTPS.
c                 4   > [         TU ]  " U0 UD6  S U l        g N)super__init___sock)selfargskwargs	__class__s      \/var/www/html/dynamic-report/venv/lib/python3.13/site-packages/fsspec/implementations/ftp.pyr   ImplicitFTPTLS.__init__   s    $)&)
    c                     U R                   $ )zReturn the socket.r   r   s    r   sockImplicitFTPTLS.sock   s     zzr    c                     Ub:  [        U[        R                  5      (       d  U R                  R	                  U5      nXl        g)z9When modifying the socket, ensure that it is ssl wrapped.N)
isinstancessl	SSLSocketcontextwrap_socketr   )r   values     r   r$   r%   "   s3     Zs}}%E%ELL,,U3E
r    r"   )__name__
__module____qualname____firstlineno____doc__r   propertyr$   setter__static_attributes____classcell__r   s   @r   r   r      s9    
   
[[ r    r   c            	         ^  \ rS rSrSrSrSrSr         SU 4S jjrS r	\
S	 5       r\S
 5       rSS jrS rS rS U 4S jjr    S!S jrS rS"S jrSS\S\S\SS4S jjrS#S\S\SS4S jjrS rS rS rS$U 4S jjrSrU =r$ )%FTPFileSystem*   zA filesystem over classic FTP/FftpNc                   > [         TU ]  " S0 UD6  Xl        X l        U=(       d    SU l        U=(       d    SU=(       d    SU=(       d    S4U l        Xl        Xl        Ub  X`l        OSU l        Xl	        U R                  5         [        U R                  [        5      (       a-  U R                  (       a  U R                  R                  5         ggg)a#  
You can use _get_kwargs_from_urls to get some kwargs from
a reasonable FTP url.

Authentication will be anonymous if username/password are not
given.

Parameters
----------
host: str
    The remote server name/ip to connect to
port: int
    Port to connect with
username: str or None
    If authenticating, the user's identifier
password: str of None
    User's password on the server, if using
acct: str or None
    Some servers also need an "account" string for auth
block_size: int or None
    If given, the read-ahead or write buffer size.
tempdir: str
    Directory on remote to put temporary files when in a transaction
timeout: int
    Timeout of the ftp connection in seconds
encoding: str
    Encoding to use for directories and filenames in FTP connection
tls: bool or str
    Enable FTP-TLS for secure connections:
        - False: Plain FTP (default)
        - True: Explicit TLS (FTPS with AUTH TLS command)
        - "tls": Auto-negotiate highest protocol
        - "tlsv1": TLS v1.0
        - "tlsv1_1": TLS v1.1
        - "tlsv1_2": TLS v1.2
z/tmp Ni    )r   r   hostporttempdircredtimeoutencoding	blocksizer   _connectr'   boolr;   prot_p)r   r?   r@   usernamepasswordacct
block_sizerA   rC   rD   r   r   r   s               r   r   FTPFileSystem.__init__1   s    d 	"6"		(&NHNDJB>	 !'N"DNdhh%%$((HHOO +3%r    c                 @   S nU R                   (       a{  [        U R                   [        5      (       aU  [        n[        R                  U R                   SU R                    S35      n[        U[        5      (       a  [        U5      eO[        nO[        nU" U R                  U R                  S9U l        U(       a  XR                  l        U R                  R                  U R                  U R                  5        U R                  R                   " U R"                  6   g )NzNot supported z	 protocol)rC   rD   )r   r'   strr   SECURITY_PROTOCOL_MAPget
ValueErrorr   r   rC   rD   r;   ssl_versionconnectr?   r@   loginrB   )r   securityftp_clss      r   rF   FTPFileSystem._connects   s    88$((C(((044HH$TXXJi8 h,,$X.. - "G4<<$--H#+HH DII.		"r    c                 `    S[        U5      S   R                  S5      R                  S5      -   $ )Nr:   path)r   lstriprstrip)clsrZ   s     r   _strip_protocolFTPFileSystem._strip_protocol   s.    *408??DKKCPPPr    c                 d    [        U 5      nUR                  SS 5        UR                  SS 5        U$ )NrZ   protocol)r   pop)urlpathouts     r   _get_kwargs_from_urls#FTPFileSystem._get_kwargs_from_urls   s-    #G,
D!
r    c                    U R                  U5      n/ nXR                  ;  a    U R                  R                  U5       VVs/ s H  u  pVUS;  d  M  US   S;  d  M  XV4PM     nnnU Hb  u  pVSR                  US:X  a  SOUUR                  S5      /5      US'   US   S:X  a  [        US   5      US'   OS	US'   US   S
:X  d  M]  SUS'   Md     X@R                  U'   U R                  R                  X5      n	U(       d   [        U	 VVs/ s H  u  pVUPM	     snn5      $ U	 VVs/ s H  u  pVUPM	     snn$ s  snnf ! [         a    [        U R                  U5      n Nf = f! [         aF     U R                  U5      nUS   S:X  a  X4/n N! [        [        4 a  n[        U5      UeS nAff = ff = fs  snnf s  snnf )N).z..type)pdircdirr:   r=   namefilesizer   dir	directory)r^   dircacher;   mlsdr   _mlsd2joinr[   intr   info
IndexErrorFileNotFoundErrorrQ   sorted)
r   rZ   detailr   rd   fndetailsrv   excfiless
             r   lsFTPFileSystem.ls   s   ##D)}}$;1 .2XX]]4-@-@MR[0 & $FO3CC &-@   $'KB&)hh#s{biinE'GFO v&0*-gfo*>*+v%/*5 $' '*d# !!$,7+"2788+015KB511; " 1 40C1  ;;99T?DF|v- $|nz* ;+D1s:;; 81sx   D= D7D7D7%D= (AE# E# 
F6
%F<7D= = E E# E  E# #
F3.FF/F**F//F3c                 
  ^ U R                  T5      mTS:X  a  SSSS.$ U R                  U R                  T5      R                  S5      S5      n [	        U4S jU 5       5      nU$ ! [
         a  n[        T5      UeS nAff = f)Nr:   r   rp   )rl   rn   ri   Tc              3   <   >#    U  H  oS    T:X  d  M  Uv   M     g7f)rl   Nr>   ).0frZ   s     r   	<genexpr>%FTPFileSystem.info.<locals>.<genexpr>   s     =%QV9+<qq%s   	)r^   r   _parentr[   nextStopIterationrx   )r   rZ   r   r~   rd   r}   s    `    r   rv   FTPFileSystem.info   s    ##D)3;K@@T*11#6=	3=%==C 
  	3#D)s2	3s   A' '
B1A==Bc                   ^ U R                  U5      (       a;  [        R                  R                  U5      (       d  [        R                  " U5        g [        U5      (       a  UmO[        US5      mU4S jnU R                  R                  SU 3U R                  US9  [        U5      (       d  TR                  5         g g )Nwbc                 (   > TR                  U 5        g r   )write)xoutfiles    r   cb"FTPFileSystem.get_file.<locals>.cb   s    MM!r    RETR )rE   callback)isdirosrZ   existsmkdirr   openr;   
retrbinaryrE   close)r   rpathlpathr   r   r   s        @r   get_fileFTPFileSystem.get_file   s    ::e77>>%((eG5$'G	 	E7Onn 	 	

 %  MMO !r    c                    >^ Ub  [         TU ]  " XU40 UD6$ / mU4S jn U R                  R                  SU 3U R                  UUS9  SR                  T5      $ ! [
        [        4 a  n[        U5      UeS nAff = f)Nc                 (   > TR                  U 5        g r   )append)r   rd   s    r   r   "FTPFileSystem.cat_file.<locals>.cb   s    JJqMr    r   rE   restr   r    )	r   cat_filer;   r   rE   r   r   rx   rt   )	r   rZ   startendr   r   orig_excrd   r   s	          @r   r   FTPFileSystem.cat_file   s    ?7#D???		8HHv..	    xx} z" 	8#D)x7	8s   )A A<+A77A<c           
          U R                  U5      nU=(       d    U R                  n[        U UUUU R                  UUS9$ )N)moderL   rA   
autocommitcache_options)r^   rE   FTPFilerA   )r   rZ   r   rL   r   r   r   s          r   _openFTPFileSystem._open   sH     ##D)14>>
!LL!'
 	
r    c                     U R                  U5      nU R                  R                  U5        U R                  U R	                  U5      5        g r   )r^   r;   deleteinvalidate_cacher   r   rZ   s     r   _rmFTPFileSystem._rm  s9    ##D)dll401r    c                     U R                  XUS9n[        U5       H=  nU R                  U5      (       a  U R                  U5        M,  U R	                  U5        M?     g )N)	recursivemaxdepth)expand_pathreversedisfilerm_filermdir)r   rZ   r   r   pathsps         r   rmFTPFileSystem.rm  sH      X N%A{{1~~Q

1	 !r    rZ   create_parentsr   returnc                 4   U R                  U5      nU R                  U5      nX@R                  :w  a,  U R                  U5      (       d  U(       a  U R	                  XBS9  U R
                  R                  U5        U R                  U R                  U5      5        g )Nr   )r^   r   root_markerr   r   r;   mkdr   )r   rZ   r   r   parents        r   r   FTPFileSystem.mkdir  sq    ##D)d#%%%dkk&.A.AnJJvJ=Tdll401r    exist_okc                     U R                  U5      nU R                  U5      (       a  U(       d  [        U S35      eg U R                  USS9  g )Nz exists without `exist_ok`Tr   )r^   r   FileExistsErrorr   )r   rZ   r   s      r   makedirsFTPFileSystem.makedirs  sN    ##D);;t%.H&IJJ  JJtDJ1r    c                     U R                  U5      nU R                  R                  U5        U R                  U R	                  U5      5        g r   )r^   r;   rmdr   r   r   s     r   r   FTPFileSystem.rmdir"  s9    ##D)Tdll401r    c                     U R                  U5      nU R                  U5      nU R                  R                  X5        U R                  U R	                  U5      5        U R                  U R	                  U5      5        g r   )r^   r;   renamer   r   )r   path1path2r   s       r   mvFTPFileSystem.mv'  s`    $$U+$$U+%dll512dll512r    c                 8    U R                   R                  5         g r   )r;   r   r#   s    r   __del__FTPFileSystem.__del__.  s    r    c                    > Uc  U R                   R                  5         OU R                   R                  US 5        [        TU ]  U5        g r   )rq   clearrb   r   r   )r   rZ   r   s     r   r   FTPFileSystem.invalidate_cache1  s9    <MM!MMdD) &r    )	rE   rB   rD   r;   r?   r@   rA   rC   r   )	   NNNNN   zutf-8F)T)NN)rbNNT)FNFr   ) r-   r.   r/   r0   r1   r   cachablera   r   rF   classmethodr^   staticmethodre   r   rv   r   r   r   r   r   rO   rG   r   r   r   r   r   r   r   r4   r5   r6   s   @r   r8   r8   *   s    'KHH
 @D#* Q Q  #2J*, 
*2
2# 2t 2c 2d 22S 2D 2T 22
3' 'r    r8   c                       \ rS rSrSrSrg)TransferDonei9  z+Internal exception to break out of transferr>   N)r-   r.   r/   r0   r1   r4   r>   r    r   r   r   9  s    5r    r   c                   V   ^  \ rS rSrSr     S	U 4S jjrS rS rS rS
S jr	Sr
U =r$ )r   i?  z9Interact with a remote FTP file with read/write bufferingc           	         > [         T	U ]  " UU4UUUUUS.UD6  U(       dI  U R                  U l        SR	                  US   [        [        R                  " 5       5      /5      U l        g g )N)r   rL   r   
cache_typer   r:   rA   )r   r   rZ   targetrt   rO   uuiduuid4)
r   fsrZ   r   rL   r   r   r   r   r   s
            r   r   FTPFile.__init__B  sr     			
 !!!'		
 		
 ))DK&"3S5F!GHDI r    c                 d    U R                   R                  U R                  U R                  5        g r   )r   r   rZ   r   r#   s    r   commitFTPFile.commit[  s    

499dkk*r    c                 N    U R                   R                  U R                  5        g r   )r   r   rZ   r#   s    r   discardFTPFile.discard^  s    

499r    c                   ^ ^^^^ / mS/mUUU UU4S jn T R                   R                  R                  ST R                   3T R                  TUS9  SR                  T5      $ ! [
         aw     T R                   R                  R                  5         T R                   R                  R                  5          Nf! [         a    T R                   R                  5           Nf = ff = f)zGet bytes between given byte limits

Implemented by raising an exception in the fetch callback when the
number of bytes received reaches the requested amount.

Will fail if the server does not respect the REST command on
retrieve requests.
r   c                   > TS==   [        U 5      -  ss'   TS   TT-
  :  a4  TR                  U S TT-
  TS   -
   5        TTR                  :  a  [        eOTR                  U 5        TS   TT-
  :X  a  TTR                  :  a  [        eg g )Nr   )lenr   rn   r   )r   r   rd   r   r   totals    r   r   &FTPFile._fetch_range.<locals>.callbackm  s    !HAHQx#+%

17euQx789?&& # 

1Qx3;&3?"" ,;&r    r   r   r    )r   r;   r   rZ   rE   r   abortgetmultiliner   rF   rt   )r   r   r   r   rd   r   s   ``` @@r   _fetch_rangeFTPFile._fetch_rangea  s     
	# 
	#	#GGKK""		{#..!	 #  xx}  	##!!#((* #  "#	#s*   =A$ $
C%/AB99$C!C% C!!C%c                     U R                   R                  S5        U R                  R                  R	                  SU R
                   3U R                   U R                  U R                  S9  g)Nr   zSTOR )rE   r   T)bufferseekr   r;   
storbinaryrZ   rE   offset)r   finals     r   _upload_chunkFTPFile._upload_chunk  sT    DII;T[[ 	 	
 r    )rZ   r   )r   defaultT	readaheadNr   )r-   r.   r/   r0   r1   r   r   r   r   r  r4   r5   r6   s   @r   r   r   ?  s7    C I2+'R r    r   c                 P   / n/ nU R                  XR                  5        U H  nUR                  5       n[        U5      S:  a  M$  US   SR	                  USS 5      US   US   US   US	   S
.4nUS   S   S   S:X  a	  SUS   S'   OSUS   S'   UR                  U5        M     U$ )a  
Fall back to using `dir` instead of `mlsd` if not supported.

This parses a Linux style `ls -l` response to `dir`, but the response may
be platform dependent.

Parameters
----------
ftp: ftplib.FTP
path: str
    Expects to be given path, but defaults to ".".
	          r      r      )modifyz
unix.ownerz
unix.group	unix.modern      r  dro   ri   rm   )ro   r   splitr   rt   )r;   rZ   linesminfoline
split_linethiss          r   rs   rs     s     EEGGD,,ZZ\
z?QrN((:a?3(m(m']"1	
 7;"c)#DGFO$DGFOT% & Lr    )rh   )r   r(   r   ftplibr   r   r   r   typingr   specr	   r
   utilsr   r   PROTOCOL_TLSPROTOCOL_TLSv1PROTOCOL_TLSv1_1PROTOCOL_TLSv1_2PROTOCOL_SSLv23rP   r   r8   	Exceptionr   r   rs   r>   r    r   <module>r&     s    	 
  2 2  ; 5 ####!! W .L'& L'^	9 	P" Pf#r    