2023-03-04 18:07:17 +00:00
|
|
|
use crate::errors::FangError;
|
2023-03-04 19:46:09 +00:00
|
|
|
use crate::queue::AsyncQueueable;
|
2022-08-29 16:59:22 +00:00
|
|
|
use crate::Scheduled;
|
2022-07-17 16:22:00 +00:00
|
|
|
use async_trait::async_trait;
|
|
|
|
|
|
|
|
const COMMON_TYPE: &str = "common";
|
2022-09-17 16:39:47 +00:00
|
|
|
pub const RETRIES_NUMBER: i32 = 20;
|
2022-10-18 06:30:17 +00:00
|
|
|
/// Implement this trait to run your custom tasks.
|
2022-07-17 16:22:00 +00:00
|
|
|
#[typetag::serde(tag = "type")]
|
2022-07-31 13:32:37 +00:00
|
|
|
#[async_trait]
|
|
|
|
pub trait AsyncRunnable: Send + Sync {
|
2022-10-18 06:30:17 +00:00
|
|
|
/// Execute the task. This method should define its logic
|
2022-08-31 17:45:13 +00:00
|
|
|
async fn run(&self, client: &mut dyn AsyncQueueable) -> Result<(), FangError>;
|
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
|
2022-07-17 16:22:00 +00:00
|
|
|
fn task_type(&self) -> String {
|
|
|
|
COMMON_TYPE.to_string()
|
|
|
|
}
|
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.
|
2022-08-27 15:58:38 +00:00
|
|
|
fn uniq(&self) -> bool {
|
|
|
|
false
|
|
|
|
}
|
|
|
|
|
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:
|
|
|
|
///
|
|
|
|
///
|
|
|
|
/**
|
|
|
|
```rust
|
|
|
|
fn cron(&self) -> Option<Scheduled> {
|
|
|
|
let expression = "0/20 * * * Aug-Sep * 2022/1";
|
|
|
|
Some(Scheduled::CronPattern(expression.to_string()))
|
|
|
|
}
|
|
|
|
```
|
|
|
|
*/
|
|
|
|
|
|
|
|
/// 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
|
|
|
}
|