Abstracts external services into swappable implementations (databases, caches, files, email/SMS/push/pubsub), with built-in metrics, health checks, local-run helpers and Terraform generation.
Originally from our Lightning Server project, we've decided to separate the external service abstractions we've built such that others can use them.
You can use the abstractions here to make testing and running servers locally easier, as well as reduce your dependence on any one specific technology or deployment style.
All the services and their implementations have the following:
We've done our best to minimize the dependencies in the basis package.
mongodb-file://file-path to automatically
download and run MongoDB on your machine and connect to it.Comprehensive user guides are available for all major modules:
Incomplete and in progress. You can use Lightning Server if you want access immediately.
fun main() {
val settingsFileVirtual = """
{
"port": 8941,
"host": "127.0.0.1",
"cache": "ram",
}
""".trimIndent()
val context = object: SettingContext {
override val projectName = "my-app"
override val publicUrl = "http://localhost:8941"
override val internalSerializersModule: SerializersModule = EmptySerializersModule()
override val sharedResources = SharedResources()
}
val settings = Json.decodeFromString<MyServerSettings>(settingsFileVirtual)
runBlocking {
val cache = settings.cache(context)
repeat(5) {
val currentValue = cache.get<Int>("counter")
cache.set("counter", (currentValue ?: 0) + 1)
}
}
}
data class MyServerSettings(
val port: Int = 8080,
val host: String = "0.0.0.0",
val cache: Cache.Settings = Cache.Settings(),
)
data class Post(
override val _id: UUID = UUID.random(),
val title: String,
val content: String,
val author: String,
val postedAt: Instant,
): HasId<UUID>
fun main(database: Database) {
val table = database.collection<Post>()
runBlocking {
val newPost = table.insertOne(Post(
title = "My test post",
content = "Here's a long story about my cat.",
author = "someone@email.com",
postedAt = Clock.System.now()
))!!
table.updateOneById(newPost._id, modification {
title assign "Cat Posting"
})
table.find(condition { it.author.eq("someone@gmail.com") }, sort { it.postedAt.ascending() })
.toList()
.forEach { println(it) }
}
}
data class MyServerSettings(
val port: Int = 8080,
val host: String = "0.0.0.0",
val cache: Cache.Settings = Cache.Settings(),
)
Surfaced from shared tags and platforms — no rankings paid for.