feat: dpp::co_timer

include/dpp/cluster.h

@@ -348,6 +348,16 @@ class DPP_EXPORT cluster {
 	 */
 	bool stop_timer(timer t);
 
+#ifdef DPP_CORO
+	/**
+	 * @brief Start a one-time timer. Use the co_await keyword on its return value to suspend the coroutine until the timer ends
+	 * 
+	 * @param seconds How long to run the timer for
+	 * @return awaitable<timer> co_await-able object holding the timer_handle
+	 */
+	awaitable<timer> co_timer(uint64_t seconds);
+#endif
+
 	/**
 	 * @brief Get the dm channel for a user id
 	 *

src/dpp/cluster/timer.cpp

@@ -104,6 +104,17 @@ void cluster::tick_timers() {
 	}
 }
 
+#ifdef DPP_CORO
+awaitable<timer> cluster::co_timer(uint64_t seconds) {
+	return {[this, seconds] (auto &&cb) {
+		start_timer([this, cb](dpp::timer handle) {
+			cb(handle);
+			stop_timer(handle);
+		}, seconds);
+	}};
+}
+#endif
+
 oneshot_timer::oneshot_timer(class cluster* cl, uint64_t duration, timer_callback_t callback) : owner(cl) {
 	/* Create timer */
 	th = cl->start_timer([callback, this](dpp::timer timer_handle) {