diff options
Diffstat (limited to 'python/python2-atomicwrites/README')
-rw-r--r-- | python/python2-atomicwrites/README | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/python/python2-atomicwrites/README b/python/python2-atomicwrites/README new file mode 100644 index 0000000000..90d6650514 --- /dev/null +++ b/python/python2-atomicwrites/README @@ -0,0 +1,18 @@ +It uses a temporary file in the same directory as the given path. This +ensures that the temporary file resides on the same filesystem. + +The temporary file will then be atomically moved to the target +location: On POSIX, it will use rename if files should be overwritten, +otherwise a combination of link and unlink. On Windows, it uses +MoveFileEx through stdlib's ctypes with the appropriate flags. + +Note that with link and unlink, there's a timewindow where the file +might be available under two entries in the filesystem: The name of +the temporary file, and the name of the target file. + +Also note that the permissions of the target file may change this +way. In some situations a chmod can be issued without any concurrency +problems, but since that is not always the case, this library +doesn't do it by itself. + +This is the Python 2 build of atomicwrites. |