The atomic-write package

[Tags:library, mit, test]

Atomically write to a file on POSIX-compliant systems while preserving permissions.

On most Unix systems, mv is an atomic operation. This makes it simple to write to a file atomically just by using the mv operation. However, this will destroy the permissions on the original file. This library does the following to preserve permissions while atomically writing to a file:

This way, when the file is mv'ed into place, the permissions will be the ones held by the original file.

This library is based on similar implementations found in common libraries in Ruby and Python:

To use atomic-write, import the module corresponding to the type you wish to write atomically, e.g., to write a (strict) ByteString atomically:

 import System.AtomicWrite.Writer.ByteString

Then you can use the atomicWrite function that accepts a FilePath and a ByteString, e.g.:

 atomicWrite myFilePath myByteString

Properties

Versions 0.1.0.0, 0.1.0.1, 0.2.0.0, 0.2.0.1, 0.2.0.2, 0.2.0.3, 0.2.0.4, 0.2.0.5
Dependencies base (>=4.5 && <5.0), bytestring (>=0.10.4), directory, filepath, temporary, text, unix-compat [details]
License MIT
Copyright 2015 Stack Builders Inc.
Author Justin Leitgeb
Maintainer justin@stackbuilders.com
Stability Unknown
Category System
Home page https://github.com/stackbuilders/atomic-write
Bug tracker https://github.com/stackbuilders/atomic-write/issues
Source repository head: git clone git@github.com:stackbuilders/atomic-write.git
Uploaded Tue May 17 13:43:17 UTC 2016 by jsl
Distributions LTSHaskell:0.2.0.5, NixOS:0.2.0.5, Stackage:0.2.0.5, Tumbleweed:0.2.0.5
Downloads 1080 total (16 in the last 30 days)
Votes
1 []
Status Docs available [build log]
Last success reported on 2016-05-17 [all 1 reports]

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees