io_atomic.h

#ifndef SOURCEMETA_CORE_IO_ATOMIC_H_
#define SOURCEMETA_CORE_IO_ATOMIC_H_
 
#ifndef SOURCEMETA_CORE_IO_EXPORT
#include <sourcemeta/core/io_export.h>
#endif
 
#include <cstddef>     // std::byte
#include <filesystem>  // std::filesystem::path
#include <functional>  // std::function
#include <ostream>     // std::ostream
#include <span>        // std::span
#include <string_view> // std::string_view
 
namespace sourcemeta::core {

SOURCEMETA_CORE_IO_EXPORT
auto atomic_write_file(const std::filesystem::path &path,
                       const std::string_view contents) -> void;

SOURCEMETA_CORE_IO_EXPORT
auto atomic_write_file(const std::filesystem::path &path,
                       const std::span<const std::byte> contents) -> void;

SOURCEMETA_CORE_IO_EXPORT
auto atomic_write_file(const std::filesystem::path &path,
                       const std::function<void(std::ostream &)> &writer)
    -> void;

SOURCEMETA_CORE_IO_EXPORT
auto atomic_directory_swap(const std::filesystem::path &original,
                           const std::filesystem::path &replacement) -> void;
 
} // namespace sourcemeta::core
 
#endif