github.com/eliastor/durgaform@v0.0.0-20220816172711-d0ab2d17673e/internal/replacefile/doc.go

// Package replacefile is a small helper package focused directly at the
// problem of atomically "renaming" one file over another one.
//
// On Unix systems this is the standard behavior of the rename function, but
// the equivalent operation on Windows requires some specific operation flags
// which this package encapsulates.
//
// This package uses conditional compilation to select a different
// implementation for Windows vs. all other platforms. It may therefore
// require further fiddling in future if Durgaform is ported to another
// OS that is neither Unix-like nor Windows.
package replacefile