Flywheel
A simple and predictable state management library inspired by Flux + Elm + Redux. Flywheel is built on top of Corotuines using the concepts of structured concurrency. At the core, lies the State Machine which is based on actor model.
Why Flywheel?
The goal was to make the state management concept of Redux simple, understandable & easy to use in Kotlin based projects. To achieve that, we adapted only the core concepts from Redux and slightly modified them. We excluded Android, Apple or any platform-specific dependencies. It is just pure Kotlin. By doing so, you are free to choose your architecture that best suits your codebase, no need to make any big refactor to fit in Flywheel. Don't be fooled by its simplicity, Flywheel got you covered for all practical use-cases. Even if we missed anything, it can be easily extended to support your use cases.
Getting started
In Kotlin Multiplatfrom project:
kotlin {
sourceSets {
val commonMain by getting {
dependencies {
implementation("com.msabhi:flywheel:1.1.4-RC")
}
}
}
}
In Android / Gradle project:
dependencies {
implementation("com.msabhi:flywheel-android:1.1.4-RC")
}
In Apple platforms
You can use CocoaPods to install Flywheel by adding it to your Podfile:
use_frameworks!
target 'MyApp' do
pod 'Flywheel', '~> 1.1.4-RC'
end
You can use the Swift Package Manager to install Flywheel by adding the proper description to your Package.swift file:
// swift-tools-version:5.3
import PackageDescription
let package = Package(
name: "YOUR_PROJECT_NAME",
dependencies: [
.package(url: "https://github.com/abhimuktheeswarar/Flywheel.git", from: "1.1.4-RC"),
]
)
Then run swift build whenever you get prepared.
Usage
This is how a simple counter example looks like.
-
Define a state.
data class CounterState(val counter: Int = 0) : State
-
Define actions that can change the state.
sealed interface CounterAction : Action { object IncrementAction : CounterAction object DecrementAction : CounterAction }
-
Define a reducer that updates the state based on the action & current state.
val reduce = reducerForAction<CounterAction, CounterState> { action, state -> with(state) { when (action) { is CounterAction.IncrementAction -> copy(counter = counter + 1) is CounterAction.DecrementAction -> copy(counter = counter - 1) } } }
-
Create a StateReserve.
val stateReserve = StateReserve( initialState = InitialState.set(CounterState()), reduce = reduce)
-
Listen for state changes
stateReserve.states.collect { state -> println(state.counter) } -
Send actions to StateReserve to update the state.
stateReserve.dispatch(IncrementAction)
To learn more about Flywheel, head on over to our wiki.
License
Copyright (C) 2021 Abhi Muktheeswarar
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
353 Nov 6, 2022
708 Jun 29, 2022
3 May 18, 2022
1.9k Dec 20, 2022
2k Dec 30, 2022
108 Nov 11, 2022
719 Nov 19, 2022
613 Jan 3, 2023
324 Dec 17, 2022
148 Jul 4, 2022
12 Nov 29, 2022
10 May 9, 2022
38 Oct 6, 2020
6.2k Jan 8, 2023
56 Nov 1, 2022
324 Dec 17, 2022
160 Dec 25, 2022
692 Dec 17, 2022
7.3k Jan 9, 2023
125 Jan 29, 2022
7 Jun 11, 2022
759 Dec 2, 2022
2.5k Dec 28, 2022
454 Dec 21, 2022