atomic-write-0.2.1.1: Atomically write to a file

# atomic-write-0.2.1.1: Atomically write to a file

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:

- If an original file exists, take those permissions and apply them to the temp file before `mv`ing the file into place.
- If the original file does not exist, create a following with default permissions (based on the currently-active umask).

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:

- Ruby on Rails includes a similar method called atomic_write
- Chef includes atomic update functionality
- There is a python library for atomically updating a file

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 atomicWriteFile function that accepts a `FilePath` and a `ByteString`, e.g.:

    atomicWriteFile myFilePath myByteString

Modules

atomic-write-0.2.1.1

- System
  Submodules
  - AtomicWrite
    Submodules
    - Writer
      Submodules
      - System.AtomicWrite.Writer.ByteString
        Submodules
        - System.AtomicWrite.Writer.ByteString.Binary
      - System.AtomicWrite.Writer.ByteStringBuilder
      - System.AtomicWrite.Writer.LazyByteString
        Submodules
        - System.AtomicWrite.Writer.LazyByteString.Binary
      - System.AtomicWrite.Writer.LazyText
        Submodules
        - System.AtomicWrite.Writer.LazyText.Binary
      - System.AtomicWrite.Writer.String
        Submodules
        - System.AtomicWrite.Writer.String.Binary
      - System.AtomicWrite.Writer.Text
        Submodules
        - System.AtomicWrite.Writer.Text.Binary