Swiftpack.co - adam-zethraeus/Republished as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by adam-zethraeus.
adam-zethraeus/Republished v0.1.0
`Republished` is a property wrapper enabling nested ObservableObjects in SwiftUI.
⭐️ 6
🕓 13 weeks ago
iOS macOS
.package(url: "https://github.com/adam-zethraeus/Republished.git", from: "v0.1.0")

Republished

The @Republished proprty wrapper allows an ObservableObject nested within another ObservableObject to naturally notify SwiftUI of changes.

It was inspired by @mergesort's blog post introducing Boutique.

Problem

Nested ObservableObjects don't play well with SwiftUI.

An ObservableObject is a reference type, not a value type. This means a field on an outer ObservableObject containing an inner ObservableObject doesn't change when the inner object's one's changes. As such the outer object will not send the objectWillChange notification required for SwiftUI to know to rerender views that depend on its data.

Nested ObservableObjects are often a sign your data model needs some refactoring — but it can also be a nice way to separate code concerns. Boutique provides a data store as a nestable ObservableObject. This repo's Example App uses nested ObservableObjects to separate its 'DomainModel' from its 'ViewModel', showcasing a version of the MVVM pattern that separates view-display logic from business logic (and is a bit closer to its original form).

Usage

The outer ObservableObject should hold the inner one in a var annotated with the @Republished property wrapper.

@Republished private var inner: InnerObservableObject

The inner ObservableObject's objectWillChange notifications will be re-emitted by the outer ObservableObject, allowing it to provide SwiftUI compatible accessors derived from the inner.

var infoFromInner: String { "\(inner.info)" }

Note: The outer ObservableObject will only republish notifications from inner ObservableObjects that it actually accesses.

SPM

You can use this library via Swift Package Manger by adding a dependency in your Package.swift.

.package(url: "https://github.com/adam-zethraeus/Republished", from: "0.1.0")

Example App

The RepublishedTestApp contains a simple example of an inner ObservableObject, used by an outer ObservableObject view model, to provide data for a regular SwiftUI View.

GitHub

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

Release Notes

v0.1.0 — Initial Release
13 weeks ago

Initial release of Republished.

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