Swiftpack.co - glessard/SwiftCompatibleAtomics as Swift Package

An official Atomics library for Swift has been released! Get it at https://github.com/apple/swift-atomics

This one is now archived and only exists as a curiosity.

SwiftCompatibleAtomics

This is a source-compatible version of Karoy Lorentey's pitched Atomics submodule for the Swift standard library. His pitch is here, his implementation is here, the discussion is here.

This package uses Clang's C11 atomics support, and works with Swift 4.1 and up. It cannot make some of the guarantees that the official implementation can make, but code that is legal with import Atomics should also be legal with import SwiftCompatibleAtomics. This gives many Swift users the chance to try out the pitched functionality without having to build a custom toolchain.

While the major version is less than 1, the intention is to keep pace with the pitched implementation of Atomics, incrementing the minor version when a source-breaking change occurs in the Atomics pitch.

If and when the pitch is accepted and its implementation merged, the corresponding compatible implementation will become 1.0.0.

In the meantime, use by adding the following dependency to your project's Package.swift:

.package(url: "https://github.com/glessard/SwiftCompatibleAtomics", from: "0.7.0")

or, if you prefer to avoid source breaking changes:

.package(url: "https://github.com/glessard/SwiftCompatibleAtomics", .upToNextMinor(from: "0.7.0"))

Version History

• 0.1.0

  Initial version

• 0.2.0

  Fixed a source compatibility issue

• 0.3.0

  Renamed 'UnsafeAtomic' to 'UnsafePointerToAtomic', matching pitched implementation as of April 7th

• 0.4.0

  Implemented the solution in two protocol layers, matching pitched implementation as of April 10th

  This version fixes the compilation issue with downloadable Swift 5.1 toolchains.

• 0.5.0

  API tweaks, layout improvements for 'AtomicInteger'

• 0.6.0

  Clean up underlying interface to Clang's C11 atomics

  AtomicProtocol renamed to AtomicValue

• 0.7.0

  Further cleanup of the underlying interface to C11 atomics