O|bhdZddlZddlZddlZddlZddlZddlZgdZdZ dZ dZ Gdde Z Gdd ZGd d eZGd d eZGddZy)zE ftputil.stat - stat result, parsers, and FTP stat'ing for `ftputil` N) StatResultParser UnixParserMSParser<iQc @eZdZdZdddddddd d d d d d ZdZdZdZy)rzP Support class resembling a tuple like that returned from `os.(l)stat`. r ) st_modest_inost_devst_nlinkst_uidst_gidst_sizest_atimest_mtimest_ctime_st_name _st_targetc6d|_d|_t|_y)N)rrUNKNOWN_PRECISION_st_mtime_precision)selfsequences ,lib/python3.12/site-packages/ftputil/stat.py__init__zStatResult.__init__0s #4 cv||jvr||j|Stdj|)Nz)'StatResult' object has no attribute '{}')_index_mappingAttributeErrorformat)r$ attr_names r& __getattr__zStatResult.__getattr__=sA ++ +++I67 7 ;BB9M r(c0td|jjD}g}t|D])\}}|j dj |||+dj t |jdj|S)Nc3*K|] \}}||f yw)N).0kvs r& z&StatResult.__repr__..HsL1aVLsz{}={!r}z{}({})z, ) dictr*items enumerateappendr,type__name__join)r$ index_to_nameargument_stringsindexitems r&__repr__zStatResult.__repr__EsL0C0C0I0I0KLL $T? RKE4  # #I$4$4]55I4$P Q RtDz22DII>N4OPPr(N)r; __module__ __qualname____doc__r*r'r.rAr1r(r&rrsD  N 5Qr(rc eZdZdZdddddddd d d d d d Zej dZdZddZ dZ dZ e dZ ddZddZy)rzu Represent a parser for directory lines. Parsers for specific directory formats inherit from this class. r r r r r rrrrrr ) janfebmaraprmayjunjulaugsepoctnovdecz ^total\s+\d+cp|jsy|jj|}t|S)aR Return a true value if the line should be ignored, i. e. is assumed to _not_ contain actual directory/file/link data. A typical example are summary lines like "total 23" which are emitted by some FTP servers. If the line should be used to extract stat data from it, return a false value. T)strip _total_regexsearchbool)r$linematchs r& ignores_linezParser.ignores_linejs0zz|!!((.E{r(ctd)a Return a `StatResult` object as derived from the string `line`. The parser code to use depends on the directory format the FTP server delivers (also see examples at end of file). If the given text line can't be parsed, raise a `ParserError`. For the definition of `time_shift` see the docstring of `FTPHost.set_time_shift` in `ftputil.py`. Not all parsers use the `time_shift` parameter. zmust be defined by subclass)NotImplementedError)r$rX time_shifts r& parse_linezParser.parse_line{s""?@@r(c tt|dk7r.tjjdj |d}|ddD]}|dk7}|dz|z}|ddk(r|t j z}|ddk(r|t jz}t jt jt jt jt jt jt jdd }|d}||vr |||z}|Stjjd j |) a Return an integer from the `mode_string`, compatible with the `st_mode` value in stat results. Such a mode string may look like "drwxr-xr-x". If the mode string can't be parsed, raise an `ftputil.error.ParserError`. rzinvalid mode string '{}'rr -r sr)bcdlprar`?z unknown file type character '{}')lenftputilerror ParserErrorr,statS_ISUIDS_ISGIDS_IFBLKS_IFCHRS_IFDIRS_IFLNKS_IFIFOS_IFSOCKS_IFREG)r$ mode_stringrbitfile_type_to_mode file_types r&parse_unix_modezParser.parse_unix_modes0 { r !--++*11+> q$ +C*C!|s*G + q>S  ,G q>S  ,G   N ) ) 1) < 59, raise a `ParserError`. tzinfo04dr`02d :zinvalid datetime {0!r})datetimetimezoneutcr}rirjrkr,)yearmonthdayhourminutesecondinvalid_datetimes r& _datetimezParser._datetimes $$eS$x?P?P?T?T  *AeC[#c!*AfS\6#,8 --++(//0@A   s 36ABc |j|j}|j|d}d|v}|rt}|j|ddd} } } nt}|jd\} } d|j| d|j| d} } } tjjjtjj tj | z} | j"} |j%| ||| | d| jd tj d zkDr| d z} |j%| ||| | dtj | z }|j'}|dkrt(}d}|r||fS|S#t$r/tjj dj |wxYw)a Return a floating point number, like from `time.mktime`, by parsing the string arguments `month_abbreviation`, `day` and `year_or_time`. The parameter `time_shift` is the difference "time on server" - "time on client" and is available as the `time_shift` parameter in the `parse_line` interface. If `with_precision` is true return a two-element tuple consisting of the floating point number as described in the previous paragraph and the precision of the time in seconds. The default is `False` for backward compatibility with custom parsers. The precision value takes into account that, for example, a time string like "May 26 2005" has only a precision of one day. This information is important for the `upload_if_newer` and `download_if_newer` methods in the `FTPHost` class. Times in Unix-style directory listings typically have one of these formats: - "Nov 23 02:33" (month name, day of month, time) - "May 26 2005" (month name, day of month, year) If this method can't make sense of the given arguments, it raises an `ftputil.error.ParserError`. z invalid month abbreviation {0!r}rrrrNrrrseconds)rxr )_month_numberslowerKeyErrorrirjrkr,r DAY_PRECISIONMINUTE_PRECISIONsplitrutcnowreplacerr timedeltarr timestampr")r$month_abbreviationr year_or_timer]with_precisionr year_is_knownst_mtime_precision server_yearrrr server_nowserver_utc_datetimers r&parse_unix_timezParser.parse_unix_times< ''(:(@(@(BCE ll3&</ !. (, \6(JAqvK"2 '--c2LD& T6* VX.$D "**113;;((,,<"":67J%//K,~~UCvq""!",x/A/A#/NNOq #nn T61   z 23'002 c>!2 H // /OG --++299:LM  s F8G ch|jdDcgc]}|j|dc}\}}}|dk\rn|dk\rd|z}nd|z} |dd|d d |d } } } |j| d |j| d } } | dk(r| dk(rd} | dk7r | dk(r| dz } |j|||| | d} | tj|z } | j}|dkr t}d}nt}|r||fS|Scc}w#t$r/tjj d j |wxYw)am Return a floating point number, like from `time.mktime`, by parsing the string arguments `date` and `time_`. The parameter `time_shift` is the difference "time on server" - "time on client" and can be set as the `time_shift` parameter in the `parse_line` interface. If `with_precision` is true return a two-element tuple consisting of the floating point number as described in the previous paragraph and the precision of the time in seconds. The default is `False` for backward compatibility with custom parsers. The precision value takes into account that, for example, a time string like "10-23-2001 03:25PM" has only a precision of one minute. This information is important for the `upload_if_newer` and `download_if_newer` methods in the `FTPHost` class. Usually, the returned precision is `MINUTE_PRECISION`, except when the date is before the epoch, in which case the returned `st_mtime` value is set to 0.0 and the precision to `UNKNOWN_PRECISION`. Times in MS-style directory listings typically have the format "10-23-01 03:25PM" (month-day_of_month-two_digit_year, hour:minute, am/pm). If this method can't make sense of the given arguments, it raises an `ftputil.error.ParserError`. r`zyear/month/dayiFilirr r r zinvalid time string '{}'rrrFAPrr) rr IndexErrorrirjrkr,rrrrr"r)r$datetime_r]rpartrrrrram_pmserver_datetimeclient_datetimerrs r& parse_ms_timezParser.parse_ms_timeCsgX>BZZ_ 59DLL/ 0 sD 4<  RZ$;D$;D V"'!*eAaj%(%&D T62DLL4Rf 2:%3,D 2:%3, BJD..uc4K)H,>,>z,RR",,. c>!2 H!1  // /O=  V--++,F,M,Me,TU U VsC4 C998D1Nr)F)r;rBrCrDrrecompilerUrZr^rzr staticmethodrrrr1r(r&rrRs N2::o.L" A"*Z ,QVcJIr(rc(eZdZdZedZddZy)rz< `Parser` class for Unix-specific directory format. cf|j}d}|dz}t||kr.tjj dj | t |d|jd|dz }d}|j|d|S#t$r|jd|dz }Y|SwxYw)a Split a line in metadata, nlink, user, group, size, month, day, year_or_time and name and return the result as an nine-element list of these values. If the name is a link, it will be encoded as a string "link_name -> link_target". rr line '{}' can't be parsedr Nr ) rrhrirjrkr,r|insertr})rX line_partsFIELD_COUNT_WITHOUT_USERIDFIELD_COUNT_WITH_USERIDUSER_FIELD_INDEXs r& _split_linezUnixParser._split_linesZZ\ %&"" r z%name '{}' contains more than one "->")rr}rirjrkstrrzr|rcountr,rrr#rr)r$rXr]rvnlinkusergroupsizerrrnameexcrrrrrrrrrrrst_name st_target stat_results r&r^zUnixParser.parse_lines 6  & &&{3u:d)'+';'; 3 j(<( $$ ::f  !--++;BB4H ZZ 1 $!%F!3 GY!%tYG    "+= '& !* c 6--++CH5 5 6sD D: (D55D:Nr)r;rBrCrDrrr^r1r(r&rrs!:Jr(rceZdZdZddZy)rz: `Parser` class for MS-specific directory format. c F |jdd\}}}}d}|dk(r|t jz}n|t jz}d}d} d} d} d} |dk7r t|} nd} d}|j|||d\}}d}t||| | | | | |||f }||_ d|_ ||_|S#t$r/tjj dj |wxYw#t$r/tjj dj |wxYw) aY Return a `StatResult` instance corresponding to the given text line from a FTP server which emits "Microsoft format" (see end of file). If the line can't be parsed, raise a `ParserError`. The parameter `time_shift` isn't used in this method but is listed for compatibility with the base class. Nr rzzinvalid size {}Tr)rr}rirjrkr,rlrqrur|rrrrr#)r$rXr]rr dir_or_sizerrrrrrrrrrrrrs r&r^zMSParser.parse_linesi V-1ZZa-@ *D%d  ' ! ,G ,G ' ! Wk*G'+'9'9 %D(:( $$    $ $ !% *< 'm V--++,G,N,Nt,TU U V( Wmm//0A0H0H0UVV WsB- C(-8C%(8D Nr)r;rBrCrDr^r1r(r&rrs Dr(rcTeZdZdZdZdZdZdZd dZd dZ dZ d Z d d Z d d Z y )_StatzD Methods for stat'ing directories, links and regular files. c||_|j|_t|_d|_t jj|_ y)NT) _hostpath_pathr_parser_allow_parser_switchingri stat_cache StatCache _lstat_cache)r$hosts r&r'z_Stat.__init__Us> YY !| (,$#..88:r(c8|jj|S)zm Return a list of lines, as fetched by FTP's `LIST` command, when applied to `path`. )r_dirr$rs r& _host_dirz_Stat._host_dir`s zzt$$r(c#K|j|}|j}|jr]t||jj k\r;t tjdt|z}|j||D]}|jj|r|jj||jj}|j|jj |jj"fvr|j$j'||j}|||<|yw)z Yield stat results extracted from the directory listing `path`. Omit the special entries for the directory itself and its parent directory. g?N)rr_enabledrh_cacherr|mathceilresizerrZr^rr]rcurdirpardirrr<)r$rlinescachenew_sizerXr loop_paths r&_stat_results_from_dirz_Stat._stat_results_from_dirgs t$!! >>c%jELL,=,==499S3u:%567H LL " D||((.,,11$ 8M8M8OPK## (9(94::;L;L'MM k.B.BCI*E)   sEE c8|jj|}|jj|s.tjj dj |g}|j|D]}|j}|j|!|S)a Return a list of directories, files etc. in the directory named `path`. Like `os.listdir` the returned list elements have the type of the path argument. If the directory listing from the server can't be parsed, raise a `ParserError`. z8550 {}: no such directory or wrong directory parser used) rabspathisdirrirjPermanentErrorr,rrr9)r$rnamesrrs r& _real_listdirz_Stat._real_listdirszz!!$'zz%--..JQQRVW 66t< "K!**G LL ! " r(c|jj|}||jvr|j|S|dk(rtjj d|jj |\}}|jj|s|syd}|j|D]}|j|k(s|}||S|r.tjjdj|y)a# Return an object similar to that returned by `os.lstat`. If the directory listing from the server can't be parsed, raise a `ParserError`. If the directory can be parsed and the `path` is not found, raise a `PermanentError`. That means that if the directory containing `path` can't be parsed we get a `ParserError`, independent on the presence of `path` on the server. (`_exception_for_missing_path` is an implementation aid and _not_ intended for use by ftputil clients.) /z can't stat remote root directoryNz!550 {}: no such file or directory) rrrrirj RootDirErrorrrrrrr,)r$r_exception_for_missing_pathdirnamebasenamelstat_result_for_pathrs r& _real_lstatz_Stat._real_lstatszz!!$' 4$$ $$$T* * 3;--,,-OP P JJ,,T2 zz(1L!%  66w? 4K##x/(3% 4 ! ,( ( &--..3::4@ r(c|}t} |j||}|ytj|js|S|j j |\}}|j j||j}|j j|j j|}||vr.tjjdj||j|)a Return info from a "stat" call on `path`. If the directory containing `path` can't be parsed, raise a `ParserError`. If the listing can be parsed but the `path` can't be found, raise a `PermanentError`. Also raise a `PermanentError` if there's an endless (cyclic) chain of symbolic links "behind" the `path`. (`_exception_for_missing_path` is an implementation aid and _not_ intended for use by ftputil clients.) Nz6recursive link structure detected for remote path '{}')setrrlS_ISLNKrrrr<rrnormpathrirjRecursiveLinksErrorr,add)r$rr original_path visited_paths lstat_resultr_s r& _real_statz_Stat._real_stats  ++D2MNL#<< 4 45##))$/JGQ::??7L,C,CDD::%%djj&9&9$&?@D}$mm77LSS%   d #/r(c ||i|}||jur |rd|_|S#tjj$r.|jr d|_t |_||i|cYSwxYw)z Call `method` with the `args` and `kwargs` once. If that results in a `ParserError` and only one parser has been used yet, try the other parser. If that still fails, propagate the `ParserError`. F)rrrirjrkrr)r$methodargskwargsresults r&__call_with_parser_retryz_Stat.__call_with_parser_retrys{ T,V,Fd000f/4,M}}(( ++/4,'z t.v..  s #AA.,A.c:|j|j|S)z Return a list of items in `path`. Raise a `PermanentError` if the path doesn't exist, but maybe raise other exceptions depending on the state of the server (e. g. timeout). )_Stat__call_with_parser_retryrrs r&_listdirz_Stat._listdir2s,,T-?-?FFr(c<|j|j||S)z Return a `StatResult` without following links. Raise a `PermanentError` if the path doesn't exist, but maybe raise other exceptions depending on the state of the server (e. g. timeout). )rrr$rrs r&_lstatz _Stat._lstat;s%,,   d$?  r(c<|j|j||S)z Return a `StatResult` with following links. Raise a `PermanentError` if the path doesn't exist, but maybe raise other exceptions depending on the state of the server (e. g. timeout). )rr rs r&_statz _Stat._statFs#,, OOT#>  r(N)T)r;rBrCrDr'rrrrr rrrrr1r(r&rrNs= ;%h08t($T6G    r(r)rDrrrrl ftputil.errorriftputil.stat_cache__all__rrr"tuplerrrrrr1r(r&rs~   = 0Q0Qlzzz mm`IvI^A A r(