feat: add try function

src/main/kotlin/io.evest.simpleratelimiter/Option.kt

@@ -0,0 +1,3 @@
+package io.evest.simpleratelimiter
+
+data class Option<T>(val some: T, val exception: Exception? = null)

src/main/kotlin/io.evest.simpleratelimiter/RateLimiter.kt

@@ -35,4 +35,13 @@ object RateLimiter {
         if (exhausted)
             throw RateLimitException("Rate limit exceeded for key: $key")
     }
+
+    fun <T> T.tryBucket(
+        key: String,
+        maxCalls: Int = 1,
+        per: Duration = Duration.ofSeconds(defaultMinWait),
+    ): Option<T> = when (BucketHandler.count(key, maxCalls, per)) {
+        true -> Option(this, RateLimitException("Rate limit exceeded for key: $key"))
+        false -> Option(this)
+    }
 }