Filament

Common Thread class (and snychronization primitives) for Kotlin/Multiplatform. This allows true, pure parallelism in Kotlin where controlling an OS thread directly is feasable.
The library also offers various utilities and integration with other libraries.

Features

• Processor as a general purpose abstraction for accessing CPU related information
  • Support for querying the logical core count
• Thread as a general purpose wrapper around system threads
  • java.lang.Thread on JVM/Android
  • libpthread on Kotlin/Native targets
  • Unified support for thread names
  • Unified support for thread IDs
  • Support for setting thread affinity (pinning)
• Mutex as a simple mutex implementation
• SharedMutex as a reentrant read-write lock implementation
• Executor interface for bridging different APIs
• ThreadPool as a simple work-stealing thread pool implementation
  • Default implementation of Executor
• Future interface for unifying awaitable objects
• CompletableFuture type with atomic state as a default Future implementation
  • Create uncompleted futures with any default value
  • Create a value supplying task from an Executor and a block
• java.util.concurrent integration
  • Use any filament Executor as a JVM Executor
• kotlinx.coroutines integration
  • Use any Executor as a CoroutineDispatcher
  • Use any Deferred<T> as a Future<T>
  • Use CompletableFuture.asyncSuspend to create awaitable objects from a suspend block
  • Use Future.awaitSuspend to await any future by yielding the coroutine

More features may be added in the future. Contributions are welcome! :)

How to use it

First, add the official Karma Krafts maven repository to your settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

Then add a dependency on the library in your buildscript:

kotlin {
    commonMain {
        dependencies {
            implementation("dev.karmakrafts.filament:filament-core:<version>")
        }
    }
}