PySimpleGUI/DemoPrograms/Demo_Progress_Meters.py

220 lines
8.2 KiB
Python

#!/usr/bin/env python
import PySimpleGUI as sg
from time import sleep
sg.theme('Dark Blue 3')
"""
Demonstration of simple and multiple one_line_progress_meter's as well as the Progress Meter Element
There are 4 demos
1. Manually updated progress bar
2. Custom progress bar built into your window, updated in a loop
3. one_line_progress_meters, nested meters showing how 2 can be run at the same time.
4. An "iterable" style progress meter - a wrapper for one_line_progress_meters
If the software determined that a meter should be cancelled early,
calling OneLineProgresMeterCancel(key) will cancel the meter with the matching key
"""
"""
The simple case is that you want to add a single meter to your code. The one-line solution.
This demo function shows 3 different one_line_progress_meter tests
1. A horizontal with red and white bar colors
2. A vertical bar with default colors
3. A test showing 2 running at the same time
"""
def demo_one_line_progress_meter():
# Display a progress meter. Allow user to break out of loop using cancel button
for i in range(10000):
if not sg.one_line_progress_meter('My 1-line progress meter',
i+1, 10000,
'meter key',
'MY MESSAGE1',
'MY MESSAGE 2',
orientation='h',
no_titlebar=True,
grab_anywhere=True,
bar_color=('white', 'red')):
print('Hit the break')
break
for i in range(10000):
if not sg.one_line_progress_meter('My 1-line progress meter',
i+1, 10000,
'meter key',
'MY MESSAGE1',
'MY MESSAGE 2',
orientation='v'):
print('Hit the break')
break
layout = [
[sg.Text('One-Line Progress Meter Demo', font=('Any 18'))],
[sg.Text('Outer Loop Count', size=(15, 1), justification='r'),
sg.Input(default_text='100', size=(5, 1), key='CountOuter'),
sg.Text('Delay'), sg.Input(default_text='10', key='TimeOuter', size=(5, 1)), sg.Text('ms')],
[sg.Text('Inner Loop Count', size=(15, 1), justification='r'),
sg.Input(default_text='100', size=(5, 1), key='CountInner'),
sg.Text('Delay'), sg.Input(default_text='10', key='TimeInner', size=(5, 1)), sg.Text('ms')],
[sg.Button('Show', pad=((0, 0), 3), bind_return_key=True),
sg.Text('me the meters!')]
]
window = sg.Window('One-Line Progress Meter Demo', layout)
while True:
event, values = window.read()
if event == sg.WIN_CLOSED:
break
if event == 'Show':
max_outer = int(values['CountOuter'])
max_inner = int(values['CountInner'])
delay_inner = int(values['TimeInner'])
delay_outer = int(values['TimeOuter'])
for i in range(max_outer):
if not sg.one_line_progress_meter('Outer Loop', i+1, max_outer, 'outer'):
break
sleep(delay_outer/1000)
for j in range(max_inner):
if not sg.one_line_progress_meter('Inner Loop', j+1, max_inner, 'inner'):
break
sleep(delay_inner/1000)
window.close()
'''
Manually Updated Test
Here is an example for when you want to "sprinkle" progress bar updates in multiple
places within your source code and you're not running an event loop.
Note that UpdateBar is special compared to other Update methods. It also refreshes
the containing window and checks for window closure events
The sleep calls are here only for demonstration purposes. You should NOT be adding
these kinds of sleeps to a GUI based program normally.
'''
def manually_updated_meter_test():
# layout the form
layout = [[sg.Text('This meter is manually updated 4 times')],
[sg.ProgressBar(max_value=10, orientation='h', size=(20, 20), key='progress')]]
# create the form`
# must finalize since not running an event loop
window = sg.Window('Custom Progress Meter', layout, finalize=True)
# Get the element to make updating easier
progress_bar = window['progress']
# -------------------- Your Program Code --------------------
# Spot #1 to indicate progress
progress_bar.update_bar(1) # show 10% complete
sleep(2)
# more of your code.... perhaps pages and pages of code.
# Spot #2 to indicate progress
progress_bar.update_bar(2) # show 20% complete
sleep(2)
# more of your code.... perhaps pages and pages of code.
# Spot #3 to indicate progress
progress_bar.update_bar(6) # show 60% complete
sleep(2)
# more of your code.... perhaps pages and pages of code.
# Spot #4 to indicate progress
progress_bar.update_bar(9) # show 90% complete
sleep(2)
window.close()
'''
This function shows how to create a custom window with a custom progress bar and then
how to update the bar to indicate progress is being made
'''
def custom_meter_example():
# layout the form
layout = [[sg.Text('A typical custom progress meter')],
[sg.ProgressBar(1, orientation='h', size=(20, 20), key='progress')],
[sg.Cancel()]]
# create the form`
window = sg.Window('Custom Progress Meter', layout)
progress_bar = window['progress']
# loop that would normally do something useful
for i in range(10000):
# check to see if the cancel button was clicked and exit loop if clicked
event, values = window.read(timeout=0)
if event == 'Cancel' or event == None:
break
# update bar with loop value +1 so that bar eventually reaches the maximum
progress_bar.update_bar(i+1, 10000)
# done with loop... need to destroy the window as it's still open
window.close()
'''
A Wrapper for one_line_progress_meter that combines your iterable with a progress meter into a single interface. Two functions are provided
progess_bar - The basic wrapper
progress_bar_range - A "convienence function" if you wanted to specify like a range
'''
def progress_bar(key, iterable, *args, title='', **kwargs):
"""
Takes your iterable and adds a progress meter onto it
:param key: Progress Meter key
:param iterable: your iterable
:param args: To be shown in one line progress meter
:param title: Title shown in meter window
:param kwargs: Other arguments to pass to one_line_progress_meter
:return:
"""
sg.one_line_progress_meter(title, 0, len(iterable), key, *args, **kwargs)
for i, val in enumerate(iterable):
yield val
if not sg.one_line_progress_meter(title, i+1, len(iterable), key, *args, **kwargs):
break
def progress_bar_range(key, start, stop=None, step=1, *args, **kwargs):
"""
Acts like the range() function but with a progress meter built-into it
:param key: progess meter's key
:param start: low end of the range
:param stop: Uppder end of range
:param step:
:param args:
:param kwargs:
:return:
"""
return progress_bar(key, range(start, stop, step), *args, **kwargs)
# -------------------- Demo Usage --------------------
def demo_iterable_progress_bar():
# start with a list of 100 integers as the user's list
my_list = list(range(1000))
# first form takes an iterable and a key and will return a value from your iterable
# and bump the progress meter at the same time
for value in progress_bar('bar1', my_list, title='First bar Test'):
# do something useful with value, a value from your list.
print(value)
# Since the progress_bar is an iterator, you can use it within a list comprehension
my_list = [x for x in progress_bar('bar1', my_list, title='Second bar Test')]
demo_iterable_progress_bar()
manually_updated_meter_test()
custom_meter_example()
demo_one_line_progress_meter()