Skip to content
atomic is a go package for atomic file writing
Go
Branch: master
Clone or download
natefinch Merge pull request #2 from chowey/create-replace
Do not error if existing file does not exist.
Latest commit a62ce92 Sep 19, 2015
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit May 16, 2015
LICENSE MIT License May 17, 2015
README.md update readme May 17, 2015
atomic.go Do not error if existing file does not exist. Aug 17, 2015
file_unix.go add files May 17, 2015
file_windows.go add files May 17, 2015
zfile_windows.go add files May 17, 2015

README.md

atomic

import "github.com/natefinch/atomic"

atomic is a go package for atomic file writing

By default, writing to a file in go (and generally any language) can fail partway through... you then have a partially written file, which probably was truncated when the write began, and bam, now you've lost data.

This go package avoids this problem, by writing first to a temp file, and then overwriting the target file in an atomic way. This is easy on linux, os.Rename just is atomic. However, on Windows, os.Rename is not atomic, and so bad things can happen. By wrapping the windows API moveFileEx, we can ensure that the move is atomic, and we can be safe in knowing that either the move succeeds entirely, or neither file will be modified.

func ReplaceFile

func ReplaceFile(source, destination string) error

ReplaceFile atomically replaces the destination file or directory with the source. It is guaranteed to either replace the target file entirely, or not change either file.

func WriteFile

func WriteFile(filename string, r io.Reader) (err error)

WriteFile atomically writes the contents of r to the specified filepath. If an error occurs, the target file is guaranteed to be either fully written, or not written at all. WriteFile overwrites any file that exists at the location (but only if the write fully succeeds, otherwise the existing file is unmodified).

You can’t perform that action at this time.