Executor
kmp-tor utilizes several different background threads for Jvm & Native which events are generated on, then dispatches them to subscribed observers' OnEvent callbacks. The Executor API allows for fine-tuning the context in which that dispatching occurs on several customizable levels.
Both io.matthewnelson.kmp.tor.runtime.RuntimeEvent and TorEvent observer APIs allow declaration of a specific Executor to be used for the individual observer. If no Executor is specified, then the io.matthewnelson.kmp.tor.runtime.RuntimeEvent.Processor and TorEvent.Processor implementations fallback to using whatever Executor was declared when they were created. This means that an Executor can be set for default behavior of how events get dispatched based off of the needs of the application, and then be selectively overridden on a per-observer basis, when necessary, for the needs of that observer and how it is used and/or implemented.
See also
Inheritors
Types
Invokes block immediately on whatever thread execute has been called from.
Utilizes Dispatchers.Main under the hood to transition events dispatched from a background thread, to the UI thread. If MainCoroutineDispatcher.immediate is available, that is always preferred.
Functions
Execute executable in desired context.