RxProperty

KO | EN

gitlite — search

#javascript #python #ai #typescript #golang #rust #nodejs #macos #windows #vue #security #ios #mcp #openai

(★ 85)

A get-only `BehaviorRelay ` that is (almost) equivalent to ReactiveSwift's `Property`

File Explorer

Download Latest Version (.zip)

- - RxProperty.swift
- - RxPropertyTests.swift
  - XCTestManifests.swift
- LinuxMain.swift
.gitignore
LICENSE
Package.resolved
Package.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RxProperty

A get-only `BehaviorRelay` that is (almost) equivalent to [ReactiveSwift](https://github.com/ReactiveCocoa/ReactiveSwift)'s [`Property`](https://github.com/ReactiveCocoa/ReactiveSwift/blob/1.1.0/Sources/Property.swift#L455).

This class is highly useful to encapsulate `BehaviorRelay` inside ViewModel so that other classes cannot reach its setter (unbindable) and make state management safer.

In short:

```swift
public final class 💩ViewModel<T> {
    // 💩 This is almost the same as `var state: T`.
    // DON'T EXPOSE VARIABLE!
    public let state = BehaviorRelay<T>(...)

// 💩 Exposing `Observable` is NOT a good solution either
    // because type doesn't tell us that it contains at least one value
    // and we cannot even "extract" it.
    public var stateObservable: Observable<T> {
        return state.asObservable()
    }
}
```

```swift
public final class 👍ViewModel<T> {
    // 👍 Hide variable.
    private let _state = BehaviorRelay<T>(...)

// 👍 `Property` is a better type than `Observable`.
    public let state: Property<T>
    
    public init() {
        self.state = Property(_state)
    }
}
```

## Disclaimer

Since this library should rather go to RxSwift-core, **there is no plan to release as a 3rd-party microframework** for CocoaPods/Carthage ~~/SwiftPackageManager~~.

(Swift Package Manager is supported in [inamiy/RxProperty#5](https://github.com/inamiy/RxProperty/pull/5))

If you like it, please upvote [ReactiveX/RxSwift#1118](https://github.com/ReactiveX/RxSwift/pull/1118) and join the discussion.
Current recommended way is to directly use the source code to your project.

## License

[MIT](LICENSE)

RxProperty

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

RxProperty

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README