Noora Progress Bar Step

Use this skill when the work has measurable completion progress.

Basic Pattern

import Noora

try await Noora().progressBarStep(
    message: "Downloading assets",
    successMessage: "Assets downloaded",
    errorMessage: "Asset download failed"
) { progress in
    let totalSteps = 100
    for step in 0 ... totalSteps {
        progress(Double(step) / Double(totalSteps))
        try await Task.sleep(nanoseconds: 40_000_000)
    }
}

Guidance

• Report values in the inclusive range 0.0 ... 1.0.
• Use this for downloads, uploads, indexing, file transforms, and batch loops.
• Update the bar at a readable cadence. Humans do not need every micro-step.

Avoid

• Faking percentage progress when only unknown-duration waiting exists. Prefer a spinner step.
• Using integer percentages directly without converting to Double.