Repository files navigation

A recording store forReSwift. Enables hot-reloading and time travel for ReSwift apps.

⚠️ Proof of concept. Needs a lot of love!⚠️

The recorder was written to work withReSwift v3. It uses an internal state setter which is not supported by more recent releases of ReSwift; so the recorder would need to be rewritten.

ReSwiftRecorder is an extension for ReSwift that allows developers to record and replay actions. ReSwiftRecorder supports serializing these actions to disk, which allows to replay recorded sessions and to restart apps at the point you left them off.

This is especially useful during development. If you run into a crash, while recording, you now have a recorded JSON file with all the actions needed to reproduce crash. If you restart your app with this recorded session, it will crash in exactly the same way every single time - this allows you to fix the underlying issue without manually navigating through the app over and over again.

The long term goal of this extension is to implement some of the most important features fromRedux Devtools.

This extension is working - you can record and replay actions, but it still in a proof-of-concept state.

• Make it easier for developers to make actions serializable, ideally cutting down on some of the boilerplate code that is currently necessary.
• Improve the implementation of this extension, the current implementation is a hack.

You can install ReSwiftRecorder via CocoaPods by adding it to yourPodfile:

use_frameworks!source 'https://github.com/CocoaPods/Specs.git'platform :ios, '8.0'pod 'ReSwift'pod 'ReSwiftRecorder'

And runpod install.

You can install ReSwiftRecorder viaCarthage by adding the following line to your Cartfile:

github "ReSwift/ReSwift-Recorder"

When creating your app's store you need to create an instance ofRecordingStore instead of an instance ofMainStore. You also need to provide atypeMaps argument that is used to deserialize actions:

RecordingMainStore(reducer:CombinedReducer([CounterReducer(),NavigationReducer()]),    appState:AppState(), typeMaps:[counterActionTypeMap,ReSwiftRouter.typeMap], recording:"recording.json")

ThetypeMaps array is an array that maps type names (Strings) to action types.The last argumentrecording, can either benil or the path to a recording stored in the documents directory of the app. If you set the path to a specific recording, the store will load all actions upon launch and replay them, thereby restoring the state of the application.

For a practical example of how to use ReSwiftRecorder, check out theCounter App Example.