planif 0.2.0

planif is a builder pattern wrapper for the windows task scheduler API of windows-rs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

`planif` is a builder pattern wrapper around the windows task scheduler API ([windows-rs](https://github.com/microsoft/windows-rs)).

## Functionality


The `planif` crate provides an ergonomic builder over top of the Win32 Task Scheduler API.

The builder supports the following trigger types:
- [x] Boot 
- [x] Daily 
- [X] Event 
- [X] Idle 
- [x] Logon 
- [X] MonthlyDOW 
- [x] Monthly 
- [X] Registration 
- [x] Time 
- [x] Weekly 

## Usage

Add this to your `Cargo.toml` file:
```
[dependencies]
planif = "0.2"
```

## Example


```rust
use chrono::prelude::*;
use planif::schedule::TaskCreationFlags;
use planif::schedule_builder::{Action, ScheduleBuilder};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let sb = ScheduleBuilder::new().unwrap();
    sb.create_daily()
        .author("Matt")?
        .description("Test Trigger")?
        .trigger("test_trigger", true)?
        .days_interval(1)?
        .action(Action::new("test", "notepad.exe", "", ""))?
        .start_boundary(&Local::now().to_rfc3339())?
        .build()?
        .register("TaskName", TaskCreationFlags::CreateOrUpdate as i32)?;
    Ok(())
}
```

For more examples, refer to the `planif/examples` folder. The folder contains code for creating each of the triggers.


## Trigger settings

All settings are available for the tasks.

The documentation contains all relevant information from the
[Microsoft Task Scheduler documentation](https://learn.microsoft.com/en-us/windows/win32/taskschd/task-scheduler-reference).

## Changelog

See the [changelog file](CHANGELOG.md).