Crate ntfy

Ntfy

Ntfy

Description

Rust library for sending notifications over ntfy.

Example

use ntfy::prelude::*;

#[tokio::main]
async fn main() -> Result<(), Error> {
    let dispatcher = dispatcher::builder("https://ntfy.sh")
        .credentials(Auth::credentials("username", "password")) // Add optional credentials
        .proxy("socks5h://127.0.0.1:9050") // Add optional proxy
        .build_async()?; // 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(["warning"]) // 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(1639194738) // Add optional delay
        .markdown(true); // Use markdown

    dispatcher.send(&payload).await?;

    Ok(())
}

Crate Feature Flags

The following crate feature flags are available:

Feature	Default	Description
async	Yes	Use reqwest as dispatcher client
blocking	No	Use ureq as dispatcher client

More examples can be found in the examples directory.

License

This project is distributed under the MIT software license - see the LICENSE file for details

Re-exports

pub use self::dispatcher::Auth;

pub use self::dispatcher::Dispatcher;

pub use self::dispatcher::DispatcherBuilder;

pub use self::error::Error;

pub use self::payload::Payload;

pub use self::payload::Priority;

Modules

dispatcher

error

payload

Structs

Url

A parsed URL record.