rsalmei/alive-progress

Features

• Terminal Progress Indicators - Displays animated progress bars with spinners and real-time statistics for terminal tasks.
• Progress Bar Interruption Responses - Prints a final summary of progress when a user presses Ctrl+C or an error occurs.
• Throughput Estimation - Computes and displays processing rate and estimated time to completion using exponential smoothing.
• Real-Time Throughput Displays - Shows current processing rate and estimated completion time updated in real time.
• Progress Bar Output Interceptors - Hooks into stdout and logging to redirect messages above the progress bar without corrupting its display.
• Adapter-Based Progress Trackers - Wraps any iterable with an adapter that automatically tracks and displays progress.
• Elapsed Time and ETA Calculators - Computes and displays elapsed time and ETA using exponential smoothing for accurate progress estimation.
• Manual Progress Incremeters - Sets the current progress value explicitly and increments it by arbitrary amounts.
• Automatic Iteration Adapters - Wraps any iterable to automatically advance progress and render updates without manual bar management.
• Automatic Iteration Trackers - Automatically tracks progress by wrapping any Python iterable during processing.
• Progress Bar Cleanup Handlers - Intercepts SIGINT and exceptions to restore terminal state and finalize the progress bar display gracefully.
• Throughput Calculators - Calculates and displays current processing rate and estimated completion time using exponential smoothing.
• Iterable Progress Wrappers - Wraps any iterable to automatically update a progress bar as items are processed.
• Iterable Wrappers - Wraps any iterable to automatically display progress as items are processed.
• Iterable Progress Adapters - Wraps any iterable to automatically display progress as items are processed without manual bar updates.
• Exponential Smoothing ETA Calculators - Estimates remaining time by applying exponential smoothing to observed throughput, reducing noise from variable processing speeds.
• Environment Detection - Detects terminals, Jupyter notebooks, and non-TTY outputs to select the appropriate rendering backend.
• Batch Processing Monitors - Monitors elapsed time, ETA, throughput, and completion percentage for batch processing.
• Throughput and ETA Monitors - Displays live throughput, elapsed time, and estimated completion for long-running tasks.
• Double Buffering - Maintains a hidden output buffer to compose frames before flushing to the terminal, preventing flicker and partial updates.
• Terminal Animation Frame Engines - Drives smooth progress bar updates by scheduling repaints at a configurable frame rate using terminal cursor control sequences.
• Progress Bar Appearance Customizers - Configures the bar's title, text, spinners, colors, and layout to match the application's style.
• Progress Bar Widgets - Provides an animated terminal widget with customizable spinners and bars for progress feedback.
• Progress Bars - Provides an animated progress bar for Python with spinners, bars, and ETA display.
• Iterable-Wrapping - Wraps any iterable to automatically track and display progress without manual updates.
• Log-Integrated - Intercepts print and logging calls to display them inline without disrupting the progress bar.
• Terminal Progress Bar Animations - Animates a progress bar in the terminal to give visual feedback during long-running tasks.
• Themeable - Chooses from built-in spinner, bar, and theme styles or creates custom animations using provided factory functions.
• Progress Bar Theme Factories - Provides factory functions for spinners, bars, and themes that decouple visual appearance from progress logic.
• Progress Bar Styling - Provides factory functions for customizing spinner, bar, and theme styles.
• Progress Bar Logging Integrations - Hooks into print and logging systems to display messages without disrupting the progress bar animation.
• Progress Summary Receipts - Prints a final summary receipt showing total items, elapsed time, and observed throughput upon completion.
• Jupyter Progress Bar Renderers - Detects the Jupyter environment and adapts the progress bar rendering to work inside notebook cells.
• Jupyter Notebook Progress Bars - Detects Jupyter environments and adapts progress bar rendering accordingly.
• Progress Bar Log Interceptors - Intercepts print and logging calls to display messages without breaking the progress bar.
• Progress Bar Output Targets - Directs progress output to stderr, files, or Jupyter notebooks instead of stdout.
• Progress Bar Print and Logging Hooks - Automatically hooks into standard print and logging output to display messages alongside the progress bar.
• Multi-Environment Renderers - Renders progress bars in terminals, Jupyter notebooks, and non-TTY environments with automatic detection.
• Pause and Resume Capabilities - Suspends the progress bar to return to the Python prompt and seamlessly resumes from the saved state.
• Jupyter-Adaptive - Adapts progress bar rendering to Jupyter notebooks, terminals, and non-TTY environments.
• Progress Data Accessors - Exposes current count, percentage, throughput, ETA, and elapsed time via the bar handle for programmatic use.
• Custom Spinner Animation Factories - Assembles new spinner animations using provided factories for frames, scrolling, bouncing, sequential, alongside, and delayed effects.
• Graceful Progress Bar Finalizations - Finalizes the progress bar display cleanly on unexpected errors or Ctrl+C interruptions.
• CLI Development - Progress bar with real-time throughput and animations.
• Logging and Output - Displays interactive progress bars with real-time metrics.
• Terminal UI Tools - Progress bar with real-time throughput and animations.

Star history