diff --git a/glnx-console.c b/glnx-console.c index c6d93311492f38fb8a349573fd849cdb27434c34..38747652ab5ff9350a1504fc4b92dee6a74945be 100644 --- a/glnx-console.c +++ b/glnx-console.c @@ -280,6 +280,32 @@ glnx_console_progress_text_percent (const char *text, text_percent_internal (text, percentage); } +/** + * glnx_console_progress_n_items: + * @text: Show this text before the progress bar + * @current: An integer for how many items have been processed + * @total: An integer for how many items there are total + * + * On a tty, print to the console @text followed by [@current/@total], + * then an ASCII art progress bar, like glnx_console_progress_text_percent(). + * + * You must have called glnx_console_lock() before invoking this + * function. + */ +void +glnx_console_progress_n_items (const char *text, + guint current, + guint total) +{ + g_return_if_fail (current <= total); + g_return_if_fail (total > 0); + + g_autofree char *newtext = g_strdup_printf ("%s (%u/%u)", text, current, total); + /* Special case current == total to ensure we end at 100% */ + int percentage = (current == total) ? 100 : (((double)current) / total * 100); + glnx_console_progress_text_percent (newtext, percentage); +} + void glnx_console_text (const char *text) { diff --git a/glnx-console.h b/glnx-console.h index 8c1d811598bc7b5a0aece5c5a5db3309f315bd34..108dc4076555b9445b26abf79265dd9d29d1bfc5 100644 --- a/glnx-console.h +++ b/glnx-console.h @@ -36,7 +36,11 @@ void glnx_console_lock (GLnxConsoleRef *ref); void glnx_console_text (const char *text); void glnx_console_progress_text_percent (const char *text, - guint percentage); + guint percentage); + +void glnx_console_progress_n_items (const char *text, + guint current, + guint total); void glnx_console_unlock (GLnxConsoleRef *ref);