Reactive extensions for websockets.
A lightweight abstraction layer over Starscream to make it reactive.
RxWebSocket is available through CocoaPods and Carthage. To install it, simply add the following line to your depedencies file:
pod "RxWebSocket"github "fjcaetano/RxWebSocket"Every websocket event will be sent to the stream which is an Observable<StreamEvent>.
public enum StreamEvent {
case connect
case disconnect(Error?)
case pong
case text(String)
case data(Data)
}You may receive and send text events by subscribing to the text property:
let label = UILabel()
socket.rx.text
.bind(to: label.rx.text)
sendButton.rx.tap
.flatMap { textField.text ?? "" }
.bind(to: socket.rx.text)For further details, check the Example project.
After cloning the project, pull all submodules with
git submodule update --init --recursiveRxWebSocket relies on the following for development:
To install all dependencies without hassles just run:
./install_dependencies.shWhich will install all the dependencies and virtual envs if necessary.
Xcode and Fastlane will take care of starting and stopping websocket echoservers for testing, however if you find that tests are timing out, this is usually a sign that the server is not running. If so, you can manage it running
./server.sh {start|stop|restart|status}This will tell wstests to launch an echo server on 127.0.0.1:9000. If this port
is unusable for you by any reason, you may change it in the server.sh file.
Upgrading a new Swift version requires upgrading the dependencies as well. Since the RxWebSocket is distributed through Cocoapods, Carthage and Swift Package Manager, the dependencies must be upgraded in the corresponding spec file for the three platforms:
In RxWebSocket.podspec, update swift_version and the dependencies' versions at the end of the file
Upgrade the dependencies' versions in Cartfile
Upgrade the dependencies' versions in Package.swift
Before commiting, make sure to run, at least, the test lane on Fastlane. This will run all iOS
tests.
If you want to be thorough, which is recommended and appreciated, run the ci lane, which is the
same lane Travis runs when testing PRs. This lane will run tests for iOS, tvOS and macOS, as well as
lint the project for the three package managers. If this lane passes, you can be 100% sure everything
is running as smoothly as possible.
Do you love RxWebsocket and work actively on apps that use it? We'd love if you could help us keep improving it! Feel free to message us or to start contributing right away!
RxWebSocket is available under the MIT license. See the LICENSE file for more info.