timerwheel 0.1.0

Hierarchical timer wheel for delayed task scheduling with pluggable executors.
Documentation
// Copyright © 2026-present The Timerwheel Authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/// Policy used when the timer command path is saturated.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum BackpressurePolicy {
    /// Reject the operation immediately.
    Reject,
    /// Block the caller until command capacity is available.
    Block,
}

/// Policy used when an executor rejects an expired timer task.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ExpiredTaskPolicy {
    /// Drop the expired task and record a rejected dispatch.
    Reject,
    /// Reschedule the expired task for a later retry.
    Retry,
}

/// Policy used by the default worker pool when its queue is full.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum RejectPolicy {
    /// Reject the task immediately.
    Reject,
    /// Block the caller until queue capacity is available.
    Block,
}