https://github.com/stav121/tasklet
⏱️ An asynchronous task scheduling library written in Rust
https://github.com/stav121/tasklet
asychronous crates open-source rust scheduler tasklet tokio
Last synced: 5 months ago
JSON representation
⏱️ An asynchronous task scheduling library written in Rust
- Host: GitHub
- URL: https://github.com/stav121/tasklet
- Owner: stav121
- License: mit
- Created: 2020-12-22T14:19:12.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-17T12:54:34.000Z (11 months ago)
- Last Synced: 2024-05-18T13:18:20.000Z (11 months ago)
- Topics: asychronous, crates, open-source, rust, scheduler, tasklet, tokio
- Language: Rust
- Homepage: https://crates.io/crates/tasklet
- Size: 56.6 KB
- Stars: 16
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-rust - tasklet - A task scheduling library written in Rust  (Applications / Task scheduling)
- fucking-awesome-rust - tasklet - A task scheduling library written in Rust  (Applications / Task scheduling)
- fucking-awesome-rust - tasklet - A task scheduling library written in Rust  (Applications / Task scheduling)
README
[](https://circleci.com/gh/stav121/tasklet)
[](https://codecov.io/gh/stav121/tasklet)
[](https://github.com/stav121/tasklet/issues)⏱️ An asynchronous task scheduling library written in Rust
## About
`tasklet` is a task scheduling library written in Rust. It is built over `tokio` runtime and utilizes green threads
in order to run tasks asynchronously.## Dependencies
| library | version |
|---------|---------|
| cron | 0.12.1 |
| chrono | 0.4.38 |
| time | 0.3.36 |
| log | 0.4.21 |
| tokio | 1.37.0 |## How to use this library
In your `Cargo.toml` add:
```
[dependencies]
tasklet = "0.2.3"
```## Example
Find more examples in the [examples](/examples) folder.
```rust
use log::info;
use simple_logger::SimpleLogger;
use tasklet::task::TaskStepStatusErr::Error;
use tasklet::task::TaskStepStatusOk::Success;
use tasklet::{TaskBuilder, TaskScheduler};/// A simple example of a task with two steps,
/// that might work or fail sometimes.
#[tokio::main]
async fn main() {
// Init the logger.
SimpleLogger::new().init().unwrap();// A variable to be passed in the task.
let mut exec_count = 0;// Task scheduler with 1000ms loop frequency.
let mut scheduler = TaskScheduler::default(chrono::Local);// Create a task with 2 steps and add it to the scheduler.
// The second step fails every second execution.
// Append the task to the scheduler.
scheduler.add_task(
TaskBuilder::new(chrono::Local)
.every("1 * * * * * *")
.description("A simple task")
.add_step("Step 1", || {
info!("Hello from step 1");
Ok(Success) // Let the scheduler know this step was a success.
})
.add_step("Step 2", move || {
if exec_count % 2 == 0 {
exec_count += 1;
Err(Error(Some("Oh no this task failed".into()))) // Indicate that this step was a fail.
} else {
info!("Hello from step 2");
exec_count += 1;
Ok(Success) // Indicate that this step was a success.
}
})
.build(),
);// Execute the scheduler.
scheduler.run().await;
}
```## Author
Stavros Grigoriou ([stav121](github.com/stav121))