Kombucha UDF

Kombucha UDF is a UDF library based on The Elm Architecture (TEA) concepts that helps to focus on logic of you application, rather than understanding
what is going on.

Quick start

Apply dependency in build.gradle(.kts)

• If you use android project, in your module build.gradle(.kts)

  dependencies {
      // Core dependency for main functionality
      implementation("io.github.ikarenkov:kombucha-core:${version}")
      // For convinien mapping ui and preserving loosing ui effects
      implementation("io.github.ikarenkov:kombucha-ui-adapter:${version}")
      // For testing
      testImplementation("io.github.ikarenkov:kombucha-test:${version}")    
  }

• If you use kotlin multiplatform project

  kotlin {
      sourceSets {
        commonMain.dependencies {
            // Core dependency for main functionality
            implementation("io.github.ikarenkov:kombucha-core:${version}")
            // For convinien mapping ui and preserving loosing ui effects
            implementation("io.github.ikarenkov:kombucha-ui-adapter:${version}")
        }
        commonTest.dependencies {
           // For testing
           testImplementation("io.github.ikarenkov:kombucha-test:${version}")
        }
      }
  }

Create you first simple store

Take a look at CounterFeature for
simple counter store implementation.

Store usage

// to send a message
store.accept(Msg.OnIncreaseClick)
// to observe states
store.state.collect { ... }
// to observe effectts
store.effects.collect { ... }

Artifacts

There are 3 kotlin multiplatform libraries available for jvm, ios and js. Check out modules README.md for detailed description.

1. kombucha-core - core library that contains main logic, such as store, reducer, effectHandler and so on.
2. kombucha-ui-adapter - extension of library that helps to adapt your store for UI.
3. kombucha-test - helper classes and functions that provides convenient dsl for tenting your store.

Core concept

Store

Store maintains the application's state and orchestrates the interactions between components.
Basicly, Store is a base UDF components to interact, that holds state and can accept some messages to handle. It has one input and two outputs:

Let's take a look to Store main components:

• Reducer - pure function, generates a new state and produces effects that require handling.
• EffectHandler - receives effects from the reducer and has the ability to send messages back to trigger the reducer. Our way to comunicate with the
  outer world, including any operations that are not pure. F.e. requesting data from db or api or saving data, requesting random and e.t.c.

Models

There are 3 main model: Msg, State, Eff.
Msg - describes intention to do something. It can be user click, result from your back end or anything else.
State - the state that is stored in store. It represents the state of your feature.
Eff - describes side effects, that should be executed. It's just a description of your intention to something that is not a pure function. F.e. it
can be request to load some data from backend, saving or reading data from database and e.t.c.

Store factory

You can implement StoreFactory to customize creation of the
store instead of using direct inheritance. It helps to implement dependency inversion principe. F.e. it can be used to implement exception logging

Thanks

Huge thanks for the inspiration to elmsli and Puerh.