waitup 1.0.0

Wait for TCP ports and HTTP endpoints to be available. Essential for Docker, K8s, and CI/CD pipelines to ensure services are ready before proceeding.
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

#![allow(
    clippy::print_stdout,
    clippy::uninlined_format_args,
    clippy::std_instead_of_core,
    reason = "example code that demonstrates library usage"
)]

//! Docker Compose integration example.
//!
//! This example shows how to use waitup in a Docker Compose environment
//! to wait for dependent services before starting your application.
//! Run with: cargo run --example `docker_compose`

use std::time::Duration;
use waitup::{wait_for_connection, Target, WaitConfig};

#[tokio::main]
async fn main() -> Result<(), waitup::WaitForError> {
    println!("\u{1F433} Docker Compose: Waiting for dependent services...");

    // Typical services in a Docker Compose setup
    let targets = vec![
        Target::tcp("postgres", 5432)?, // Database
        Target::tcp("redis", 6379)?,    // Cache
        Target::tcp("rabbitmq", 5672)?, // Message queue
        // Health check endpoint for API gateway
        Target::parse("http://api-gateway:8080/health", 200)?,
    ];

    // Configuration suitable for Docker Compose startup
    let config = WaitConfig::builder()
        .timeout(Duration::from_secs(120)) // 2 minutes for all services
        .interval(Duration::from_secs(2)) // Check every 2 seconds
        .max_interval(Duration::from_secs(10))
        .wait_for_any(false) // Wait for ALL services
        .build();

    println!("\u{1F4CB} Waiting for {} services:", targets.len());
    for target in &targets {
        println!("  - {}", target.display());
    }

    let result = wait_for_connection(&targets, &config).await?;

    println!("\u{1F389} All services are ready! Starting application...");
    println!("\u{23F1}\u{FE0F} Total wait time: {:?}", result.elapsed);

    // Simulate starting your application
    println!("\u{1F680} Application started successfully!");

    // Example: You could now execute your main application logic
    // or return success to Docker Compose to continue with the next service

    Ok(())
}