Generate all atomics automatically (#77)

`gen-valuewrapper` is specialized to generating type-safe atomic
wrappers around `atomic.Value`. This limitation is unnecessary. Given
functions to convert an exposed type to the underlying type (referred to
as "packing" here) and back ("unpacking"), we can generate wrappers
around any backing atomic type.

This generalizes `valuewrapper` into an `atomicwrapper` implementing
said functionality, and adding opt-in support for generating CAS, Swap,
and JSON methods.

With this, we can automatically generate bool, float64, and
time.Duration atomic wrappers on top of Uint32, Uint64, and Int64
respectively, as well as their core functionality.
tree: 39d9f2d0b8004ba317f6d0bfe948fe4140ae2ba7
  1. .codecov.yml
  2. .github/
  3. .gitignore
  4. .travis.yml
  5. CHANGELOG.md
  6. LICENSE.txt
  7. Makefile
  8. README.md
  9. assert_test.go
  10. bool.go
  11. bool_ext.go
  12. bool_test.go
  13. doc.go
  14. duration.go
  15. duration_ext.go
  16. duration_test.go
  17. error.go
  18. error_ext.go
  19. error_test.go
  20. example_test.go
  21. float64.go
  22. float64_ext.go
  23. float64_test.go
  24. gen.go
  25. go.mod
  26. go.sum
  27. int32.go
  28. int32_test.go
  29. int64.go
  30. int64_test.go
  31. internal/
  32. nocmp.go
  33. nocmp_test.go
  34. stress_test.go
  35. string.go
  36. string_ext.go
  37. string_test.go
  38. tools_test.go
  39. uint32.go
  40. uint32_test.go
  41. uint64.go
  42. uint64_test.go
  43. value.go
  44. value_test.go
README.md

atomic GoDoc Build Status Coverage Status Go Report Card

Simple wrappers for primitive types to enforce atomic access.

Installation

$ go get -u go.uber.org/atomic@v1

Legacy Import Path

As of v1.5.0, the import path go.uber.org/atomic is the only supported way of using this package. If you are using Go modules, this package will fail to compile with the legacy import path path github.com/uber-go/atomic.

We recommend migrating your code to the new import path but if you're unable to do so, or if your dependencies are still using the old import path, you will have to add a replace directive to your go.mod file downgrading the legacy import path to an older version.

replace github.com/uber-go/atomic => github.com/uber-go/atomic v1.4.0

You can do so automatically by running the following command.

$ go mod edit -replace github.com/uber-go/atomic=github.com/uber-go/atomic@v1.4.0

Usage

The standard library‘s sync/atomic is powerful, but it’s easy to forget which variables must be accessed atomically. go.uber.org/atomic preserves all the functionality of the standard library, but wraps the primitive types to provide a safer, more convenient API.

var atom atomic.Uint32
atom.Store(42)
atom.Sub(2)
atom.CAS(40, 11)

See the documentation for a complete API specification.

Development Status

Stable.


Released under the MIT License.