[XMc@s1dZddlZddlZddlZddlZddlmZmZmZm Z m Z ddlm Z m Z ddlm ZddlmZddlmZmZmZddlmZmZdd lmZdd lmZdd lmZmZdd lmZmZmZdd lm Z ej!ej"Bej#BeBZ$dZ%dZ&dZ'e(ej)de%Z*e(ede&Z+e(ede'Z,de-fdYZ.de-fdYZ/de0fdYZ1de1e fdYZ2dZ3dfdYZ4de4fd YZ5e5e5_6dS(!s1 Object-oriented filesystem path representation. iN(tisabstexiststnormpathtabspathtsplitext(tbasenametdirname(tjoin(tsep(tlistdirtutimetstat(tS_ISREGtS_ISDIR(tplatform(tsha1(tERROR_FILE_NOT_FOUNDtERROR_PATH_NOT_FOUND(tERROR_INVALID_NAMEtERROR_DIRECTORYtO_BINARY(t WindowsErrorcCstS(s Always return 'false' if the operating system does not support symlinks. @param path: a path string. @type path: L{str} @return: false (tFalse(tpath((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt _stub_islink'scCs>gt|D]}tjd^q }djtt|S(s Provide random data in versions of Python prior to 2.4. This is an effectively compatible replacement for 'os.urandom'. @type n: L{int} @param n: the number of bytes of data to return @return: C{n} bytes of random data. @rtype: str it(txrangetrandomt randrangeRtmaptchr(tnt randomData((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt _stub_urandom2s (cCs |jdS(s ASCII-armor for random data. This uses a hex encoding, although we will prefer url-safe base64 encoding for features in this module if it is available. thex(tencode(ts((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt _stub_armor@stislinkturandomturlsafe_b64encodet InsecurePathcBseZdZRS(sM Error that is raised when the path provided to FilePath is invalid. (t__name__t __module__t__doc__(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR)Lst LinkErrorcBseZdZRS(s An error with symlinks - either that there are cyclical symlinks or that symlink are not supported on this platform. (R*R+R,(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR-SstUnlistableErrorcBseZdZdZRS(s An exception which is used to distinguish between errors which mean 'this is not a directory you can list' and other, more catastrophic errors. This error will try to look as much like the original error as possible, while still being catchable as an independent type. @ivar originalException: the actual original exception instance, either an L{OSError} or a L{WindowsError}. cCs |jj|j||_dS(sq Create an UnlistableError exception. @param originalException: an instance of OSError. N(t__dict__tupdatetoriginalException(tselfR1((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt__init__fs(R*R+R,R3(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR.[s t_WindowsUnlistableErrorcBseZdZRS(s* This exception is raised on Windows, for compatibility with previous releases of FilePath where unportable programs may have done "except WindowsError:" around a call to children(). It is private because all application code may portably catch L{UnlistableError} instead. (R*R+R,(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR4qscCs tttdjd S(sQ Create a pseudorandom, 16-character string for use in secure filenames. i@i(tarmorRt randomBytestdigest(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt_secureEnoughString}st _PathHelpercBsteZdZdZdZdZd dZdZdZ dZ dZ d Z d Z d ZRS( s] Abstract helper class also used by ZipPath; implements certain utility methods. cCs,|j}z|jSWd|jXdS(N(topentreadtclose(R2tfp((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt getContents ccs@|}|j}x'||kr;|V|}|j}qWdS(s @return: an iterator of all the ancestors of this path, from the most recent (its immediate parent) to the root of its filesystem. N(tparent(R2RR?((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytparentss  cCsy|j}Wntk rd}t|d|j}|ttttfkrUnt|n@t k r}|jtj tj fkrnt |nXt |j|S(s List the children of this path object. @raise OSError: If an error occurs while listing the directory. If the error is 'serious', meaning that the operation failed due to an access violation, exhaustion of some kind of resource (file descriptors or memory), OSError or a platform-specific variant will be raised. @raise UnlistableError: If the inability to list the directory is due to this path not existing or not being a directory, the more specific OSError subclass L{UnlistableError} is raised instead. @return: an iterable of all currently-existing children of this object accessible with L{_PathHelper.child}. twinerror(R RtgetattrterrnoRRRRR4tOSErrortENOENTtENOTDIRR.Rtchild(R2tsubnamest winErrObjRAtose((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytchildrens ccs|V|jrx|jD]}|dks<||rx`|j|D]G}tjj|jjtjj|jrtdn|VqLWq|VqWndS(s Yield myself, then each of my children, and each of those children's children in turn. The optional argument C{descend} is a predicate that takes a FilePath, and determines whether or not that FilePath is traversed/descended into. It will be called with each path for which C{isdir} returns C{True}. If C{descend} is not specified, all directories will be traversed (including symbolic links which refer to directories). @param descend: A one-argument callable that will return True for FilePaths that should be traversed, False otherwise. @return: a generator yielding FilePath-like objects. sCycle in file graph.N( tisdirRKtNonetwalktosRtrealpatht startswithR-(R2tdescendtctsubc((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRNs  cCs|jj|S(N(R?RG(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytsiblingscCs*|}x|D]}|j|}q W|S(sM Retrieve a child or child's child of this path. @param segments: A sequence of path segments as C{str} instances. @return: A L{FilePath} constructed by looking up the C{segments[0]} child of this path, the C{segments[1]} child of that path, and so on. @since: 10.2 (RG(R2tsegmentsRtname((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt descendants  cCs|}|j}g}xD||kr^||kr^|jg|dd+|}|j}qW||kru|ru|Std||fdS(s Return a list of segments between a child and its ancestor. For example, in the case of a path X representing /a/b/c/d and a path Y representing /a/b, C{Y.segmentsFrom(X)} will return C{['c', 'd']}. @param ancestor: an instance of the same class as self, ostensibly an ancestor of self. @raise: ValueError if the 'ancestor' parameter is not actually an ancestor, i.e. a path for /x/y/z is passed as an ancestor for /a/b/c/d. @return: a list of strs is%r not parent of %rN(R?Rt ValueError(R2tancestortftpRV((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt segmentsFroms cCst|j|jfS(sO Hash the same as another FilePath with the same path as mine. (thasht __class__R(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt__hash__.scCst|jS(s? Deprecated. Use getModificationTime instead. (tinttgetModificationTime(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytgetmtime6scCst|jS(s9 Deprecated. Use getAccessTime instead. (Rat getAccessTime(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytgetatime=scCst|jS(s? Deprecated. Use getStatusChangeTime instead. (RatgetStatusChangeTime(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytgetctimeDsN(R*R+R,R>R@RKRMRNRURXR]R`RcReRg(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR9s   9      tFilePathcBseZdZd3Zd3ZedZdZdZ dZ dZ dZ dZ dZd Zd d Zed Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%d Z&d!Z'd"Z(d#Z)d$Z*d%Z+d&Z,d'd(Z-d)Z.d*Z/d+d,Z0d-Z1d.d/Z2d0d0d4Z3ed1Z4ed2Z5RS(5s I am a path on the filesystem that only permits 'downwards' access. Instantiate me with a pathname (for example, FilePath('/home/myuser/public_html')) and I will attempt to only provide access to files which reside inside that path. I may be a path to a file, a directory, or a file which does not exist. The correct way to use me is to instantiate me, and then do ALL filesystem access through me. In other words, do not import the 'os' module; if you need to open a file, call my 'open' method. If you need to list a directory, call my 'path' method. Even if you pass me a relative path, I will convert that to an absolute path internally. Note: although time-related methods do return floating-point results, they may still be only second resolution depending on the platform and the last value passed to L{os.stat_float_times}. If you want greater-than-second precision, call C{os.stat_float_times(True)}, or use Python 2.5. Greater-than-second precision is only available in Windows on Python2.5 and later. @type alwaysCreate: C{bool} @ivar alwaysCreate: When opening this file, only succeed if the file does not already exist. @type path: C{str} @ivar path: The path from which 'downward' traversal is permitted. @ivar statinfo: The currently cached status information about the file on the filesystem that this L{FilePath} points to. This attribute is C{None} if the file is in an indeterminate state (either this L{FilePath} has not yet had cause to call C{stat()} yet or L{FilePath.changed} indicated that new information is required), 0 if C{stat()} was called and returned an error (i.e. the path did not exist when C{stat()} was called), or a C{stat_result} object that describes the last known status of the underlying file (or directory, as the case may be). Trust me when I tell you that you do not want to use this attribute. Instead, use the methods on L{FilePath} which give you information about it, like C{getsize()}, C{isdir()}, C{getModificationTime()}, and so on. @type statinfo: C{int} or L{types.NoneType} or L{os.stat_result} cCst||_||_dS(N(RRt alwaysCreate(R2RRi((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR3}scCs,|jj}|jdr(|d=n|S(Ntstatinfo(R/tcopythas_key(R2td((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt __getstate__s cCstjr1|jdr1td|fnt|}t|kr_td|fntt|j|}|j |jstd||jfn|j |S(Nt:s%r contains a colon.s,%r contains one or more directory separatorss%r is not a child of %s( Rt isWindowstcountR)RtslashRtjoinpathRRQt clonePath(R2Rtnormtnewpath((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRGs  cCsYtt|jt|}|j|jsLtd||jfn|j|S(s Use me if `path' might have slashes in it, but you know they're safe. (NOT slashes at the beginning. It still needs to be a _child_). s%s is not a child of %s(RRsRRRQR)Rt(R2RRv((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt preauthChildscGsF|j}x6|D].}t||}t|r|j|SqWdS(s<Return my first existing child with a name in 'paths'. paths is expected to be a list of *pre-secured* path fragments; in most cases this will be specified by a system administrator and not an arbitrary user. If no appropriately-named children exist, this will return None. N(RRsRRt(R2tpathsR\RGtjp((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytchildSearchPreauths   cGs|j}x|D]}| r-|jr-|S|dkrt|d}xHtt|D]1}|j|r\|jtt||Sq\Wn||}t|r|j|SqWdS(sAttempt to return a path with my name, given multiple possible extensions. Each extension in exts will be tested and the first path which exists will be returned. If no path exists, None will be returned. If '' is in exts, then if the file referred to by this path exists, 'self' will be returned. The extension '*' has a magic meaning, which means "any path that begins with self.path+'.' is acceptable". t*t.N(RRRR RRQRtRs(R2textsR\texttbasedottfntp2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytsiblingExtensionSearchs   #  cCsP|jrLtjj|j}||jkr?tdn|j|S|S(s Returns the absolute target as a FilePath if self is a link, self otherwise. The absolute link is the ultimate file or directory the link refers to (for instance, if the link refers to another link, and another...). If the filesystem does not support symlinks, or if the link is cyclical, raises a LinkError. Behaves like L{os.path.realpath} in that it does not resolve link names in the middle (ex. /x/y/z, y is a link to w - realpath on z will return /x/y/z, not /x/w/z). @return: FilePath of the target path @raises LinkError: if links are not supported or links are cyclical. s!Cyclical link - will loop forever(R&RORRPR-Rt(R2tresult((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRPs   cCs|j|j|S(N(RtR(R2R~((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytsiblingExtensionscCstj|j|jdS(s Creates a symlink to self to at the path in the L{FilePath} C{linkFilePath}. Only works on posix systems due to its dependence on C{os.symlink}. Propagates C{OSError}s up from C{os.symlink} if C{linkFilePath.parent()} does not exist, or C{linkFilePath} already exists. @param linkFilePath: a FilePath representing the link to be created @type linkFilePath: L{FilePath} N(ROtsymlinkR(R2t linkFilePath((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytlinkTos trcCsN|jr(d|kstd|jS|jdd}t|j|dS(s Open this file using C{mode} or for writing if C{alwaysCreate} is C{True}. In all cases the file is opened in binary mode, so it is not necessary to include C{b} in C{mode}. @param mode: The mode to open the file in. Default is C{r}. @type mode: C{str} @raises AssertionError: If C{a} is included in the mode and C{alwaysCreate} is C{True}. @rtype: C{file} @return: An open C{file} object. tas1Appending not supported when alwaysCreate == TruetbR(RitAssertionErrortcreatetreplaceR:R(R2tmode((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR:s   cCsCyt|j|_Wn&tk r>d|_|r?q?nXdS(s] Re-calculate cached effects of 'stat'. To refresh information on this path after you know the filesystem may have changed, call this method. @param reraise: a boolean. If true, re-raise exceptions from L{os.stat}; otherwise, mark this path as not existing, and remove any cached stat information. iN(R RRjRD(R2treraise((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytrestat s   cCs d|_dS(sl Clear any cached information about the state of this path on disk. @since: 10.1.0 N(RMRj(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytchangedscCstj|j|dS(s Changes the permissions on self, if possible. Propagates errors from C{os.chmod} up. @param mode: integer representing the new permissions desired (same as the command line chmod) @type mode: C{int} N(ROtchmodR(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR%s cCs,|j}|s%|j|j}n|jS(N(RjRtst_size(R2tst((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytgetsize1s    cCs2|j}|s%|j|j}nt|jS(s Retrieve the time of last access from this file. @return: a number of seconds from the epoch. @rtype: float (RjRtfloattst_mtime(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRb9s    cCs2|j}|s%|j|j}nt|jS(s Retrieve the time of the last status change for this file. @return: a number of seconds from the epoch. @rtype: float (RjRRtst_ctime(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRfGs    cCs2|j}|s%|j|j}nt|jS(s Retrieve the time that this file was last accessed. @return: a number of seconds from the epoch. @rtype: float (RjRRtst_atime(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRdUs    cCsGtjrtn|j}|s:|j|j}nt|jS(s Retrieve the file serial number, also called inode number, which distinguishes this file from all other files on the same device. @raise: NotImplementedError if the platform is Windows, since the inode number would be a dummy value for all files in Windows @return: a number representing the file serial number @rtype: C{long} @since: 11.0 (RRptNotImplementedErrorRjRtlongtst_ino(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytgetInodeNumbercs     cCsGtjrtn|j}|s:|j|j}nt|jS(s Retrieves the device containing the file. The inode number and device number together uniquely identify the file, but the device number is not necessarily consistent across reboots or system crashes. @raise: NotImplementedError if the platform is Windows, since the device number would be 0 for all partitions on a Windows platform @return: a number representing the device @rtype: C{long} @since: 11.0 (RRpRRjRRtst_dev(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt getDevicexs     cCsGtjrtn|j}|s:|j|j}nt|jS(s Retrieves the number of hard links to the file. This count keeps track of how many directories have entries for this file. If the count is ever decremented to zero then the file itself is discarded as soon as no process still holds it open. Symbolic links are not counted in the total. @raise: NotImplementedError if the platform is Windows, since Windows doesn't maintain a link count for directories, and os.stat does not set st_nlink on Windows anyway. @return: the number of hard links to the file @rtype: C{int} @since: 11.0 (RRpRRjRRatst_nlink(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytgetNumberOfHardLinkss     cCsGtjrtn|j}|s:|j|j}nt|jS(s  Returns the user ID of the file's owner. @raise: NotImplementedError if the platform is Windows, since the UID is always 0 on Windows @return: the user ID of the file's owner @rtype: C{int} @since: 11.0 (RRpRRjRRatst_uid(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt getUserIDs     cCsGtjrtn|j}|s:|j|j}nt|jS(s Returns the group ID of the file. @raise: NotImplementedError if the platform is Windows, since the GID is always 0 on windows @return: the group ID of the file @rtype: C{int} @since: 11.0 (RRpRRjRRatst_gid(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt getGroupIDs     cCs/|jr tS|jt|jr'tStSdS(s Check if the C{path} exists. @return: C{True} if the stats of C{path} can be retrieved successfully, C{False} in the other cases. @rtype: C{bool} N(RjtTrueRR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRs    cCs?|j}|s2|jt|j}|s2tSnt|jS(N(RjRRR tst_mode(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRLs   cCs?|j}|s2|jt|j}|s2tSnt|jS(N(RjRRR R(R2R((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytisfiles   cCs t|jS(N(R&R(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR&scCs t|jS(N(RR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRscCs t|jS(N(R R(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR scCs t|jS(N(RR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRscCsd|jfS(Ns FilePath(%r)(R(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt__repr__scCs?y|jdjWntk r*nXt|jddS(NR(R:R<tIOErrorR RRM(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyttouchs  cCsk|jrM|j rMx|jD]}|jq&Wtj|jntj|j|jdS(s Removes the file or directory that is represented by self. If C{self.path} is a directory, recursively remove all its children before removing the directory. If it's a file or link, just delete it. N(RLR&RKtremoveROtrmdirRR(R2RG((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRs cCstj|jS(sl Create all directories not yet existing in C{path} segments, using C{os.makedirs}. (ROtmakedirsR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRscCs]ddl}|jddkr,|j|pAtj|j|g}t|j|j|S(s Assuming I am representing a directory, return a list of FilePaths representing my children that match the given pattern. iNt/(tglobRRrRRRt(R2tpatternRR((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt globChildren&s 8cCs t|jS(N(RR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR0scCs t|jS(N(RR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR3scCs|j|jS(N(RtR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyR?6ss.newcCs|j|}|jd}z|j|Wd|jXtjrkt|jrktj |jntj |j|jdS(s Replace the file at this path with a new file that contains the given bytes, trying to avoid data-loss in the meanwhile. On UNIX-like platforms, this method does its best to ensure that by the time this method returns, either the old contents I{or} the new contents of the file will be present at this path for subsequent readers regardless of premature device removal, program crash, or power loss, making the following assumptions: - your filesystem is journaled (i.e. your filesystem will not I{itself} lose data due to power loss) - your filesystem's C{rename()} is atomic - your filesystem will not discard new data while preserving new metadata (see U{http://mjg59.livejournal.com/108257.html} for more detail) On most versions of Windows there is no atomic C{rename()} (see U{http://bit.ly/win32-overwrite} for more information), so this method is slightly less helpful. There is a small window where the file at this path may be deleted before the new file is moved to replace it: however, the new file will be fully written and flushed beforehand so in the unlikely event that there is a crash at that point, it should be possible for the user to manually recover the new version of their data. In the future, Twisted will support atomic file moves on those versions of Windows which I{do} support them: see U{Twisted ticket 3004}. This method should be safe for use by multiple concurrent processes, but note that it is not easy to predict which process's contents will ultimately end up on disk if they invoke this method at close to the same time. @param content: The desired contents of the file at this path. @type content: L{str} @param ext: An extension to append to the temporary filename used to store the bytes while they are being written. This can be used to make sure that temporary files can be identified by their suffix, for cleanup in case of crashes. @type ext: C{str} twN( ttemporarySiblingR:twriteR<RRpRRROtunlinktrename(R2tcontentR~tsibR[((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt setContent:s/ cCs&t|tstSt|j|jS(N(t isinstanceRhtNotImplementedtcmpR(R2tother((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt__cmp__vscCstj|jdS(N(ROtmkdirR(R2((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytcreateDirectory{sicCs ||_dS(N(Ri(R2tval((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyt requireCreate~scCs%tj|jt}tj|dS(sOExclusively create a file, only if this file previously did not exist. sw+b(ROR:Rt _CREATE_FLAGStfdopen(R2tfdint((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRsRcCs.|jt|j|}|j|S(s Construct a path referring to a sibling of this path. The resulting path will be unpredictable, so that other subprocesses should neither accidentally attempt to refer to the same path before it is created, nor they should other processes be able to guess its name in advance. @param extension: A suffix to append to the created filename. (Note that if you want an extension with a '.' you must include the '.' yourself.) @type extension: C{str} @return: a path object with the given extension suffix, C{alwaysCreate} set to True. @rtype: L{FilePath} (RUR8RR(R2t extensionR((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRs  icCs6|jr6| r6tjtj|j|jdS|jr|js[|jnx|jD]+}|j |j }|j ||qhWn|j r&|j d}z`|j }zBx;|j|j}|j|t||jkrPqqWd|jXWd|jXn tddS(s Copies self to destination. If self is a directory, this method copies its children (but not itself) recursively to destination - if destination does not exist as a directory, this method creates it. If destination is a file, an IOError will be raised. If self is a file, this method copies it to destination. If destination is a file, this method overwrites it. If destination is a directory, an IOError will be raised. If self is a link (and followLinks is False), self will be copied over as a new symlink with the same target as returned by os.readlink. That means that if it is absolute, both the old and new symlink will link to the same thing. If it's relative, then perhaps not (and it's also possible that this relative link will be broken). File/directory permissions and ownership will NOT be copied over. If followLinks is True, symlinks are followed so that they're treated as their targets. In other words, if self is a link, the link's target will be copied. If destination is a link, self will be copied to the destination's target (the actual destination will be destination's target). Symlinks under self (if self is a directory) will be followed and its target's children be copied recursively. If followLinks is False, symlinks will be copied over as symlinks. @param destination: the destination (a FilePath) to which self should be copied @param followLinks: whether symlinks in self should be treated as links or as their targets NRs/Only copying of files and directories supported(R&RORtreadlinkRRLRRRKRGRtcopyToRR:R;t _chunkSizeRtlenR<R(R2t destinationt followLinksRGt destChildt writefiletreadfiletchunk((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRs.#       cCsytj|j|jWn}tk r}|jtjkr|j}|j|||j|||j}|j|||j qnX|j |j dS(s Move self to destination - basically renaming self to whatever destination is named. If destination is an already-existing directory, moves all children to destination if destination is empty. If destination is a non-empty directory, or destination is a file, an OSError will be raised. If moving between filesystems, self needs to be copied, and everything that applies to copyTo applies to moveTo. @param destination: the destination (a FilePath) to which self should be copied @param followLinks: whether symlinks in self should be treated as links or as their targets (only applicable when moving between filesystems) N( RORRRDRCtEXDEVRRtmoveToRR(R2RRRJtsecsibtmysecsib((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRs    Ni(6R*R+R,RMRjRRR3RnRGRwRzRRPRRR:RRRRRRbRfRdRRRRRRRLRR&RR RRRRRRRRR?RRRRRRRRR(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pyRhLsb,                               <     L(7R,RORCRtbase64tos.pathRRRRRRRRRsRRrR R R R R ttwisted.python.runtimeRttwisted.python.hashlibRttwisted.python.win32RRRRRRtO_EXCLtO_CREATtO_RDWRRRR!R%RBRR&R6R5t ExceptionR)R-RDR.R4R8R9RhRt(((s;/usr/lib/python2.7/dist-packages/twisted/python/filepath.pytsB    (