
    7Th.                         S SK r 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   " 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
isfilelikec            	         ^  \ 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                 f  > [         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                  (       a  U R                  R                  5         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
    Use FTP-TLS, by default False
z/tmp Ni    )super__init__hostporttempdircredtimeoutencoding	blocksizetls_connectr   prot_p)selfr   r   usernamepasswordacct
block_sizer   r   r   r   kwargs	__class__s               R/var/www/auris/envauris/lib/python3.13/site-packages/fsspec/implementations/ftp.pyr   FTPFileSystem.__init__   s    X 	"6"		(&NHNDJB>	 !'N"DN88HHOO     c                    U R                   (       a  [        nO[        n[        R                  S:  a!  U" U R
                  U R                  S9U l        ORU R                  (       a,  [        R                  " S5        U" U R
                  S9U l        OU" U R
                  S9U l        U R                  R                  U R                  U R                  5        U R                  R                  " U R                  6   g )N)   	   )r   r   z1`encoding` not supported for python<3.9, ignoring)r   )r   r   r   sysversion_infor   r   r   warningswarnconnectr   r   loginr   )r!   ftp_clss     r(   r   FTPFileSystem._connectO   s    88GGv%t||dmmLDH]]MMMNt||4DHt||4DHDII.		"r*   c                 `    S[        U5      S   R                  S5      R                  S5      -   $ )Nr   path)r   lstriprstrip)clsr7   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$ )Nr7   protocol)r   pop)urlpathouts     r(   _get_kwargs_from_urls#FTPFileSystem._get_kwargs_from_urlsb   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joinr8   intr   info
IndexErrorFileNotFoundErrorgetsorted)
r!   r7   detailr&   rA   fndetailsrS   excfiless
             r(   lsFTPFileSystem.lsi   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   rM   )rI   rK   rF   Tc              3   <   >#    U  H  oS    T:X  d  M  Uv   M     g7f)rI   Nr   ).0fr7   s     r(   	<genexpr>%FTPFileSystem.info.<locals>.<genexpr>   s     =%QV9+<qq%s   	)r;   r]   _parentr8   nextStopIterationrU   )r!   r7   r&   r\   rA   r[   s    `    r(   rS   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 N)write)xoutfiles    r(   cb"FTPFileSystem.get_file.<locals>.cb   s    MM!r*   RETR )r   callback)isdirosr7   existsmkdirr   openr   
retrbinaryr   close)r!   rpathlpathr&   rp   ro   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 rl   )append)rn   rA   s    r(   rp   "FTPFileSystem.cat_file.<locals>.cb   s    JJqMr*   rr   r   restrs   r*   )	r   cat_filer   ry   r   r   r   rU   rQ   )	r!   r7   startendr&   rp   orig_excrA   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)moder%   r   
autocommitcache_options)r;   r   FTPFiler   )r!   r7   r   r%   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 rl   )r;   r   deleteinvalidate_cachere   r!   r7   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!   r7   r   r   pathsps         r(   rmFTPFileSystem.rm   sH      X N%A{{1~~Q

1	 !r*   r7   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;   re   root_markerrv   rw   r   mkdr   )r!   r7   r   r&   parents        r(   rw   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;   rv   FileExistsErrorrw   )r!   r7   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 rl   )r;   r   rmdr   re   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 rl   )r;   r   renamer   re   )r!   path1path2r&   s       r(   mvFTPFileSystem.mv   s`    $$U+$$U+%dll512dll512r*   c                 8    U R                   R                  5         g rl   )r   rz   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 rl   )rN   clearr?   r   r   )r!   r7   r'   s     r(   r   FTPFileSystem.invalidate_cache  s9    <MM!MMdD) &r*   )	r   r   r   r   r   r   r   r   r   )	   NNNNN   zutf-8F)T)NN)rbNNT)FNFrl   ) __name__
__module____qualname____firstlineno____doc__r   cachabler>   r   r   classmethodr;   staticmethodrB   r]   rS   r}   r   r   r   r   strboolr   rw   r   r   r   r   r   __static_attributes____classcell__r'   s   @r(   r   r      s    'KHH
 :x# Q Q  #2J*, 
*2
2# 2t 2c 2d 22S 2D 2T 22
3' 'r*   r   c                       \ rS rSrSrSrg)TransferDonei  z+Internal exception to break out of transferr   N)r   r   r   r   r   r   r   r*   r(   r   r     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   r%   r   
cache_typer   r   r   )r   r   r7   targetrQ   r   uuiduuid4)
r!   fsr7   r   r%   r   r   r   r&   r'   s
            r(   r   FTPFile.__init__  sr     			
 !!!'		
 		
 ))DK&"3S5F!GHDI r*   c                 d    U R                   R                  U R                  U R                  5        g rl   )r   r   r7   r   r   s    r(   commitFTPFile.commit1  s    

499dkk*r*   c                 N    U R                   R                  U R                  5        g rl   )r   r   r7   r   s    r(   discardFTPFile.discard4  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   rK   r   )rn   r   rA   r!   r   totals    r(   rs   &FTPFile._fetch_range.<locals>.callbackC  s    !HAHQx#+%

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

1Qx3;&3?"" ,;&r*   rr   r   r*   )r   r   ry   r7   r   r   abortgetmultiliner   r   rQ   )r!   r   r   rs   rA   r   s   ``` @@r(   _fetch_rangeFTPFile._fetch_range7  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 )r   r   T)bufferseekr   r   
storbinaryr7   r   offset)r!   finals     r(   _upload_chunkFTPFile._upload_chunk`  sT    DII;T[[ 	 	
 r*   )r7   r   )r   defaultT	readaheadNr   )r   r   r   r   r   r   r   r   r   r   r   r   r   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   r,   r      )modifyz
unix.ownerz
unix.group	unix.moderK      r   drL   rF   rJ   )rL   r   splitr   rQ   )r   r7   linesminfoline
split_linethiss          r(   rP   rP   h  s     EEGGD,,ZZ\
z?QrN((:a?3(m(m']"1	
 7;"c)#DGFO$DGFOT% & Lr*   )rE   )ru   r.   r   r0   ftplibr   r   r   r   typingr   specr	   r
   utilsr   r   r   	Exceptionr   r   rP   r   r*   r(   <module>r	     sQ    	 
   2 2  ; 5@'& @'F	9 	P" Pf#r*   