RxSugar - GitLite

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #deep-learning #linux #macos #awesome #cli #pytorch #security #mcp #open-source

RxSugar

(★ 76)

Simple RxSwift extensions for interacting with Apple APIs

File Explorer

Download Latest Version (.zip)

- - RxSwift
- Animator.swift
- AppendDisposable.swift
- CombinePrevious.swift
- IgnoreNil.swift
- Info.plist
- Map+Sugar.swift
- Map+SugarTests.swift
- ObserverBinding.swift
- OptionalType.swift
- RxsError.swift
- RxSugar.h
- Sugar.swift
- TargetActionObservable+UIKit.swift
- TargetActionObservable.swift
- UIActivityIndicator+Sugar.swift
- UIApplication+Sugar.swift
- UIApplication+SugarTests.swift
- UIButton+Sugar.swift
- UIControl+Sugar.swift
- UIDatePicker+Sugar.swift
- UIFocusGuide+Sugar.swift
- UIGestureRecognizer+Sugar.swift
- UIImageView+Sugar.swift
- UILabel+Sugar.swift
- UISwitch+Sugar.swift
- UITableView+Sugar.swift
- UITapGestureRecognizer+Sugar.swift
- UITextField+Sugar.swift
- UITextView+Sugar.swift
- UIView+Sugar.swift
- ValueBinding.swift
- ValueSetter.swift
- Variable+Sugar.swift
- Info.plist
- RxSugar-macOS.h
- Info.plist
- RxSugar-watchOS.h
- - contents.xcworkspacedata
- project.pbxproj
- AnimatorTests.swift
- CombinePreviousTests.swift
- IgnoreNilTests.swift
- Info.plist
- ObserverBindingTests.swift
- TargetActionObservableTests.swift
- UIButton+SugarTests.swift
- UIControl+SugarTests.swift
- UIDatePicker+SugarTests.swift
- UIGestureRecognizer+SugarTests.swift
- UILabel+SugarTests.swift
- UISwitch+SugarTests.swift
- UITextField+SugarTests.swift
- UITextView+SugarTests.swift
- ValueBindingTests.swift
.gitignore
.gitmodules
.travis.yml
Cartfile
Cartfile.resolved
LICENSE
README.md
RxSugar.podspec
RxSugarLogo.png
UIBarItem+Sugar.swift
UICollectionView+Sugar.swift

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="RxSugarLogo.png" alt="RxSugar Logo" width="74" height="74">  RxSugar
===

[![Travis CI](https://travis-ci.org/RxSugar/RxSugar.svg?branch=master)](https://travis-ci.org/RxSugar/RxSugar) ![platforms](https://img.shields.io/badge/platforms-iOS%20%7C%20tvOS%20%7C%20watchOS%20%7C%20macOS-333333.svg) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) [![pod](https://img.shields.io/cocoapods/v/RxSugar.svg)](https://cocoapods.org/?q=RxSugar) ![License](https://img.shields.io/badge/license-MIT-blue.svg)

Simple RxSwift extensions for interacting with Apple APIs.

## Operators that improve visualization of data flow

### _observer_ `<~` _observable_

The `<~` subscribes an observer to an observable. 
_Observer_ can be any `ObserverType`, `Variable`, or `(value)->()`closure. 
_Observable_ can be any `ObservableType`, `Variable`, or `ObservableConvertibleType`. 
This operator returns a `Disposable`.

### _disposableCollection_ `++` _disposable_

The `++` appends a `Disposable` to a collection of disposables (`DisposeBag` or `CompositeDisposable`) and returns the collection.

These operators used in combination result in an easy to visualize data flow:
```
static func bindView(view: View, model: Model, selectionHandler:(SearchResult)->()) {
	view.rxs.disposeBag
		++ view.searchResults <~ model.searchResults
		++ model.searchTerm <~ view.searchTerm
		++ selectionHandler <~ view.selectionEvents
}
```
## Foundation / UIKit extensions
RxSugar adds `Sugar` to all NSObjects as a property called rxs. The rxs property contains RxSwift bindings for many common APIs. Here are a few examples:

### NSObject
`object.rxs.disposeBag` - a collection of dispoasables that will be disposed on deinit

### UIButton
`button.rxs.tap` - an `Observable<Void>` that sends an event on every `.TouchUpInside` control event.

### UITextField
`textField.rxs.text` - a `ValueBinding<String>` that sends an event on every `.EditingChanged` control event and sets the control's text for every event sent to it.

`textField.rxs.attributedText` - a `ValueBinding<NSAttributedString>` that sends an event on every `.EditingChanged` control event and sets the control's attributedText for every event sent to it.

### UITextView
Same as UITextField, but using the `UITextViewTextDidChangeNotification` to drive events

## Adding your own Sugar
`TargetActionObservable` and `ValueBinding` provide the building blocks for creating your own interface "sugar" similar to the examples above.