A significant refactor of the large FreeSimpleGUI module. This is just a first step we're taking towards making FreeSimpleGUI more maintainable and approachable for contributors. There's still a lot of work to do, but this change cuts the main module size in half, making it quite a bit easier for LSPs and Intellisense to keep up with changes. Elements are now tucked neatly away into their own modules within the new elements subpackage.
All names are imported back into the main package, so this change is non-breaking.
We also moved the main module back to __init__.py instead of the internal FreeSimpleGUI.py module. This avoids a bug introduced by the initial refactor by which changes to global state (which is unfortunately used extensively) may not take effect properly in some cases.
Other minor changes and deprecations:
The globals pil_imported and pil_import_attempted are no longer used internally. Attempting to access these globals will produce a deprecation warning.
The behavior of the methods save_element_screenshot_to_disk and save_window_screenshot_to_disk returning None when PIL cannot be imported is deprecated. In a future version, calling save_element_screenshot_to_disk or save_window_screenshot_to_disk when PIL cannot be imported will raise an ImportError.
This also fixes a bug where calling save_element_screenshot_to_disk or save_window_screenshot_to_disk would incidentally overwrite the Image element class due to use of the global keyword in these methods and importing the name Image from PIL whilst marking Image as global
The methods timer_start, timer_stop, and timer_stop_usec are deprecated and will be removed in a future version. (code timing is not FreeSimpleGUI's wheelhouse, and these implementations are flawed in any case). Not to be confused with the Window class methods of the same name, which are unchanged.
Using functions with CamelCase names that have snake_case function name replacements is deprecated and those camel-cased function aliases may be removed in a future version. Using these names will produce a deprecation warning.
A significant refactor of the large FreeSimpleGUI module. This is just a first step we're taking towards making FreeSimpleGUI more maintainable and approachable for contributors. There's still a lot of work to do, but this change cuts the main module size in half, making it quite a bit easier for LSPs and Intellisense to keep up with changes. Elements are now tucked neatly away into their own modules within the new
elements
subpackage.All names are imported back into the main package, so this change is non-breaking.
We also moved the main module back to
__init__.py
instead of the internalFreeSimpleGUI.py
module. This avoids a bug introduced by the initial refactor by which changes to global state (which is unfortunately used extensively) may not take effect properly in some cases.Other minor changes and deprecations:
The globals
pil_imported
andpil_import_attempted
are no longer used internally. Attempting to access these globals will produce a deprecation warning.The behavior of the methods
save_element_screenshot_to_disk
andsave_window_screenshot_to_disk
returningNone
whenPIL
cannot be imported is deprecated. In a future version, callingsave_element_screenshot_to_disk
orsave_window_screenshot_to_disk
whenPIL
cannot be imported will raise anImportError
.This also fixes a bug where calling
save_element_screenshot_to_disk
orsave_window_screenshot_to_disk
would incidentally overwrite theImage
element class due to use of theglobal
keyword in these methods and importing the nameImage
from PIL whilst markingImage
asglobal
The methods
timer_start
,timer_stop
, andtimer_stop_usec
are deprecated and will be removed in a future version. (code timing is not FreeSimpleGUI's wheelhouse, and these implementations are flawed in any case). Not to be confused with theWindow
class methods of the same name, which are unchanged.Using functions with
CamelCase
names that havesnake_case
function name replacements is deprecated and those camel-cased function aliases may be removed in a future version. Using these names will produce a deprecation warning.