orbit-util

alltypes

object AnnotationUtils

fun <A : Annotation> findAnnotationInTree(clazz: Class<*>, annotation: Class<A>): A?
fun <A : Annotation> isAnnotationInTree(clazz: Class<*>, annotation: Class<A>): Boolean

interface AsyncMap<K, V>

abstract suspend fun compareAndSet(key: K, initialValue: V?, newValue: V?): Boolean
abstract suspend fun entries(): Iterable<Pair<K, V>>
abstract suspend fun get(key: K): V?
open suspend fun getOrPut(key: K, block: suspend () -> V): V
open suspend fun getValue(key: K): V
open suspend fun keys(): List<K>
open suspend fun manipulate(key: K, block: (V?) -> V?): V?
abstract suspend fun remove(key: K): Boolean
abstract suspend fun set(key: K, value: V): Unit
open suspend fun values(): List<V>

class Clock

Clock()
fun advanceTime(offset: TimeMs): Unit
val currentTime: TimeMs

object ClockUtils

fun currentTimeMillis(): Long

class ComponentContainer

ComponentContainer()
data class BeanDefinition<T>

BeanDefinition(interfaceClass: Class<T>, concreteClass: Class<out T>)
val concreteClass: Class<out T>
val interfaceClass: Class<T>

inline fun configure(config: ComponentContainerRoot.() -> Unit): Unit
fun <T> construct(beanDefinition: BeanDefinition<T>): T
fun <T> construct(concreteClass: Class<out T>): T
fun <reified T> construct(): T
fun debugString(): String
fun <T> findInstances(interfaceClass: Class<T>): Collection<T>
fun <reified T> findInstances(): Collection<T>
fun <reified R : Any> inject(): Lazy<R>
fun <T : Any> registerDefinition(concreteClass: Class<T>): Unit
fun <T : Any> registerDefinition(interfaceClass: Class<T>, concreteClass: Class<out T>): Unit
fun <T : Any> registerInstance(liveObject: T): Unit
fun <T : Any> registerInstance(interfaceClass: Class<T>, liveObject: T): Unit
fun <T> resolve(interfaceClass: Class<T>): T

class ComponentContainerRoot

ComponentContainerRoot(componentContainer: ComponentContainer)
val componentContainer: ComponentContainer
fun <reified T : Any> definition(clazz: Class<out T>): Unit
inline fun <reified T : Any> definition(body: () -> Class<out T>): Unit
fun <reified T : Any> definition(): Unit
fun <reified T : Any> externallyConfigured(config: ExternallyConfigured<T>): Unit
fun <reified T : Any> instance(obj: T): Unit
inline fun <reified T : Any> instance(body: () -> T): Unit
fun <reified T : Any> resolve(): T

class ConstantTicker

ConstantTicker(scope: CoroutineScope, targetTickRate: Long, clock: Clock, logger: KLogger? = null, exceptionHandler: ((Throwable) -> Unit)? = null, autoStart: Boolean = false, onTick: suspend () -> Unit)
fun start(): Unit
fun stop(): Unit

data class ElapsedAndResult<T>

ElapsedAndResult(elapsed: TimeMs, result: T)
val elapsed: TimeMs
val result: T

interface ExternallyConfigured<T>

abstract val instanceType: Class<out T>

abstract class HashMapBackedAsyncMap<K, V> : AsyncMap<K, V>

HashMapBackedAsyncMap()
open suspend fun compareAndSet(key: K, initialValue: V?, newValue: V?): Boolean
open suspend fun entries(): Iterable<Pair<K, V>>
open suspend fun get(key: K): V?
open suspend fun remove(key: K): Boolean
open suspend fun set(key: K, value: V): Unit

java.time.Instant

fun Instant.toTimestamp(): Timestamp

java.util.concurrent.atomic.AtomicReference

inline fun <T> AtomicReference<T>.atomicSet(crossinline block: (T) -> T): T

kotlin.collections.Collection

fun <E> Collection<E>.randomOrNull(): E?

object Pools

@JvmStatic fun createCachedPool(threadPrefix: String): CoroutineDispatcher
@JvmStatic @JvmOverloads fun createFixedPool(threadPrefix: String, maxThreads: Int = defaultParallelism): CoroutineDispatcher
@JvmStatic val defaultParallelism: Int

class RailWorker<T>

RailWorker(scope: CoroutineScope, buffer: Int = 10_000, railCount: Int = 128, logger: KLogger? = null, autoStart: Boolean = false, onMessage: suspend (T) -> Unit)
val isInitialized: Boolean
fun offer(msg: T): Boolean
suspend fun send(msg: T): Unit
fun startWorkers(): Unit
fun stopWorkers(): Unit

object RNGUtils

fun randomString(numChars: Int = 16, random: Random = Random.Default): String

class ShutdownLatch

ShutdownLatch()
fun acquire(): Unit
fun release(): Unit

class Stopwatch

val elapsed: TimeMs
@JvmStatic fun start(clock: Clock): Stopwatch

class SupervisorScope : CoroutineScope

SupervisorScope(pool: CoroutineDispatcher, exceptionHandler: (CoroutineContext, Throwable) -> Unit)
val coroutineContext: CoroutineContext

typealias TimeMs = Long
data class Timestamp

Timestamp(seconds: Long, nanos: Int)
operator fun compareTo(timestamp: Timestamp): Int
fun inFuture(): Boolean
fun inPast(): Boolean
val nanos: Int
fun now(): Timestamp
val seconds: Long

package orbit.util.concurrent

interface AsyncMap<K, V>

