4.0.0 se.wollan time 0.1.1 se.wollan:time # Time To be able to timestamp events in a distributed system, we use a [hybrid logical clock](https://cse.buffalo.edu/tech-reports/2014-04.pdf). For our purposes, with relatively few events and the assumption that the physical clock will progress faster than the logical in the long run, the naive HLC impl will suffice and the timestamp value will in pratice be bounded. ## Install ``` kotlin implementation("se.wollan:time:<version>") ``` [Stable versions](https://central.sonatype.com/artifact/se.wollan/time/). [Snapshot versions](https://oss.sonatype.org/content/repositories/snapshots/se/wollan/time/). ``` kotlin repositories { mavenCentral() maven("https://oss.sonatype.org/content/repositories/snapshots/") } ``` ## Usage ``` kotlin // 1. Bootstrap application val timeModule = TimeModule({ coroutineScope }, { database }) val migrator = timeModule.resolveDatabaseMigrator() val hybridLogicalClockSynchronizer = timeModule.resolveHybridLogicalClockSynchronizer() val hybridLogicalClock = timeModule.resolveHybridLogicalClock() val physicalClock = timeModule.resolvePhysicalClock() // 2. Run migration migrator.migrate() // 3. Use clocks val hlcTimestamp = hybridLogicalClock.tick() ``` https://bitbucket.org/wollan/time CC BY-NC-ND 4.0 https://creativecommons.org/licenses/by-nc-nd/4.0/ wollan wollan wollan@wollan.se scm:git:git://bitbucket.org/wollan/time.git scm:git:ssh://bitbucket.org/wollan/time.git http://bitbucket.org/wollan/time/src org.jetbrains.kotlin kotlin-stdlib-jdk8 1.8.10 compile org.jetbrains.kotlinx kotlinx-coroutines-core-jvm 1.7.3 runtime org.jetbrains.kotlinx kotlinx-serialization-core-jvm 1.6.2 runtime se.wollan data-scope 1.0.0-rc10 runtime