make sure help is also stylized

Signed-off-by: abzcoding <abzcoding@gmail.com>

Author: abzcoding

cmd/hget/main.go

@@ -2,7 +2,6 @@ package main
 
 import (
 	"flag"
-	"fmt"
 	"os"
 	"runtime"
 	"time"
@@ -18,6 +17,8 @@ import (
 var GitCommit string
 
 func main() {
+	flag.Usage = ui.PrintHelp
+
 	var proxy, filePath, bwLimit, resumeTask string
 
 	conn := flag.Int("n", runtime.NumCPU(), "number of connections")
@@ -77,7 +78,7 @@ func main() {
 	if len(args) < 1 {
 		if len(filePath) < 1 {
 			ui.Errorln("A URL or input file with URLs is required")
-			usage()
+			ui.PrintHelp()
 			os.Exit(1)
 		}
 		batch.RunBatchDownloads(filePath, *conn, *skiptls, proxy, bwLimit, *timeout, *verify)
@@ -121,21 +122,3 @@ func main() {
 		ui.PrintVerifySummary(verifyOK, verifyDetail)
 	}
 }
-
-func usage() {
-	fmt.Fprintf(os.Stderr, `Usage:
- hget [options] URL
- hget [options] --resume=TaskName
-
- Options:
-   -n int          number of connections (default number of CPUs)
-   -skip-tls bool  skip certificate verification for https (default false)
-   -proxy string   proxy address (e.g., '127.0.0.1:12345' for socks5 or 'http://proxy.com:8080')
-   -file string    file path containing URLs (one per line)
-   -rate string    bandwidth limit during download (e.g., 10kB, 10MiB)
-   -resume string  resume a stopped download by providing its task name or URL
-   -probe string   probe URL for range and content-length without downloading
-   -timeout        timeout for awaiting response headers (default 15s)
-   --verify        download and GPG-verify the .sig signature file after download
-`)
-}

internal/ui/ui.go

@@ -915,6 +915,97 @@ func ConfirmRedownload(filename string) bool {
 	return proceed
 }
 
+// PrintHelp renders a styled --help screen to stdout.
+func PrintHelp() {
+	// ── Banner ────────────────────────────────────────────────────────────────
+	fmt.Fprintln(Stdout, styleBanner.Render(banner))
+	fmt.Fprintln(Stdout)
+
+	w := 68 // fixed help width
+	sep := styleSep.Render(strings.Repeat("─", w))
+
+	// ── Shared style helpers ──────────────────────────────────────────────────
+	sectionHeader := lipgloss.NewStyle().
+		Foreground(colorPurple).
+		Bold(true).
+		MarginLeft(2)
+
+	flagName := lipgloss.NewStyle().
+		Foreground(colorCyan).
+		Bold(true).
+		Width(20)
+
+	flagDesc := lipgloss.NewStyle().
+		Foreground(colorWhite)
+
+	flagDefault := lipgloss.NewStyle().
+		Foreground(colorMuted)
+
+	usageLine := lipgloss.NewStyle().
+		Foreground(colorGreen).
+		MarginLeft(4)
+
+	exampleLine := lipgloss.NewStyle().
+		Foreground(colorCyan).
+		MarginLeft(4)
+
+	commentLine := lipgloss.NewStyle().
+		Foreground(colorMuted).
+		MarginLeft(4)
+
+	// ── Usage ────────────────────────────────────────────────────────────────
+	fmt.Fprintln(Stdout, sectionHeader.Render("USAGE"))
+	fmt.Fprintln(Stdout, usageLine.Render("hget [options] <url>"))
+	fmt.Fprintln(Stdout, usageLine.Render("hget [options] --resume=<task-name>"))
+	fmt.Fprintln(Stdout, usageLine.Render("hget --file=<urls-file> [options]"))
+	fmt.Fprintln(Stdout)
+	fmt.Fprintln(Stdout, sep)
+	fmt.Fprintln(Stdout)
+
+	// ── Options ───────────────────────────────────────────────────────────────
+	type opt struct{ flag, desc, def string }
+	options := []opt{
+		{"-n <int>", "number of parallel connections", "# of CPUs"},
+		{"--skip-tls", "skip TLS certificate verification", "false"},
+		{"--proxy <addr>", "proxy  (socks5: host:port  |  http: http://host:port)", ""},
+		{"--file <path>", "path to a file containing one URL per line", ""},
+		{"--rate <limit>", "bandwidth cap per download  (e.g. 10kB, 5MiB)", ""},
+		{"--resume <task>", "resume a stopped download by task name or URL", ""},
+		{"--probe <url>", "probe URL for range support & content-length only", ""},
+		{"--timeout <dur>", "timeout waiting for response headers  (e.g. 30s, 1m)", "15s"},
+		{"--verify", "download & GPG-verify the .sig signature file", "false"},
+	}
+
+	fmt.Fprintln(Stdout, sectionHeader.Render("OPTIONS"))
+	for _, o := range options {
+		line := "  " + flagName.Render(o.flag) + "  " + flagDesc.Render(o.desc)
+		if o.def != "" {
+			line += "  " + flagDefault.Render("(default: "+o.def+")")
+		}
+		fmt.Fprintln(Stdout, line)
+	}
+	fmt.Fprintln(Stdout)
+	fmt.Fprintln(Stdout, sep)
+	fmt.Fprintln(Stdout)
+
+	// ── Examples ─────────────────────────────────────────────────────────────
+	fmt.Fprintln(Stdout, sectionHeader.Render("EXAMPLES"))
+
+	examples := []struct{ comment, cmd string }{
+		{"basic download", "hget https://example.com/file.iso"},
+		{"8 connections, 5 MiB/s cap", "hget -n 8 --rate 5MiB https://example.com/large.tar.gz"},
+		{"resume an interrupted download", "hget --resume https://example.com/file.iso"},
+		{"batch download from a file", "hget --file urls.txt"},
+		{"probe server without downloading", "hget --probe https://example.com/file.iso"},
+		{"download & verify GPG signature", "hget --verify https://example.com/file.iso"},
+	}
+	for _, e := range examples {
+		fmt.Fprintln(Stdout, commentLine.Render("# "+e.comment))
+		fmt.Fprintln(Stdout, exampleLine.Render(e.cmd))
+		fmt.Fprintln(Stdout)
+	}
+}
+
 // PrintVerifySummary writes a styled one-line verify result to the terminal
 // using charmbracelet/log (works after the TUI alt-screen has closed).
 func PrintVerifySummary(ok bool, detail string) {