abstract suspend fun compareAndSet(key: K, initialValue: V?, newValue: V?): Boolean
abstract suspend fun entries(): Iterable<Pair<K, V>>
abstract suspend fun get(key: K): V?
open suspend fun getOrPut(key: K, block: suspend () -> V): V
open suspend fun getValue(key: K): V
open suspend fun keys(): List<K>
open suspend fun manipulate(key: K, block: (V?) -> V?): V?
abstract suspend fun remove(key: K): Boolean
abstract suspend fun set(key: K, value: V): Unit
open suspend fun values(): List<V>

abstract class HashMapBackedAsyncMap<K, V> : AsyncMap<K, V>

HashMapBackedAsyncMap()
open suspend fun compareAndSet(key: K, initialValue: V?, newValue: V?): Boolean
open suspend fun entries(): Iterable<Pair<K, V>>
open suspend fun get(key: K): V?
open suspend fun remove(key: K): Boolean
open suspend fun set(key: K, value: V): Unit

java.util.concurrent.atomic.AtomicReference

inline fun <T> AtomicReference<T>.atomicSet(crossinline block: (T) -> T): T

object Pools

@JvmStatic fun createCachedPool(threadPrefix: String): CoroutineDispatcher
@JvmStatic @JvmOverloads fun createFixedPool(threadPrefix: String, maxThreads: Int = defaultParallelism): CoroutineDispatcher
@JvmStatic val defaultParallelism: Int

class RailWorker<T>

RailWorker(scope: CoroutineScope, buffer: Int = 10_000, railCount: Int = 128, logger: KLogger? = null, autoStart: Boolean = false, onMessage: suspend (T) -> Unit)
val isInitialized: Boolean
fun offer(msg: T): Boolean
suspend fun send(msg: T): Unit
fun startWorkers(): Unit
fun stopWorkers(): Unit

class ShutdownLatch

ShutdownLatch()
fun acquire(): Unit
fun release(): Unit

class SupervisorScope : CoroutineScope

SupervisorScope(pool: CoroutineDispatcher, exceptionHandler: (CoroutineContext, Throwable) -> Unit)
val coroutineContext: CoroutineContext

package orbit.util.di

class ComponentContainer

ComponentContainer()
data class BeanDefinition<T>

BeanDefinition(interfaceClass: Class<T>, concreteClass: Class<out T>)
val concreteClass: Class<out T>
val interfaceClass: Class<T>

inline fun configure(config: ComponentContainerRoot.() -> Unit): Unit
fun <T> construct(beanDefinition: BeanDefinition<T>): T
fun <T> construct(concreteClass: Class<out T>): T
fun <reified T> construct(): T
fun debugString(): String
fun <T> findInstances(interfaceClass: Class<T>): Collection<T>
fun <reified T> findInstances(): Collection<T>
fun <reified R : Any> inject(): Lazy<R>
fun <T : Any> registerDefinition(concreteClass: Class<T>): Unit
fun <T : Any> registerDefinition(interfaceClass: Class<T>, concreteClass: Class<out T>): Unit
fun <T : Any> registerInstance(liveObject: T): Unit
fun <T : Any> registerInstance(interfaceClass: Class<T>, liveObject: T): Unit
fun <T> resolve(interfaceClass: Class<T>): T

class ComponentContainerRoot

ComponentContainerRoot(componentContainer: ComponentContainer)
val componentContainer: ComponentContainer
fun <reified T : Any> definition(clazz: Class<out T>): Unit
inline fun <reified T : Any> definition(body: () -> Class<out T>): Unit
fun <reified T : Any> definition(): Unit
fun <reified T : Any> externallyConfigured(config: ExternallyConfigured<T>): Unit
fun <reified T : Any> instance(obj: T): Unit
inline fun <reified T : Any> instance(body: () -> T): Unit
fun <reified T : Any> resolve(): T

interface ExternallyConfigured<T>

abstract val instanceType: Class<out T>

package orbit.util.misc

suspend inline fun <T> attempt(maxAttempts: Int = 5, initialDelay: Long = 1000, maxDelay: Long = Long.MAX_VALUE, factor: Double = 1.0, logger: KLogger? = null, body: () -> T): T
kotlin.collections.Collection

fun <E> Collection<E>.randomOrNull(): E?

object RNGUtils

fun randomString(numChars: Int = 16, random: Random = Random.Default): String

package orbit.util.reflect

object AnnotationUtils

fun <A : Annotation> findAnnotationInTree(clazz: Class<*>, annotation: Class<A>): A?
fun <A : Annotation> isAnnotationInTree(clazz: Class<*>, annotation: Class<A>): Boolean

package orbit.util.time

class Clock

Clock()
fun advanceTime(offset: TimeMs): Unit
val currentTime: TimeMs

object ClockUtils

fun currentTimeMillis(): Long

class ConstantTicker

ConstantTicker(scope: CoroutineScope, targetTickRate: Long, clock: Clock, logger: KLogger? = null, exceptionHandler: ((Throwable) -> Unit)? = null, autoStart: Boolean = false, onTick: suspend () -> Unit)
fun start(): Unit
fun stop(): Unit

data class ElapsedAndResult<T>

ElapsedAndResult(elapsed: TimeMs, result: T)
val elapsed: TimeMs
val result: T

java.time.Instant

fun Instant.toTimestamp(): Timestamp

class Stopwatch

val elapsed: TimeMs
@JvmStatic fun start(clock: Clock): Stopwatch

inline fun <T> stopwatch(clock: Clock, body: () -> T): ElapsedAndResult<T>
typealias TimeMs = Long
data class Timestamp

Timestamp(seconds: Long, nanos: Int)
operator fun compareTo(timestamp: Timestamp): Int
fun inFuture(): Boolean
fun inPast(): Boolean
val nanos: Int
fun now(): Timestamp
val seconds: Long

fun Timestamp.toInstant(): Instant!