Simple and configurable countdown for the Command Line Interface (CLI)

countdown_sleep.py

# -*- coding: utf-8 -*-

import time


def countdown_sleep(second: int):
    # check second is natural number (contains 0)
    if not isinstance(second, int) or second < 0:
        raise ValueError("'second' should be a natural number (contains 0). second: %s" % second)

    # countdown
    for i in range(second, 0, -1):
        print(f"\rWait... {i}          ", end="", flush=True)
        time.sleep(1)
    print(f"\rGo!               ", flush=True)
 

 # Try countdown   
if __name__ == "__main__":
    countdown_sleep(10)