Yet another enumeration toolbox for Scala, powered by shapeless.

Artifacts

The artifacts are built for Scala 2.11, 2.12, 2.13 and Scala.js 0.6 and 1.x.

Usage

Just define your enumeration as a sealed trait (or a sealed abstract class) extended by case objects.

For instance:

sealed trait Foo
object Foo {
  case object Bar extends Foo
  case object Baz extends Foo
}

enum

Use Enum.derived[A] to derive an Enum[A] value that provides several useful methods:

import enum.Enum
val enum: Enum[Foo] = Enum.derived[Foo]
enum.values == Set(Foo.Bar, Foo.Baz)
enum.labels == Set("Bar", "Baz")
enum.encode(Foo.Bar) == "Bar"
enum.decode("Baz") == Right(Foo.Baz)
enum.decode("invalid") == Left(DecodingFailure[Foo](Set("Bar", "Baz")))
enum.decodeOpt("Baz") == Some(Foo.Baz)

See the API documentation for more details.

enum-values

Use Values.derived[A] to automatically gather all the A enumeration values as a Set[A]:

import enum.Values
val fooValues: Values[Foo] = Values.derived[Foo]
fooValues.values == Set(Foo.Bar, Foo.Baz)

See the API documentation for more details.

enum-labels

Use Labels.derived[A] to automatically gather all the A enumeration labels as a Set[String]:

import enum.Labels
val fooLabels: Labels[Foo] = Labels.derived[Foo]
fooLabels.labels == Set("Bar", "Baz")

See the API documentation for more details.

Changelog

• 3.1
  • Scala 2.12 and 2.13 support
• 3.0
  • Breaking change: the companion object’s apply method that was used to derive enumerations has been renamed to derived. The apply method still exists but it now returns the implicitly available instance (your old code may still compile with the new version but might fail at runtime).
  • Remove package julienrf
• 2.2
  • Update shapeless to 2.3.0 and Scala.js to 0.6.7
• 2.1
  • Lessen derivation implicit priority
• 2.0
  • Added support for implicit definitions in enumerations companion objects
• 1.1
  • Added Enum[A]
• 1.0
  • First release

License

This content is released under the MIT License.