U çZßfEã@sfdZddlZddlZgZdZGdd„dƒZGdd„dƒZdd „Zefd d „Z edfd d „Z dd„Z dS)z; file_transfer.py - upload, download and generic file copy éNic@s8eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd S) Ú LocalFilezf Represent a file on the local side which is to be transferred or is already transferred. cCstj |¡|_||_dS©N)ÚosÚpathÚabspathÚnameÚmode)Úselfrr©r ú9/tmp/pip-unpacked-wheel-g7w5sq0v/ftputil/file_transfer.pyÚ__init__szLocalFile.__init__cCstj |j¡S©zl Return `True` if the path representing this file exists. Otherwise return `False`. )rrÚexistsr©r r r r r"szLocalFile.existscCstj |j¡S©zL Return the timestamp for the last modification in seconds. )rrÚgetmtimerrr r r Úmtime)szLocalFile.mtimecCsdS)úP Return the precision of the last modification time in seconds. gð?r rr r r Úmtime_precision/s zLocalFile.mtime_precisioncCst|j|jƒS©zL Return a file object for the name/path in the constructor. )Úopenrrrr r r Úfobj:szLocalFile.fobjN© Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrrrr r r r rs  rc@s8eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd S) Ú RemoteFilezg Represent a file on the remote side which is to be transferred or is already transferred. cCs&||_|j|_|j |¡|_||_dSr)Ú_hostrÚ_pathrrr)r Zftp_hostrrr r r r GszRemoteFile.__init__cCs|j |j¡Sr )rrrrr r r rMszRemoteFile.existscCs|j |j¡Sr)rrrrr r r rTszRemoteFile.mtimecCs|j |j¡jS)r)rÚstatrZ_st_mtime_precisionrr r r r\szRemoteFile.mtime_precisioncCs|j |j|j¡Sr)rrrrrr r r rcszRemoteFile.fobjNrr r r r rAs rcCs0| ¡tjjkrdS| ¡| ¡| ¡kSdS)aÄ Return `True` if the source is newer than the target, else `False`. Both arguments are `LocalFile` or `RemoteFile` objects. It's assumed that the actual modification time is reported_mtime <= actual_mtime <= reported_mtime + mtime_precision i. e. that the reported mtime is the actual mtime or rounded down (truncated). For the purpose of this test the source is newer than the target if any of the possible actual source modification times is greater than the reported target modification time. In other words: If in doubt, the file should be transferred. This is the only situation where the source is _not_ considered newer than the target: |/////////////////////| possible source mtime |////////| possible target mtime That is, the latest possible actual source modification time is before the first possible actual target modification time. TN)rÚftputilr ZUNKNOWN_PRECISIONr)Ú source_fileÚ target_filer r r Úsource_is_newer_than_targetjsÿr$ccs| |¡}|sq|VqdS)a­ Return an iterator which yields the contents of the file object. For each iteration, at most `max_chunk_size` bytes are read from `fobj` and yielded as a byte string. If the file object is exhausted, then don't yield any more data but stop the iteration, so the client does _not_ get an empty byte string. Any exceptions resulting from reading the file object are passed through to the client. N)Úread)rÚmax_chunk_sizeÚchunkr r r Úchunkss r(cCs.t||ƒD]}| |¡|dk r ||ƒq dS)zL Copy data from file-like object source to file-like object target. N)r(Úwrite)Ú source_fobjÚ target_fobjr&Úcallbackr'r r r Ú copyfileobj s r-cCsb|r | ¡ pt||ƒ}|s dS| ¡}z*| ¡}zt|||dW5| ¡XW5| ¡XdS)aµ Copy a file from `source_file` to `target_file`. These are `LocalFile` or `RemoteFile` objects. Which of them is a local or a remote file, respectively, is determined by the arguments. If `conditional` is true, the file is only copied if the target doesn't exist or is older than the source. If `conditional` is false, the file is copied unconditionally. Return `True` if the file was copied, else `False`. F)r,T)rr$rÚcloser-)r"r#Z conditionalr,Ztransfer_conditionr*r+r r r Ú copy_file®s  ÿ r/) rrZ ftputil.statr!Ú__all__ZMAX_COPY_CHUNK_SIZErrr$r(r-r/r r r r Ús))# ÿ