[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#952654: ITP: golang-github-google-renameio -- provides a way to atomically create or replace a file or symbolic link



Package: wnpp
Severity: wishlist
Owner: Anthony Fok <foka@debian.org>

* Package name    : golang-github-google-renameio
  Version         : 0.1.0-1
  Upstream Author : Michael Stapelberg
  Copyright Owner : Google Inc.
* URL             : https://github.com/google/renameio
* License         : Apache-2.0
  Programming Lang: Go
  Description     : provides a way to atomically create or replace a file or symbolic link

 The renameio Go package provides a way to atomically create or replace a
 file or symbolic link.
 .
 Atomicity vs durability
 -----------------------
 .
 renameio concerns itself only with atomicity, i.e. making sure
 applications never see unexpected file content (a half-written file,
 or a 0-byte file).
 .
 As a practical example, consider https://manpages.debian.org/: if there
 is a power outage while the site is updating, we are okay with losing the
 manpages which were being rendered at the time of the power outage. They
 will be added in a later run of the software. We are not okay with having
 a manpage replaced by a 0-byte file under any circumstances, though.


Reason for packaging:
 * Required by honnef.co/go/tools,
   which in turn is required by golang-google-api v0.16.0 and above


Reply to: