UgCore.Lifecycle

Shared In your resource, a mirror kept in sync by lifecycle events. States, in order: Booting, Configured, Initializing, Starting, Ready, Stopping, Stopped. States only move forward and MAY be skipped.

GetState

UgCore.Lifecycle.GetState() -> state

UgLifecycleState

The current state, such as 'Ready'.

IsReady

UgCore.Lifecycle.IsReady() -> boolean

HasReached

UgCore.Lifecycle.HasReached(state) -> boolean

false for states not reached yet and for skipped states.

On

UgCore.Lifecycle.On(state, handler)

UgLifecycleState

required

Raises for unknown states.

fun()

required

Runs when ug-core reaches state.

Sticky: runs immediately when the state was already reached. Never runs when the state was skipped. A failing handler is logged and does not stop others.

Await

UgCore.Lifecycle.Await(state, timeout?) -> reached

MUST run in a thread.

UgLifecycleState

required

integer

Milliseconds. Waits forever when nil.

boolean

false on timeout or when the state was skipped.

CreateThread(function()
    if UgCore.Lifecycle.Await('Ready', 30000) then
        -- safe to use every module
    end
end)

Overview

Core

Networking and security

Modules

Reference

UgCore.Lifecycle

GetState

IsReady

HasReached

On

Await

​GetState

​IsReady

​HasReached

​On

​Await

GetState

IsReady

HasReached

On

Await