Crates.io | ntfy |
lib.rs | ntfy |
version | 0.4.0 |
source | src |
created_at | 2022-11-08 10:33:47.148892 |
updated_at | 2023-12-14 09:31:31.847928 |
description | ntfy rust sdk |
homepage | https://github.com/yukibtc/ntfy-sdk |
repository | https://github.com/yukibtc/ntfy-sdk.git |
max_upload_size | |
id | 707965 |
size | 57,702 |
Ntfy client library to send notifications from Rust.
chrono = "0.4"
ntfy = "0.4"
tokio = { version = "1", features = ["full"] }
url = "2"
use chrono::{Duration, Local};
use ntfy::payload::{Action, ActionType};
use ntfy::{Auth, Dispatcher, NtfyError, Payload, Priority};
use url::Url;
#[tokio::main]
async fn main() -> Result<(), NtfyError> {
let dispatcher = Dispatcher::builder("https://ntfy.sh")
.credentials(Auth::new("username", "password")) // Add optional credentials
.proxy("socks5h://127.0.0.1:9050") // Add optional proxy
.build()?; // Build dispatcher
let action = Action::new(
ActionType::Http,
"Turn down",
Url::parse("https://api.nest.com")?,
);
let payload = Payload::new("mytopic")
.message("Hello, **World**!") // Add optional message
.title("Alert") // Add optiona title
.tags(vec!["warning".into()]) // Add optional tags
.priority(Priority::High) // Edit priority
.actions([action]) // Add optional actions
.click(Url::parse("https://example.com")?) // Add optional clickable url
.attach(Url::parse("https://example.com/file.jpg")?) // Add optional url attachment
.delay(Local::now() + Duration::minutes(1)) // Add optional delay
.markdown(true); // Use markdown
dispatcher.send(&payload).await.unwrap();
Ok(())
}
More examples can be found in the examples directory.
The following crate feature flags are available:
Feature | Default | Description |
---|---|---|
blocking |
No | Needed if you want to use this library in not async/await context |
This project is distributed under the MIT software license - see the LICENSE file for details
⚡ Tips: https://getalby.com/p/yuki
⚡ Lightning Address: yuki@getalby.com