OTAtomics - Multi-platform Swift thread-safe atomics library

Steffan Andrews

Last update: Jul 8, 2022

Related tags

Utility macos swift ios tvos watchos atomic ios-swift atomics swift-5 swift-5-5

Overview

OTAtomics

Multi-platform Swift thread-safe atomics library.

The library has full unit test coverage and is actively used in production.

Installation: Swift Package Manager (SPM)

Dependency within an Application

Add the package to your Xcode project using Swift Package Manager
- Select File → Swift Packages → Add Package Dependency
- Add package using https://github.com/orchetect/OTAtomics as the URL.
Import the module in your *.swift files where needed.
```
import OTAtomics
```

Dependency within a Swift Package

In your Package.swift file:

dependencies: [
    .package(url: "https://github.com/orchetect/OTAtomics", from: "1.0.0")
],

@_implementationOnly prevents the methods and properties in OTAtomics from being exported to the consumer of your SPM package.
```
@_implementationOnly import OTAtomics
```

Documentation

Most methods are implemented as category methods so they are generally discoverable.

All methods have inline help explaining their purpose and basic usage examples.

Author

Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself @orchetect.

License

Licensed under the MIT license. See LICENSE for details.

Contributions

Bug fixes and improvements are welcome. Please open an issue to discuss prior to submitting PRs.

Safe and fast access to SwiftUI PreviewDevice

SafePreviewDevice Motivation At WWDC 2019, Apple announced SwiftUI a new library for building UI in a simple and fast way. Xcode’s SwiftUI preview let

11 Jun 28, 2022

swift-highlight a pure-Swift data structure library designed for server applications that need to store a lot of styled text

swift-highlight is a pure-Swift data structure library designed for server applications that need to store a lot of styled text. The Highlight module is memory-efficient and uses slab allocations and small-string optimizations to pack large amounts of styled text into a small amount of memory, while still supporting efficient traversal through the Sequence protocol.

4 Aug 14, 2022

macOS system library in Swift

SystemKit A macOS system library in Swift based off of libtop, from Apple's top implementation. For an example usage of this library, see dshb, a macO

323 Jan 5, 2023

Swift library to develop custom Alexa Skills

AlexaSkillsKit AlexaSkillsKit is a Swift library that allows you to develop custom skills for Amazon Alexa, the voice service that powers Echo. It tak

170 Dec 27, 2022

Focus is an Optics library for Swift (where Optics includes Lens, Prisms, and Isos)

Focus Focus is an Optics library for Swift (where Optics includes Lens, Prisms, and Isos) that is inspired by Haskell's Lens library. Introduction Foc

201 Dec 31, 2022

A Swift micro library for generating Sunrise and Sunset times.

Solar A Swift helper for generating Sunrise and Sunset times. Solar performs its calculations locally using an algorithm from the United States Naval

493 Dec 25, 2022

Plugin and runtime library for using protobuf with Swift

Swift Protobuf Welcome to Swift Protobuf! Apple's Swift programming language is a perfect complement to Google's Protocol Buffer ("protobuf") serializ

4.1k Dec 28, 2022

A Swift package for rapid development using a collection of micro utility extensions for Standard Library, Foundation, and other native frameworks.

ZamzamKit ZamzamKit is a Swift package for rapid development using a collection of micro utility extensions for Standard Library, Foundation, and othe

261 Dec 15, 2022

noppefoxwolf/notion is a notion.so API library written in swift.

notion noppefoxwolf/notion is a notion.so API library written in swift. Installation Xcode Project Swift Packages [email protected]:noppefoxwolf/notion

44 Oct 7, 2022

Comments

Memory leaks
I'm putting this here until I have time to look at it, or if you would like to look at it.

<OTAtomicsThreadSafe<Optional<String>>: 0x600003d17e30>
opened by ryanfrancesconi 1
`@OTAtomicsThreadSafe` wrapper not usable on local var within a method

Issue

In its current implementation, @OTAtomicsThreadSafe is designed to work as a wrapper around variables installed in an object (class, struct, enum, etc.).

However it will strangely result in a data race when used on a variable declaration within a function. So this wrapper should not be used in this fashion.

The following code will almost always return a value that is less than 100:

Proposal

It is poor form to declare a local variable within a function and then attempt to mutate it concurrently. Better form is to take the value and pass it into a concurrent operation that can run synchronously within the method, then rely on the operation to return the fully mutated value, often by way of a completion handler closure which can be waited on.

It is not clear if there is a way to prevent the property wrapper from being used on variable declarations inside a method, as the compiler will not stop you from doing it.
enhancement

opened by orchetect 3