Swiftpack.co - grype/SwiftAnnouncements as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by grype.
grype/SwiftAnnouncements 1.0.4
Thread-safe and block-based alternative to NSNotifications
⭐️ 0
🕓 31 weeks ago
iOS macOS watchOS tvOS linux macOS iOS
.package(url: "https://github.com/grype/SwiftAnnouncements.git", from: "1.0.4")

Announcements

CI

An event dispatch mechanism that allows broadcast of information to registered observers. It is similar to NSNotificationCenter, but with a few notable differences:

  • Any type of object can be announced
  • Subscription is block based
  • Thread-agnostic - announcements are delivered in the same thread they are announced
  • Handling of announcements does not require a run loop

Example:

// Any type can be made Announceable
extension String : Announceable { }

let announcer = Announcer()

// Observers subscribe to announcements by type
let subscription = announcer.when(String.self) { (aString, anAnnouncer) in
    print("World says: \(aString)")
}

// Notify observers by making an announcement
announcer.announce("Drink Water!")

// Stop observing by removing the subscription object
announcer.remove(subscription: subscription)

// Alternatively, use an arbitrary subscriber object for managing subscriptions:
announcer.when(String.self, subscriber:self) { (aString, anAnnouncer) in
    print("Received announcement: \(aString)")
}
announcer.ubsubscribe(self)

Threading

Behind the scenes an Announcer keeps a Registry of all Subscriptions. Access to that registry is governed by a Read-Write lock, making operations thread-safe such that no changes to the registry will take place until all announcements have been processed, and no announcements will be processed while registry contents are being modified. Handling of announcements can happen concurrently. See Tests for details...

GitHub

link
Stars: 0
Last commit: 2 weeks ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics