xbp 0.9.1

XBP is a zero-config build pack that can also interact with proxies, kafka, sockets, synthetic monitors.
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

//! custom help renderer
//!
//! provides stylized help banner and custom guidance
//! detects xbp projects and shows service specific commands
//! displays available services when in an xbp project directory

use crate::commands::service::{is_xbp_project, load_xbp_config};
use crate::strategies::get_all_services;
use colored::Colorize;
use tracing::info;

/// Print a stylized help banner and quick usage guide.
pub async fn print_help() {
    info!("\n{}", "XBP - eXtensible Build Pack".bright_blue().bold());
    info!("{}\n", "═".repeat(60).dimmed());
    
    info!("{} {}", "Usage:".bright_blue(), "xbp <command> [options]".yellow());
    info!("");
    
    info!("{}", "Commands:".bright_blue().bold());
    info!("  {} - List active ports and processes", "ports".cyan());
    info!("  {} - Run initial setup", "setup".cyan());
    info!("  {} - Redeploy services", "redeploy".cyan());
    info!("  {} - Show configuration", "config".cyan());
    info!("  {} - Install packages", "install".cyan());
    info!("  {} - View logs", "logs".cyan());
    info!("  {} - List PM2 processes", "list".cyan());
    info!("  {} - Start PM2 process", "start".cyan());
    info!("  {} - Manage Nginx", "nginx".cyan());
    info!("  {} - Run diagnostics", "diag".cyan());
    info!("  {} - Monitor services", "monitor".cyan());
    info!("");
    
    if is_xbp_project().await {
        info!("{}", "Service Commands:".bright_blue().bold());
        info!("  {} - List all services", "services".cyan());
        info!("  {} - Run service command", "service <cmd> <name>".cyan());
        info!("    Commands: {}", "build, install, start, dev".yellow());
        info!("");
        
        if let Ok(config) = load_xbp_config().await {
            let services = get_all_services(&config);
            if !services.is_empty() {
                info!("{}", "Available Services:".bright_green());
                for service in services.iter().take(5) {
                    info!("  • {} {}:{}", 
                        service.name.bright_cyan(), 
                        service.target.dimmed(),
                        service.port.to_string().yellow()
                    );
                }
                if services.len() > 5 {
                    info!("  {} {} more", "...and".dimmed(), (services.len() - 5).to_string().dimmed());
                }
                info!("");
            }
        }
    }
    
    info!("{}", "Options:".bright_blue().bold());
    info!("  {} - Enable debug output", "--debug".yellow());
    info!("  {} - Show help message", "--help".yellow());
    info!("  {} - Open logs directory", "--logs".yellow());
    info!("");
    
    info!("{}", "Examples:".bright_blue().bold());
    info!("  {} - Kill processes on port 3000", "xbp ports -p 3000 --kill".dimmed());
    info!("  {} - Install Docker", "xbp install docker".dimmed());
    info!("  {} - Start a process with PM2", "xbp start \"npm start\" --name my-app".dimmed());
    if is_xbp_project().await {
        info!("  {} - Build a service", "xbp service build zeus".dimmed());
        info!("  {} - Redeploy a service", "xbp redeploy zeus".dimmed());
    }
    info!("");
    info!("For more information: {}", "https://github.com/yourusername/xbp".cyan());
}