Sqids (pronounced "squids") is a small library that lets you generate unique IDs from numbers. It's good for link shortening, fast & URL-safe ID generation and decoding back into numbers for quicker database lookups.
Features:
Good for:
Not good for:
Include in build.sbt:
libraryDependencies ++= "org.sqids" %% "sqids" % "0.5.0"
Simple encode & decode:
import sqids.Sqids
val sqids = Sqids.default
val id = sqids.encodeUnsafeString(1, 2, 3)
// id: String = "86Rf07"
val numbers = sqids.decode(id)
// numbers: List[Int] = List(1, 2, 3)
Note π§ Because of the algorithm's design, multiple IDs can decode back into the same sequence of numbers. If it's important to your design that IDs are canonical, you have to manually re-encode decoded numbers and check that the generated ID matches.
Randomize IDs by providing a custom alphabet:
import sqids.options.Alphabet
import sqids.Sqids
Alphabet("FxnXM1kBN6cuhsAvjW3Co7l2RePyY8DwaU04Tzt9fHQrqSVKdpimLGIJOgb5ZE")
.flatMap(Sqids.forAlphabet)
.foreach { sqids =>
val id = sqids.encodeUnsafeString(1, 2, 3)
println(id)
// B4aajs
println(sqids.decode(id))
// List(1, 2, 3)
}
Enforce a minimum length for IDs:
import sqids.Sqids
Sqids
.withMinLength(10)
.foreach { sqids =>
val id = sqids.encodeUnsafeString(1, 2, 3)
println(id)
// 86Rf07xd4z
println(sqids.decode(id))
// List(1, 2, 3)
}
Prevent specific words from appearing anywhere in the auto-generated IDs:
(Blocked ids/words does still decode to correct numbers)
import sqids.options.Blocklist
import sqids.Sqids
val sqids = Sqids.withBlocklist(Blocklist(Set("86Rf07", "se8ojk")))
val id = sqids.encodeUnsafeString(1, 2, 3)
// id: String = "ARsz1p"
sqids.decode(id)
// List(1, 2, 3)
sqids.decode("86Rf07")
// List(1, 2, 3)
sqids.decode("se8ojk")
// List(1, 2, 3)