kotlinx-gettext

0.7.0indexed

Implements Gettext for internationalization, featuring a library for string translation, a compiler plugin for extracting translatable strings, and a Gradle plugin for seamless integration, enhancing i18n workflows.

JSJVM·kropp/kotlinx-gettext

Stars

—

Used by

dependents

—

Health

/ 100

Kotlinx Gettext

maven license

Gettext is a widely used internationalization (i18n) format supported by many tools. This project provides pure Kotlin implementation of Gettext.

The project consists of several parts:

kotlinx-gettext library to use in your project to translate strings.
kotlinx-gettext-plugin Kotlin compiler plugin to extract strings for translation from Kotlin code.
kotlinx-gettext-gradle-plugin to conveniently apply Kotlin compiler plugin in your Gradle build.

Usage

Library

Add the "name.kropp.kotlinx-gettext:kotlinx-gettext:0.7.0" to the dependencies of your project. The library is available on Maven Central.

Load translated strings and apply translations using an instance of I18n class.

val i18n = Gettext.load(Locale.GERMAN, Thread.currentThread().contextClassLoader.getResourceAsStream("de.po")!!)
println(i18n.tr("Hello world!"))

See sample module for a full example. Refer to GNU gettext documentation for more details.

Translation

Apply Gradle plugin to extract strings and setup gettext task:

plugins {
  id("name.kropp.kotlinx-gettext") version "0.7.0"
}

gettext {
  potFile.set(File(projectDir, "src/messages.pot"))
  keywords.set(listOf("tr","trn:1,2"))
}

Then invoke ./gradlew gettext to extract strings for translations into src/messages.pot

Translate messages with any software or service supporting Gettext format. The result will be a number of .po files, which you should put into resources.

Known issues

The library only supports Kotlin/JVM and Kotlin/JS as of now, Multiplatform Native port is in progress.
.mo files are not (yet) supported.

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

EzHook★ 48

XDMrWuAOP framework enabling method replacement at compile-time through custom hooks. Offers runtime support, original method invocation, and inlining for reduced dependency issues. Supports specific platforms.Shared: kotlin-compiler-plugin, gradle-plugin, compiler-plugin

inspekt★ 43

rnettCompile-time reflection enabling inspection of classes, functions, properties and annotations, with top-level declaration support, suspend invocation, JVM-like proxies and dependency reflection.Shared: kotlin-compiler-plugin, gradle-plugin, compiler-plugin

aspectk★ 22

Mole-LabsCompile-time aspect-oriented weaving via compiler IR transformation, injecting @Aspect/@Before advice with zero runtime overhead; supports suspend, inline, extension, expect/actual functions, inheritance, many-to-many targets, rich JoinPoint metadata.Shared: kotlin-compiler-plugin, gradle-plugin, compiler-plugin

gradle-codeowners-plugin★ 6

gmazzoEnhances build processes by propagating CODEOWNERS information to classes. Offers plugins for reporting class ownership, JVM runtime propagation, and Kotlin runtime propagation, supporting multi-module projects.Shared: kotlin-compiler-plugin, gradle-plugin, compiler-plugin

kotlin-all-static★ 2

kyay10Enhances code by automatically applying the `@JvmStatic` annotation to all functions and properties within objects and companion objects, simplifying interoperability and static member access.Shared: kotlin-compiler-plugin, gradle-plugin, compiler-plugin

validation★ 1

hfhbdCompiler plugin validates the length of string properties using annotations for minimum and maximum length constraints, throwing exceptions when conditions aren't met.Shared: kotlin-compiler-plugin, gradle-plugin, compiler-plugin