U ZfU@sdZddlZddlZddlZddlZddlZddlZddddgZdZ dZ dZ Gd dde Z Gd ddZGd ddeZGd ddeZGd ddZdS)zE ftputil.stat - stat result, parsers, and FTP stat'ing for `ftputil` N StatResultParser UnixParserMSParser<iQc @sFeZdZdZdddddddd d d d d d ZddZddZddZdS)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_targetcCsd|_d|_t|_dS)N)rrUNKNOWN_PRECISION_st_mtime_precision)selfsequencer#0/tmp/pip-unpacked-wheel-g7w5sq0v/ftputil/stat.py__init__0s zStatResult.__init__cCs*||jkr||j|Std|dS)Nz)'StatResult' object has no attribute '{}')_index_mappingAttributeErrorformat)r! attr_namer#r#r$ __getattr__=s  zStatResult.__getattr__cCs\tdd|jD}g}t|D]\}}|d|||q$dt|jd|S)Ncss|]\}}||fVqdS)Nr#).0kvr#r#r$ Hsz&StatResult.__repr__..z{}={!r}z{}({})z, ) dictr&items enumerateappendr(type__name__join)r!Z index_to_nameargument_stringsindexitemr#r#r$__repr__Es zStatResult.__repr__N)r4 __module__ __qualname____doc__r&r%r*r9r#r#r#r$rs" c @szeZdZdZdddddddd d d d d d ZedZddZd!ddZ ddZ ddZ e ddZ d"ddZd#ddZd S)$rzu Represent a parser for directory lines. Parsers for specific directory formats inherit from this class. rrr r r r r rrrr ) janfebmaraprmayjunjulaugsepoctnovdecz ^total\s+\d+cCs |s dS|j|}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!linematchr#r#r$ ignores_linejs  zParser.ignores_linecCs tddS)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 subclassN)NotImplementedError)r!rN time_shiftr#r#r$ parse_line{s zParser.parse_linec Cst|dkrtjd|d}|ddD]}|dk}|d>|}q.|ddkr^|tjB}|ddkrt|tjB}tjtj tj tj tj tj tjdd }|d}||kr|||B}ntjd ||S) 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 )bcdlprVrU?z unknown file type character '{}')lenftputilerror ParserErrorr(statS_ISUIDS_ISGIDS_IFBLKS_IFCHRS_IFDIRS_IFLNKS_IFIFOS_IFSOCKS_IFREG)r! mode_stringrbitZfile_type_to_mode file_typer#r#r$parse_unix_modes8      zParser.parse_unix_modec Cs8z t|WStk r2tjd||YnXdS)a Return `int_string` converted to an integer. If it can't be converted, raise a `ParserError`, using `int_description` in the error message. For example, if the integer value is a day, pass "day" for `int_description`. znon-integer {} value {!r}N)int ValueErrorr^r_r`r()r!Z int_stringZint_descriptionr#r#r$_as_ints   zParser._as_intcCs|ztj||||||tjjdWStk rv|dd|dd|dd|dd|dd|d }tjd|YnXdS) z Return UTC `datetime.datetime` object for the given year, month, day, hour, minute and second. If there are invalid values, for example minute > 59, raise a `ParserError`. )tzinfoZ04drUZ02d :zinvalid datetime {0!r}N)datetimetimezoneutcrpr^r_r`r()yearmonthdayhourminutesecondZinvalid_datetimer#r#r$ _datetimes 0zParser._datetimeFcCsHz|j|}Wn&tk r8tjd|YnX||d}d|k}|rpt}||ddd} } } nt }| d\} } d|| d|| d} } } t j t j jt j|d } | j} || ||| | d| jdd t jd d kr| d 8} || ||| | dt j|d }|}|d kr2t}d }|r@||fS|SdS)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}rzrtrxrNr{r|seconds)r}xrrQ)_month_numberslowerKeyErrorr^r_r`r(rq DAY_PRECISIONMINUTE_PRECISIONsplitrunowrvrw timedeltarxr~replace timestampr)r!Zmonth_abbreviationrz year_or_timerSwith_precisionryZ year_is_knownst_mtime_precisionZ server_yearr{r|Z_yearZ server_nowZserver_utc_datetimerr#r#r$parse_unix_timesf       zParser.parse_unix_timecs2fdd|dD\}}}|dkr(n|dkr:d|}nd|}z(|dd |d d |d }} } Wn&tk rtjd |YnX|d | d}} |dkr| dkrd}|dkr| dkr|d7}||||| d} | tj |d} | } | dkrt }d} nt }|r*| |fS| SdS)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`. csg|]}|dqS)zyear/month/day)rq)r+partr!r#r$ nsz(Parser.parse_ms_time..rUiFilirrr r zinvalid time string '{}'r{r|r=APrrQN) r IndexErrorr^r_r`r(rqr~rurrrr)r!datetime_rSrryrzrxr{r|Zam_pmZserver_datetimeZclient_datetimerrr#rr$ parse_ms_timeCs6+   ( zParser.parse_ms_timeN)rQ)F)F)r4r:r;r<rrecompilerKrPrTrnrq staticmethodr~rrr#r#r#r$rRs0  -  ec@s&eZdZdZeddZdddZdS) rz< `Parser` class for Unix-specific directory format. cCs|}d}|d}t||kr2tjd|zt|dWn$tk rf|d|d}Yn"X|d|d}d}||d|S)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". rrline '{}' can't be parsedr Nr) rr]r^r_r`r(rorpinsert)rNZ line_partsZFIELD_COUNT_WITHOUT_USERIDZFIELD_COUNT_WITH_USERIDZUSER_FIELD_INDEXr#r#r$ _split_lines   zUnixParser._split_linerQc Csz ||\ }}}}}}} } } Wn2tk rR} ztjt| W5d} ~ XYnX||} d}d}t|}|}|}t|}d}|j|| | |dd\}}d}| ddkrtjd | n(| ddkr| d\}}n | d}}t | |||||||||f }||_ ||_||_|S)a  Return a `StatResult` instance corresponding to the given text line. The `time_shift` value is needed to determine to which year a datetime without an explicit year belongs. If the line can't be parsed, raise a `ParserError`. NTrz -> rz%name '{}' contains more than one "->")rrpr^r_r`strrnrorcountr(rrr rr)r!rNrSrkZnlinkusergroupsizeryrzrnameexcrrrrrrrrrrrst_nameZ st_target stat_resultr#r#r$rTsn  "   zUnixParser.parse_lineN)rQ)r4r:r;r<rrrTr#r#r#r$rs c@seZdZdZdddZdS)rz: `Parser` class for MS-specific directory format. rQc Csz|dd\}}}}Wn&tk r>tjd|YnXd}|dkrX|tjB}n |tjB}d}d} d} d} d} |dkrz t |} Wqtk rtjd|YqXnd} d}|j |||dd\}}d}t ||| | | | | |||f }||_ d|_ ||_|S) 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)rrpr^r_r`r(rarfrjrorrrrr )r!rNrSrrZ dir_or_sizerrrrrrrrrrrrrr#r#r$rTsX     zMSParser.parse_lineN)rQ)r4r:r;r<rTr#r#r#r$rsc@sheZdZdZddZddZddZdd Zdd d Zdd dZ ddZ ddZ dddZ dddZ dS)_StatzD Methods for stat'ing directories, links and regular files. cCs,||_|j|_t|_d|_tj|_ dS)NT) _hostpath_pathr_parser_allow_parser_switchingr^Z stat_cacheZ StatCache _lstat_cache)r!hostr#r#r$r%Us z_Stat.__init__cCs |j|S)zm Return a list of lines, as fetched by FTP's `LIST` command, when applied to `path`. )rZ_dirr!rr#r#r$ _host_dir`sz_Stat._host_dirccs||}|j}|jrFt||jjkrFttdt|}| ||D]\}|j |r\qJ|j ||j }|j|j j|j jfkrqJ|j||j}|||<|VqJdS)z Yield stat results extracted from the directory listing `path`. Omit the special entries for the directory itself and its parent directory. g?N)rrZ_enabledr]_cacherromathceilresizerrPrTrrSrcurdirpardirrr5)r!rlinescacheZnew_sizerNrZ loop_pathr#r#r$_stat_results_from_dirgs   z_Stat._stat_results_from_dircCsR|j|}|j|s*tjd|g}||D]}|j}| |q8|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) rabspathisdirr^r_PermanentErrorr(rrr2)r!rnamesrrr#r#r$ _real_listdirs   z_Stat._real_listdirTcCs|j|}||jkr |j|S|dkr4tjd|j|\}}|j|sX|sXdSd}||D]}|j |krf|}qf|dk r|S|rtj d |ndSdS)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) rrrr^r_Z RootDirErrorrrrrrr()r!r_exception_for_missing_pathdirnamebasenameZlstat_result_for_pathrr#r#r$ _real_lstats&     z_Stat._real_lstatcCs|}t}|||}|dkr"dSt|js2|S|j|\}}|j||j}|j |j |}||krt j d|||q dS)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 '{}')setrraS_ISLNKrrrr5rrnormpathr^r_ZRecursiveLinksErrorr(add)r!rrZ original_pathZ visited_pathsZ lstat_resultr_r#r#r$ _real_stats"  z_Stat._real_statcOsfz$|||}||jk r |r d|_|WStjjk r`|jrZd|_t|_|||YSYnXdS)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`. FN)rrr^r_r`rr)r!methodargskwargsresultr#r#r$Z__call_with_parser_retrys  z_Stat.__call_with_parser_retrycCs||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_retryrrr#r#r$_listdir2sz_Stat._listdircCs||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!rrr#r#r$_lstat;s z _Stat._lstatcCs||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). )rrrr#r#r$_statFs z _Stat._statN)T)T)T)T)r4r:r;r<r%rrrrrrrrrr#r#r#r$rNs 4 : * r)r<rurrraZ ftputil.errorr^Zftputil.stat_cache__all__rrrtuplerrrrrr#r#r#r$s" 6?pO