Merge pull request #3807 from PySimpleGUI/Dev-latest

Release 4.34.0

PySimpleGUI.py

@@ -1,5 +1,5 @@
 #!/usr/bin/python3
-version = __version__ = "4.33.0.5 Unreleased\nAliases shown SDK reference, popup_scrolled fix, summary mode for SDK help, BIG PEP8 definition swap, changed metadata into a class property, docstring change for element lookups"
+version = __version__ = "4.34.0 Released 18-Jan-2021"
 
 __version__ = version.split()[0]    # For PEP 396 and PEP 345
 
@@ -1911,7 +1911,6 @@ class Listbox(Element):
         return value
 
 
-
     GetIndexes = get_indexes
     GetListValues = get_list_values
     SetValue = set_value
@@ -7399,7 +7398,7 @@ class Window:
         :param auto_close_duration: Number of seconds to wait before closing the window
         :type auto_close_duration: (int)
         :param icon: Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO
-        :type icon: str
+        :type icon: (str | bytes)
         :param force_toplevel: If True will cause this window to skip the normal use of a hidden master window
         :type force_toplevel: (bool)
         :param alpha_channel: Sets the opacity of the window. 0 = invisible 1 = completely visible. Values bewteen 0 & 1 will produce semi-transparent windows in SOME environments (The Raspberry Pi always has this value at 1 and cannot change.
@@ -14632,6 +14631,7 @@ def theme(new_theme=None):
     return CURRENT_LOOK_AND_FEEL
 
 
+
 def theme_background_color(color=None):
     """
     Sets/Returns the background color currently in use
@@ -15395,7 +15395,6 @@ def popup_scrolled(*args, title=None, button_color=None, background_color=None,
     return button
 
 
-ScrolledTextBox = popup_scrolled
 
 # ============================== sprint ======#
 # Is identical to the Scrolled Text Box       #
@@ -15404,7 +15403,7 @@ ScrolledTextBox = popup_scrolled
 # This is in addition to the Print function   #
 # which routes output to a "Debug Window"     #
 # ============================================#
-sprint = popup_scrolled
+
 
 
 # --------------------------- popup_no_buttons ---------------------------
@@ -18131,9 +18130,8 @@ def main_sdk_help():
     element_names['Window'] = Window
 
     vars3 = [m for m in inspect.getmembers(sys.modules[__name__])]
-
     # layout = [[Text('PySimpleGUI Element Reference', font='Any 12')]]
-    button_col = Col([[B(e, pad=(0, 0), size=(22, 1), font='Courier 8')] for e in sorted(element_names.keys())])
+    button_col = Col([[B(e, pad=(0, 0), size=(22, 1), font='Courier 10')] for e in sorted(element_names.keys())])
     layout = [vtop([button_col, Multiline(size=(100, 46), key='-ML-', write_only=True, reroute_stdout=True, font='Courier 10')])]
     layout += [[CBox('Summary Only', k='-SUMMARY-')]]
     # layout += [[Button('Exit', size=(15, 1))]]
@@ -18477,10 +18475,14 @@ PrintClose = easy_print_close
 RGB = rgb
 SetGlobalIcon = set_global_icon
 SetOptions = set_options
+sprint = popup_scrolled
+ScrolledTextBox = popup_scrolled
 TimerStart = timer_start
 TimerStop = timer_stop
 
 test = main
+sdk_help = main_sdk_help
+
 
 #------------------------ Set the "Official PySimpleGUI Theme Colors" ------------------------
 theme(CURRENT_LOOK_AND_FEEL)

docs/call reference.md

@@ -9701,7 +9701,7 @@ Parameter Descriptions:
 |                    int                    |             border_depth             | Default border depth (width) for all elements in the window |
 |                   bool                    |              auto_close              | If True, the window will automatically close itself |
 |                    int                    |         auto_close_duration          | Number of seconds to wait before closing the window |
-|                    str                    |                 icon                 | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO |
+|              (str or bytes)               |                 icon                 | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO |
 |                   bool                    |            force_toplevel            | If True will cause this window to skip the normal use of a hidden master window |
 |                   float                   |            alpha_channel             | Sets the opacity of the window. 0 = invisible 1 = completely visible. Values bewteen 0 & 1 will produce semi-transparent windows in SOME environments (The Raspberry Pi always has this value at 1 and cannot change. |
 |                   bool                    |        return_keyboard_events        | if True key presses on the keyboard will be returned as Events from Read calls |

docs/index.md

@@ -8258,6 +8258,24 @@ Custom Titlebars, Fix for Docstrings so PyCharm 2020 works correctly, New shortc
 * popup - support for custom titlebar!
 * Changed from pathlib to os.path
 
+## 4.34.0 PySimpleGUI 18-Jan-2021
+
+Fix popup_scrolled, big swap of PEP8 names from alias to def statements
+
+* Quick "Emergency" release since popup_scrolled crashes. BAD bad thing that has to be corrected ASAP
+* Changed all of the functions and methods so that the definition is PEP8 compliant and and alias is not compliant
+* Built-in SDK help
+	* Added a "Summary mode"
+	* Make window smaller to fit on more monitors
+	* Added aliases to end of help for each element
+* metadata
+	* Changed into a class Property so that it shows up in the docs correctly
+	* The Element, Window and SystemTray classes all got this same change
+* Added all elements to the docstring for window[key] style lookups to make PyCharm happier
+* Moved all PEP8 function aliases to a centralized spot at the end of the code
+* sdk_help alias of main_sdk_help
+* Several new demos including a demo browser
+
 ## Upcoming
 
 The future for PySimpleGUI looks bright!