Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/OpenCombine/OpenCombine
Open source implementation of Apple's Combine framework for processing values over time.
https://github.com/OpenCombine/OpenCombine
cocoapods combine ios linux macos reactive-programming swift swift-package-manager tvos wasm watchos webassembly windows
Last synced: 4 days ago
JSON representation
Open source implementation of Apple's Combine framework for processing values over time.
- Host: GitHub
- URL: https://github.com/OpenCombine/OpenCombine
- Owner: OpenCombine
- License: mit
- Created: 2019-06-11T06:33:37.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-01-24T12:53:23.000Z (11 months ago)
- Last Synced: 2024-05-29T21:17:01.020Z (7 months ago)
- Topics: cocoapods, combine, ios, linux, macos, reactive-programming, swift, swift-package-manager, tvos, wasm, watchos, webassembly, windows
- Language: Swift
- Homepage:
- Size: 1.71 MB
- Stars: 2,648
- Watchers: 42
- Forks: 208
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - OpenCombine
- awesome-swift - OpenCombine - Open source implementation of Apple's Combine framework for processing values over time. (Libs / Events)
- fucking-awesome-swift - OpenCombine - Open source implementation of Apple's Combine framework for processing values over time. (Libs / Events)
- awesome-swift - OpenCombine - Open source implementation of Apple's Combine framework for processing values over time. ` 📝 6 days ago ` (Events [🔝](#readme))
README
# OpenCombine
[](https://codecov.io/gh/OpenCombine/OpenCombine)
[](https://cocoapods.org/pods/OpenCombine)
Open-source implementation of Apple's [Combine](https://developer.apple.com/documentation/combine) framework for processing values over time.
The main goal of this project is to provide a compatible, reliable and efficient implementation which can be used on Apple's operating systems before macOS 10.15 and iOS 13, as well as Linux, Windows and WebAssembly.
| **CI Status** |
|---|
|[](https://github.com/OpenCombine/OpenCombine/actions/workflows/compatibility_tests.yml)|
|[](https://github.com/OpenCombine/OpenCombine/actions/workflows/macos.yml)|
|[](https://github.com/OpenCombine/OpenCombine/actions/workflows/ubuntu.yml)|
|[](https://github.com/OpenCombine/OpenCombine/actions/workflows/windows.yml)|
|[](https://github.com/OpenCombine/OpenCombine/actions/workflows/wasm.yml)|
### Installation
`OpenCombine` contains three public targets: `OpenCombine`, `OpenCombineFoundation` and `OpenCombineDispatch` (the fourth one, `COpenCombineHelpers`, is considered private. Don't import it in your projects).
OpenCombine itself does not have any dependencies. Not even Foundation or Dispatch. If you want to use OpenCombine with Dispatch (for example for using `DispatchQueue` as `Scheduler` for operators like `debounce`, `receive(on:)` etc.), you will need to import both `OpenCombine` and `OpenCombineDispatch`. The same applies to Foundation: if you want to use, for instance, `NotificationCenter` or `URLSession` publishers, you'll need to also import `OpenCombineFoundation`.
If you develop code for multiple platforms, you may find it more convenient to import the
`OpenCombineShim` module instead. It conditionally re-exports Combine on Apple platforms (if
available), and all OpenCombine modules on other platforms. You can import `OpenCombineShim` only
when using SwiftPM. It is not currently available for CocoaPods.
##### Swift Package Manager
###### Swift Package
To add `OpenCombine` to your [SwiftPM](https://swift.org/package-manager/) package, add the `OpenCombine` package to the list of package and target dependencies in your `Package.swift` file. `OpenCombineDispatch` and `OpenCombineFoundation` products are currently not supported on WebAssembly. If your project targets WebAssembly exclusively, you should omit them from the list of your dependencies. If it targets multiple platforms including WebAssembly, depend on them only on non-WebAssembly platforms with [conditional target dependencies](https://github.com/apple/swift-evolution/blob/main/proposals/0273-swiftpm-conditional-target-dependencies.md).
```swift
dependencies: [
.package(url: "https://github.com/OpenCombine/OpenCombine.git", from: "0.14.0")
],
targets: [
.target(
name: "MyAwesomePackage",
dependencies: [
"OpenCombine",
.product(name: "OpenCombineFoundation", package: "OpenCombine"),
.product(name: "OpenCombineDispatch", package: "OpenCombine")
]
),
]
```
###### Xcode
`OpenCombine` can also be added as a SwiftPM dependency directly in your Xcode project *(requires Xcode 11 upwards)*.
To do so, open Xcode, use **File** → **Swift Packages** → **Add Package Dependency…**, enter the [repository URL](https://github.com/OpenCombine/OpenCombine.git), choose the latest available version, and activate the checkboxes:
##### CocoaPods
To add `OpenCombine` to a project using [CocoaPods](https://cocoapods.org/), add `OpenCombine` and `OpenCombineDispatch` to the list of target dependencies in your `Podfile`.
```ruby
pod 'OpenCombine', '~> 0.14.0'
pod 'OpenCombineDispatch', '~> 0.14.0'
pod 'OpenCombineFoundation', '~> 0.14.0'
```
#### Debugger Support
The file `opencombine_lldb.py` defines some `lldb` type summaries for easier debugging. These type summaries improve the way `lldb` and Xcode display some OpenCombine values.
To use `opencombine_lldb.py`, figure out its full path. Let's say the full path is `~/projects/OpenCombine/opencombine_lldb.py`. Then the following statement to your `~/.lldbinit` file:
command script import ~/projects/OpenCombine/opencombine_lldb.py
Currently, `opencombine_lldb.py` defines type summaries for these types:
- `Subscribers.Demand`
- That's all for now.
### Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).