DelegateProxy

KO | EN

gitlite — search

#python #llm #golang #go #linux #docker #macos #java #awesome #awesome-list #vue #pytorch #security #open-source

(★ 127)

Proxy for receive delegate events more practically

DelegateProxy Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![DelegateProxy](https://raw.githubusercontent.com/ra1028/DelegateProxy/master/Assets/DelegateProxy_Logo.png)

<H4 align="center">Proxy for receive delegate events more practically</H4>

---

## About DelegateProxy  
__DelegateProxy__ enable you to receive delegate events by subscribed handler.

This is generic version of DelegateProxy by [RxSwift](https://github.com/ReactiveX/RxSwift)

It means be able to use in combination with any other reactive-framework like [ReactiveCocoa](https://github.com/ReactiveCocoa/ReactiveCocoa) or [SwiftBond](https://github.com/SwiftBond/Bond), etc.

---

## Requirements
- Swift 3 / Xcode 8
- OS X 10.9 or later
- iOS 8.0 or later
- watchOS 2.0 or later
- tvOS 9.0 or later

---

## Installation

### [CocoaPods](https://cocoapods.org/)  
Add the following to your Podfile:
```ruby
use_frameworks!

target 'YOUR_TARGET_NAME' do
  pod 'DelegateProxy'
end
```
```sh
$ pod install
```

### [Carthage](https://github.com/Carthage/Carthage)  
Add the following to your Cartfile:
```ruby
github "ra1028/DelegateProxy"
```
```sh
$ carthage update
```

---

## Basic Example
Create `DelegateProxy` inherited class.  
```Swift
final class ScrollViewDelegateProxy: DelegateProxy, UIScrollViewDelegate, DelegateProxyType {
    func resetDelegateProxy(owner: UIScrollView) {
        owner.delegate = self
    }
}
```
It can be useful to implements extension.  
```Swift
extension UIScrollView {
    var delegateProxy: ScrollViewDelegateProxy {
        return .proxy(for: self)
    }
}
```
You can receive delegate events as following.  
```Swift
scrollView.delegateProxy
    .receive(#selector(UIScrollViewDelegate.scrollViewDidScroll(_:))) { args in
        guard let scrollView: UIScrollView = args.value(at: 0) else { return }
        print(scrollView.contentOffset)
}
```

---

## Custom Example
You can receive delegate events by `Receivable` protocol implemented class.  
Followings are examples of use DelegateProxy with reactive-frameworks.

#### With [ReactiveCocoa](https://github.com/ReactiveCocoa/ReactiveCocoa)
Create receiver class.  
```Swift
final class RACReceiver: Receivable {
    let (signal, observer) = Signal<Arguments, NoError>.pipe()

func send(arguments: Arguments) {
        observer.send(value: arguments)
    }
}
```
Extension  
```Swift
extension DelegateProxy {
    func rac_receive(selector: Selector) -> Signal<Arguments, NoError> {
        return RACReceiver().subscribe(to: self, selector: selector).signal
    }
}
```
Receive events by streams.  
```Swift
scrollView.delegateProxy
    .rac_receive(selector: #selector(UIScrollViewDelegate.scrollViewDidScroll(_:)))
    .map { $0.value(at: 0, as: UIScrollView.self)?.contentOffset }
    .skipNil()
    .observeValues { print("ContentOffset: \($0)") }
```

#### With [SwiftBond](https://github.com/SwiftBond/Bond)
Create receiver class.  
```Swift
final class BondReceiver: Receivable {
    let subject = PublishSubject<Arguments, NoError>()

func send(arguments: Arguments) {
        subject.next(arguments)
    }
}
```
Extension  
```Swift
extension DelegateProxy {
    func bnd_receive(selector: Selector) -> Signal<Arguments, NoError> {
        return BondReceiver().subscribe(to: self, selector: selector).subject.toSignal()
    }
}
```
Receive events by streams.  
```Swift
scrollView.delegateProxy
    .bnd_receive(selector: #selector(UIScrollViewDelegate.scrollViewDidScroll(_:)))
    .map { $0.value(at: 0, as: UIScrollView.self)?.contentOffset }
    .ignoreNil()
    .observeNext { print("ContentOffset: \($0)") }
```

---

## Contribution  
Welcome to fork and submit pull requests!!

Before submitting pull request, please ensure you have passed the included tests.  
If your pull request including new function, please write test cases for it.

---

## License  
DelegateProxy is released under the MIT License.

DelegateProxy

DelegateProxy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

DelegateProxy

DelegateProxy Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README