Latest 1.1.2
Homepage https://github.com/XCEssentials/StaticState
License MIT
Platforms ios 8.0, requires ARC
Authors

GitHub tag
CocoaPods
CocoaPods
license

Introduction

Turn any object into a discrete system where each state is a static data container.

How to install

The recommended way is to install using CocoaPods:

pod 'XCEStaticState', '~> 1.1'

How it works

This library allows to turn any object into discrete system by defining a number of distinct states for any object and then set any of these states as current state of the object. Same state can be re-set multiple times without any limitations.

How to use

A typical use case for this library is to store different set of internal data at different points of time as well as indicating current internal state of a given object. Any object can only be in one particular state at any point of time, or current state might be undefined.

State

Let’s say we have class MyView

class MyView
{
    // class definition goes here...
}

… and it can only be in 3 different states: Normal, Disabled or Highlighted. Every state must be declared as an instantiatable type that conforms to State protocol. For the sake of simplicity, lets assume that Normal contains no extra data, Disabled holds opacity amount and Highlighted contains color value which is just a number that represents a code for color.

extension MyView
{
    struct Normal: State
    {
        // no members here
    }

    struct Disabled: State
    {
        var opacity: Float
    }

    struct Highlighted: State
    {
        let color: Int
    }
}

Stateful

The object which internal state we want to track must conform to Stateful protocol. This protocol does not require to implement anything, but gives exclusive access to special dynamic property:

var state: State?

We can set current state as follows:

extension MyView: Stateful { }

let aView = MyView()

aView.state = MyView.Disabled(opacity: 0.3)
aView.state = MyView.Normal()
aView.state = MyView.Highlighted(color: 1)
// 'aView.state' is now 'Highlighted' with 'color' equal to '1'

Note, that in the beginning the state property is nil until you set a value explicitly; after this it holds assigned value indefinitely until you assign another value, nil or the object itself is deallocated.

var aView = MyView()

aView.state = MyView.Normal()
// 'aView.state' is now 'Normal'

aView = MyView() // released previosly created object of type 'MyView'
// 'aView.state' is now 'nil'

aView.state = MyView.Disabled(opacity: 0.3)
// 'aView.state' is now 'Disabled' with 'opacity' equal to '0.3'

StatefulWithHelpers

StatefulWithHelpers protocol inherits from Stateful and allows to deal with state property via functions.

extension MyView: StatefulWithHelpers { }

let aView = MyView()

aView.set(MyView.Normal())
// current state of 'aView' object is now 'Normal'

aView.set(MyView.Disabled(opacity: 0.3))
// current state of 'aView' object is now 'Disabled' with 'opacity' equal to '0.3'

try? aView.update(MyView.Disabled.self){ $0.opacity += 0.2 }
// current state of 'aView' object is now 'Disabled' with 'opacity' equal to '0.5'

let d: MyView.Disabled = try! aView.currentState()
// 'd' now holds an instace of 'Disabled' type with 'opacity' equal to '0.5'

aView.resetCurrentState()
// current state of 'aView' object is now 'nil'

Latest podspec

{
    "name": "XCEStaticState",
    "summary": "Turn any object into a discrete system where each state is a static data container.",
    "version": "1.1.2",
    "homepage": "https://github.com/XCEssentials/StaticState",
    "documentation_url": "https://XCEssentials.github.io/StaticState",
    "source": {
        "git": "https://github.com/XCEssentials/StaticState.git",
        "tag": "1.1.2"
    },
    "source_files": "Src/**/*.swift",
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Maxim Khatskevich": "[email protected]"
    },
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This