Skip to main content

A simple progress bar with the ILoveCandy style

Project description

FOSSA Status


A Progress Bar inspired by Arch pacman with ILoveCandy option enabled. CandyBar



Manual instalation

Clone the repository, build, and install the package:

git clone
cd CandyBar
pip install .

Install from PyPi

pip install candy_bar


Don't like Python? Use it with C++! Clone the repository and either install the library or build against it:

git clone
cd CandyBar
make && make install


Import the package and create the progress bar object:

# Python
from candy_bar import CandyBar

cb = CandyBar(100, "Progress")
// C++
#include "candybar.h"


CandyBar cb(100, "Progress");


Parameter Default Description
total 100 Defines the value corresponding to 100%
message None Write some text at the beginning of the line
width console size Size (in chars) of the bar, by default max console size
left_justified True Defines the justification of the bar (not the message text)
disable False When set, the progress bar will be disabled

To update the position of the progress bar use the update method:

# Python
total = 100

for i in range(total + 1):
    # Your code goes here
// C++
int total = 100;

for (int i = 0; i <= total; i++)
    // Your code goes here

The progress bar can be disabled:

# Python
def function(verbose):
    cb.disable(not verbose)
// C++
void function(bool verbose)

The total value, the message, and the justification of the progress bar can be changed:

# Python
cb.set_message("Another message")
// C++
cb.set_message("Another message");

Like what I do?

Buy me coffee Donate with monero 85jJPcfLPZRUKm3Re6qHZsKBZskVS2tYMWFoY5sYXUSQJzqzqpuPFepXMtqTKCRfuhYXaiJ3zQVeRPDYJUfepVjnJDpApH5

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

candy_bar-1.3.5.linux-x86_64.tar.gz (175.2 kB view hashes)

Uploaded source

Built Distribution

candy_bar-1.3.5-py3.10-linux-x86_64.egg (176.9 kB view hashes)

Uploaded 1 3 5

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page