gs-hex

GS Open Source | License (MIT)

Hexadecimal conversions for Scala 3. Provides support for standard types.

• Usage
  • Dependency
  • Byte Array Conversion
  • Type Classes
• Donate

Usage

Dependency

This artifact is available in the Garrity Software Maven repository.

externalResolvers +=
  "Garrity Software Releases" at "https://maven.garrity.co/gs"

val GsHex: ModuleID =
  "gs" %% "gs-hex-v0" % "$VERSION"

Byte Array Conversion

This library is based on two functions: Hex.toHexString(Array[Byte]) and Hex.fromHexString(String).

import gs.hex.v0.Hex

val data: Array[Byte] = ???
val encoded: String = Hex.toHexString(data)
val decoded: Option[Array[Byte]] = Hex.fromHexString(encoded)

Type Classes

This library provides HexEncode[A] and HexDecode[A] for encoding and decoding arbitrary types as Hexadecimal strings. The types Array[Byte], String, Boolean, Int and Long are supported by default.

Example Type Class Implementations

given HexEncode[Array[Byte]] = new HexEncode[Array[Byte]] {
  def toHexString(data: Array[Byte]): String = Hex.toHexString(data)
}

given HexDecode[Array[Byte]] = new HexDecode[Array[Byte]] {
  def fromHexString(data: String): Option[Array[Byte]] = Hex.fromHexString(data)
}

Example Type Class Usage

def encode[A](data: A)(using HexEncode[A]): String =
  Hex.toHexString(dataToBytes(data))

def decode[A](data: String)(using HexDecode[A]): Option[A] =
  Hex.fromHexString(data).map(dataFromBytes)

Donate

Enjoy this project or want to help me achieve my goals? Consider Donating to Pat on Ko-fi.