ift-webhook 0.2.6

a convenient tool for trigger ifttt's webhooks
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# ift-webhook

[![crate.io](https://img.shields.io/crates/v/ift-webhook)](https://crates.io/crates/ift-webhook)

a simple lib binding to the [ifttt](https://ifttt.com/home)'s [webhook](https://ifttt.com/maker_webhooks) api.
there is a async interface can be activate in feature `non-blocking`.
and a time delay trigger function for delay the trigger in feature `delay`.

the blocking interface use [ureq](https://crates.io/crates/ureq),
and the non-blocking interface use [reqwest](https://crates.io/crates/reqwest) internally.

about ifttt webhook usage:
For example,You can call a url (supplied by ifttt) then receive a notification (could include data* you supplied) on you phone.

*sometimes you can set some json data (up to three fields in it) on the request, which is depends on the service webhook connected with.

# Installation

- find in [crates.io](https://crates.io/crates/ift-webhook)

- use [cargo-edit](https://crates.io/crates/cargo-edit)
```sh
cargo add ift-webhook
```

# Usage
### blocking api
*code*
```rust
    extern crate ift-webhook
    extern crate dotenv
    use ift_webhook::*

    dotenv::dotenv().unwrap();
    let event_name = dotenv::var("EVENT").unwrap();
    let api_key = dotenv::var("KEY").unwrap();
    let client = IftWHClient::new(&api_key);
    let data = WebHookData::new(Some("test1"), Some("test2"), Some("test3"));
    let res = client.trigger(&event_name, data);
    assert!(res.is_ok())
```
### non-blocking api
*Cargo.toml*
```toml
ift-webhook={version=*,default-features= false,features=["non-blocking"]}
```
*code*
```rust
    extern crate ift-webhook
    extern crate dotenv
    use ift_webhook::*

    dotenv::dotenv().unwrap();
    let event_name = dotenv::var("EVENT").unwrap();
    let api_key = dotenv::var("KEY").unwrap();
    let client = AsyncIftWHClient::new(&api_key);
    let res = client.trigger(&event_name, None).await;
    assert!(res.is_ok())
```
### non-blocking api with time delay
*Cargo.toml*
```toml
ift-webhook={version=*,default-features= false,features=["delay"]}
```
*code*
```rust
    extern crate ift-webhook
    extern crate dotenv
    use ift_webhook::*
    
    dotenv::dotenv().unwrap();
    let event_name = dotenv::var("EVENT").unwrap();
    let api_key = dotenv::var("KEY").unwrap();
    let client = AsyncIftWHClient::new(&api_key);
    let res_handler: DelayResultHandler =
        client.trigger_with_delay(&event_name, None, std::time::Duration::from_secs(5));
    ///do something else
    let res = res_handler.await;
    assert!(res.is_ok())
```