2023-03-07 15:41:20 +00:00
|
|
|
use std::error::Error;
|
|
|
|
use crate::queue::Queueable;
|
2022-08-29 16:59:22 +00:00
|
|
|
use crate::Scheduled;
|
2022-07-17 16:22:00 +00:00
|
|
|
use async_trait::async_trait;
|
2023-03-07 15:41:20 +00:00
|
|
|
use crate::task::{TaskType};
|
|
|
|
use crate::task::TaskHash;
|
2022-07-17 16:22:00 +00:00
|
|
|
|
2022-09-17 16:39:47 +00:00
|
|
|
pub const RETRIES_NUMBER: i32 = 20;
|
2023-03-07 15:41:20 +00:00
|
|
|
|
|
|
|
/// Task that can be executed by the queue.
|
|
|
|
///
|
|
|
|
/// The `RunnableTask` trait is used to define the behaviour of a task. You must implement this
|
|
|
|
/// trait for all tasks you want to execute.
|
2022-07-17 16:22:00 +00:00
|
|
|
#[typetag::serde(tag = "type")]
|
2022-07-31 13:32:37 +00:00
|
|
|
#[async_trait]
|
2023-03-07 15:41:20 +00:00
|
|
|
pub trait RunnableTask: Send + Sync {
|
2022-10-18 06:30:17 +00:00
|
|
|
/// Execute the task. This method should define its logic
|
2023-03-07 15:41:20 +00:00
|
|
|
async fn run(&self, queue: &mut dyn Queueable) -> Result<(), Box<dyn Error + Send + 'static>>;
|
2022-07-17 16:22:00 +00:00
|
|
|
|
2022-10-18 06:30:17 +00:00
|
|
|
/// Define the type of the task.
|
|
|
|
/// The `common` task type is used by default
|
2023-03-07 15:41:20 +00:00
|
|
|
fn task_type(&self) -> TaskType {
|
|
|
|
TaskType::default()
|
2022-07-17 16:22:00 +00:00
|
|
|
}
|
2022-08-27 15:58:38 +00:00
|
|
|
|
2022-10-18 06:30:17 +00:00
|
|
|
/// If set to true, no new tasks with the same metadata will be inserted
|
|
|
|
/// By default it is set to false.
|
2023-03-07 15:41:20 +00:00
|
|
|
fn uniq(&self) -> Option<TaskHash> {
|
|
|
|
None
|
2022-08-27 15:58:38 +00:00
|
|
|
}
|
|
|
|
|
2022-10-18 06:30:17 +00:00
|
|
|
/// This method defines if a task is periodic or it should be executed once in the future.
|
|
|
|
///
|
|
|
|
/// Be careful it works only with the UTC timezone.
|
|
|
|
///
|
|
|
|
/// Example:
|
|
|
|
///
|
2023-03-07 15:41:20 +00:00
|
|
|
/// ```rust
|
|
|
|
/// fn cron(&self) -> Option<Scheduled> {
|
|
|
|
/// let expression = "0/20 * * * Aug-Sep * 2022/1";
|
|
|
|
/// Some(Scheduled::CronPattern(expression.to_string()))
|
|
|
|
/// }
|
|
|
|
///```
|
2022-10-18 06:30:17 +00:00
|
|
|
/// In order to schedule a task once, use the `Scheduled::ScheduleOnce` enum variant.
|
2022-08-27 15:58:38 +00:00
|
|
|
fn cron(&self) -> Option<Scheduled> {
|
|
|
|
None
|
|
|
|
}
|
2022-09-17 16:39:47 +00:00
|
|
|
|
2022-10-18 06:30:17 +00:00
|
|
|
/// Define the maximum number of retries the task will be retried.
|
|
|
|
/// By default the number of retries is 20.
|
2022-09-17 16:39:47 +00:00
|
|
|
fn max_retries(&self) -> i32 {
|
|
|
|
RETRIES_NUMBER
|
|
|
|
}
|
|
|
|
|
2022-10-18 06:30:17 +00:00
|
|
|
/// Define the backoff mode
|
|
|
|
/// By default, it is exponential, 2^(attempt)
|
2022-09-17 16:39:47 +00:00
|
|
|
fn backoff(&self, attempt: u32) -> u32 {
|
|
|
|
u32::pow(2, attempt)
|
|
|
|
}
|
2022-07-17 16:22:00 +00:00
|
|
|
}
|