add to docs: Instructions on how to clear the ReSwift state.

[carstenhag]

Took me 10 minutes to figure this out, actually, I just had forgotten to call store.dispatch(ClearStore()). I am sleepy, for my defense.

I thought this would help beginners with this lib. Maybe add it to the docs or somewhere? At least with this issue it can be found via search engines.

In your StoresReducer.swift file, add another case.

func storesReducer(action: Action, state: AppState?) -> AppState {
    // if no state has been provided, create the default state
    var state = state ?? AppState()
    switch action {
    case _ as ClearStore:
        state = AppState() // creates a new AppState, like 3 lines earlier
     // [..]
    default:
        break
    }

    return state

To your Actions.swift, add an empty Action:

struct ClearStore: Action { }

Finally, inside your clearing function (Maybe an Action for a debug button) add

store.dispatch(ClearStore())

If your views subscribe to store changes, the view should immediately behave how an initial installation of your app would.

[carstenhag]

Actually, I'll reopen so a maintainer sees this and could decide if it's worthy of adding to the docs.

[dav92lee]

Is there an easy way to do this with a nested store?

eg:

func appReducer(action: Action, state: AppState?) -> AppState {
    // if no state has been provided, create the default state
    return AppState(
        accountState: accountReducer(state: state?.accountState, action: action),
        searchState: searchReducer(state: state?.searchState, action: action)
    )
}

[dav92lee]

i've done it with the following code

func appReducer(action: Action, state: AppState?) -> AppState {
    // if no state has been provided, create the default state
    var state = state ?? AppState(
        accountState: AccountState()
        searchState: SearchState()
    )
    switch action {
    case _ as clearStore:
        state = AppState(
            accountState: AccountState()
            searchState: SearchState()
        )
    default:
        state = AppState(
        accountState: accountReducer(state: state?.accountState, action: action),
        searchState: searchReducer(state: state?.searchState, action: action)
        )
    }
    return state
}

[carstenhag]

Why do you reinit your state on the default case? That doesn't seem that good? (Not sure if it clears or not in your case)

[ranhsd]

In my implementation I dispatch an action whenever I want to reset my state. This action can be dispatched either in deinit, viewWillDisapper or viewDidLoad (or of course anywhere else). When the Reducer get this action it will reset the state and return the initial one.

func chooseBuyerReducer(state: ChooseBuyerState?, action : Action) -> ChooseBuyerState {
    
    var state = state ?? chooseBuyerInitialState()
    
    switch action {
    case _ as ReSwiftInit:
        break
    case _ as ChooseBuyerActions.ResetState:
        state = chooseBuyerInitialState()
    case let action as ChooseBuyerActions.SetItem:
        state.item = action.item        
    default:
        break
    }
    
    return state
    
}

Usually I reset my state in deinit or in view did load (before I subscribe to the store)

[DivineDominion]

@carstenhag @ranhsd @dav92lee Would any of you like to whip up a small chapter for the docs and open a PR? That's the best place for reference code :)