CombineX

简体中文

Open-source implementation of Apple's Combine for processing values over time.

Though CombineX have implemented all the Combine interface, the project is still in early development.

What is Combine

Customize handling of asynchronous events by combining event-processing operators. -- Apple

Combine is a Functional Reactive Programming (FRP) framework launched by Apple at WWDC 2019. It will definitely be the cornerstone of Swift programming in the foreseeable future.

Get Started

CombineX contains 3 products: CombineX, CXShim, and CXTest. You can simply use CombineX and ignore the presence of system Combine.

But if you develop a library, it's encouraged to use CXShim, a virtual Combine interface, so your library is backward deployable and compatible with SwiftUI. See Combine Compatible Package for more information.

CXTest is a test infrastructure for Combine, built on CXShim. It provides useful test utilities like TracingSubscriber and VirtualTimeScheduler.

Requirements

• Swift 5.0 (Xcode 10.2)

Installation

Swift Package Manager (Recommended)

package.dependencies += [
    .package(url: "https://github.com/cx-org/CombineX", from: "0.3.1"),
]

CocoaPods

pod 'CombineX', "~> 0.3.1"

Carthage

github "cx-org/CombineX" ~> 0.3.1

CXShim is only available with Swift Package Manager.

Related Projects

These libraries bring additional functionality to Combine. They are all Combine Compatible Package and you're free to switch underlying Combine implementation between CombineX and Apple's Combine.

• CXCocoa: provides Combine extensions to Cocoa, such as KVO+Publisher, Method Interception, UIBinding, Delegate Proxy, etc.
• CXExtensions: provides a collection of useful extensions for Combine, such as IgnoreError, DelayedAutoCancellable, etc.

License

CombineX is released under the MIT license. See LICENSE for details.

The following files are adapted from the Swift open source project:

• Publishers+KeyValueObserving