alchemist

0.2.0indexed

Facilitates type-safe arithmetic operations for physical quantities using SI units, enabling logical modeling of quantities and customizable unit extensions with easy extensibility for custom formulas.

JSJVMNativeWasm·kevincianfarini/alchemist

176

Stars

Used by

dependents

—

Health

/ 100

Alchemist

Manage physical units. Inspired by kotlin.time.Duration. Alchemist allow type safe arithmetic between different physical quantities defined in the International System of Units.

val time: Duration = 10.seconds
val length: Length = 10.kilometers
val velocity: Velocity = length / time
val acceleration: Acceleration = velocity / time
val mass: Mass = 10.kilograms
val force: Force = acceleration * mass
val energy: Energy = force * length 
val power: Power = energy / time
val area: Area = length * length 
val volume: Volume = length * length * length

Download

[versions]
alchemist = "0.2.0"

[libraries]
alchemist = { module = "io.github.kevincianfarini.alchemist:alchemist", version.ref = "alchemist" }

Alchemist's Goals

Model physical quantities as Kotlin value classes which wrap a single Long value.
Provide logical arithmetic between different physical quantities, like power = energy / time.
Allow for the implementation of custom units on physical quanities that Alchemist does not provide, such as horsepower as a unit of or Rankine degrees for .

Alchemist's Non-Goals

Using generic or floating point values as the underlying storage mechanism.
Representing arbitrary formulaic expressions.
Providing as many formulaic conversions as possible out of the box, such as energyₖ = ½ * mass * velocity².
Infinitely precise values.
Infinitely large ranges of valid values.

Platform Support

Related libraries

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

KMeasure★ 5

battery-stapleCompile-time units library for minimal runtime overhead, enabling type-safe operations, unit conversions, and arithmetic on physical quantities with extension properties and collection support.Shared: utility, math, language-extensions

deci★ 4

labaiLightweight decimal wrapper around BigDecimal simplifying fixed-point math: intuitive operators, HALF_UP rounding, high-scale division, scale-insensitive equality, handy round/eq extensions for calculations.Shared: utility, math, language-extensions

kotlinx-uuid★ 128

hfhbdIntroduces support for universally unique identifiers (UUIDs), offering serialization capabilities and compatibility across various platforms. Integrates seamlessly with existing serialization libraries for enhanced data handling.Shared: utility, language-extensions

doistx-normalize★ 71

DoistAdds support for Unicode normalization as per Unicode Standard Annex #15, extending the `String` class with a `normalize(Form)` method, supporting NFC, NFD, NFKC, and NFKD forms.Shared: utility, language-extensions

Kastro★ 42

yoxjamesCalculates astronomical events for the Moon and Sun with lazy evaluation using sequences. Supports determining solar and lunar phases, sunrise/sunset times, and more, with efficient, resource-friendly computations.Shared: utility, math

kotlinx-datetime-ext★ 36

RaedGhazalEnhances date and time manipulation with extensions and helper functions, bridging gaps with Java's `java.time` API. Features include date arithmetic, parsing, formatting, and locale support.Shared: utility, language-extensions

androidNativeArm32	✅	❌
androidNativeArm64	✅	❌
androidNativeX64	✅	❌
androidNativeX86	✅	❌
iosArm64	✅	❌
iosSimulatorArm64	✅	✅
iosX64	✅	✅
js	✅	✅
jvm	✅	✅
linuxArm64	✅	❌ (Prohibited by Tier 2 support.)
linuxX64	✅	✅
macosArm64	✅	✅
macosX64	✅	✅
mingwX64	✅	✅
tvosArm64	✅	❌
tvosSimulatorArm64	✅	✅
tvosX64	✅	✅
wasmJs	✅	✅
wasmWasi	✅	⚠️ (Some tests don't run because of KT-60964.)
watchosArm32	✅	❌
watchosArm64	✅	❌
watchosDeviceArm64	✅	❌
watchosSimuatorArm64	✅	✅
watchosX64	✅	✅