mlaga97
/
PySimpleGUI
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
PySimpleGUI/readme_creator/4_Release_notes.md

37 KiB
Raw Blame History

Versions

Version Description
1.0.9 July 10, 2018 - Initial Release
1.0.21 July 13, 2018 - Readme updates
2.0.0 July 16, 2018 - ALL optional parameters renamed from CamelCase to all_lower_case
2.1.1 July 18, 2018 - Global settings exposed, fixes
2.2.0 July 20, 2018 - Image Elements, Print output
2.3.0 July 23, 2018 - Changed form.Read return codes, Slider Elements, Listbox element. Renamed some methods but left legacy calls in place for now.
2.4.0 July 24, 2018 - Button images. Fixes so can run on Raspberry Pi
2.5.0 July 26, 2018 - Colors. Listbox scrollbar. tkinter Progress Bar instead of homegrown.
2.6.0 July 27, 2018 - auto_size_button setting. License changed to LGPL 3+
2.7.0 July 30, 2018 - realtime buttons, window_location default setting
2.8.0 Aug 9, 2018 - New None default option for Checkbox element, text color option for all elements, return values as a dictionary, setting focus, binding return key
2.9.0 Aug 16,2018 - Screen flash fix, do_not_clear input field option, autosize_text defaults to True now, return values as ordered dict, removed text target from progress bar, rework of return values and initial return values, removed legacy Form.Refresh() method (replaced by Form.ReadNonBlockingForm()), COLUMN elements!!, colored text defaults
2.10.0 Aug 25, 2018 - Keyboard & Mouse features (Return individual keys as if buttons, return mouse scroll-wheel as button, bind return-key to button, control over keyboard focus), SaveAs Button, Update & Get methods for InputText, Update for Listbox, Update & Get for Checkbox, Get for Multiline, Color options for Text Element Update, Progess bar Update can change max value, Update for Button to change text & colors, Update for Image Element, Update for Slider, Form level text justification, Turn off default focus, scroll bar for Listboxes, Images can be from filename or from in-RAM, Update for Image). Fixes - text wrapping in buttons, msg box, removed slider borders entirely and others
2.11.0 Aug 29, 2018 - Lots of little changes that are needed for the demo programs to work. Buttons have their own default element size, fix for Mac default button color, padding support for all elements, option to immediately return if list box gets selected, FilesBrowse button, Canvas Element, Frame Element, Slider resolution option, Form.Refresh method, better text wrapping, 'SystemDefault' look and feel settin
2.20.0 Sept 4, 2018 - Some sizable features this time around of interest to advanced users. Renaming of the MsgBox functions to Popup. Renaming GetFile, etc, to PopupGetFile. High-level windowing capabilities start with Popup, PopupNoWait/PopupNonblocking, PopupNoButtons, default icon, change_submits option for Listbox/Combobox/Slider/Spin/, New OptionMenu element, updating elements after shown, system defaul color option for progress bars, new button type (Dummy Button) that only closes a window, SCROLLABLE Columns!! (yea, playing in the Big League now), LayoutAndShow function removed, form.Fill - bulk updates to forms, FindElement - find element based on key value (ALL elements have keys now), no longer use grid packing for row elements (a potentially huge change), scrolled text box sizing changed, new look and feel themes (Dark, Dark2, Black, Tan, TanBlue, DarkTanBlue, DarkAmber, DarkBlue, Reds, Green)
2.30.0 Sept 6, 2018 - Calendar Chooser (button), borderless windows, load/save form to disk
3.0.0 Sept 7, 2018 - The "fix for poor choice of 2.x numbers" release. Color Chooser (button), "grab anywhere" windows are on by default, disable combo boxes, Input Element text justification (last part needed for 'tables'), Image Element changes to support OpenCV?, PopupGetFile and PopupGetFolder have better no_window option
3.01.01 Sept 10, 2018 - Menus! (sort of a big deal)
3.01.02 Step 11, 2018 - All Element.Update functions have a disabled parameter so they can be disabled. Renamed some parameters in Update function (sorry if I broke your code), fix for bug in Image.Update. Wasn't setting size correctly, changed grab_anywhere logic again,added grab anywhere option to PupupGetText (assumes disabled)
3.02.00 Sept 14, 2018 - New Table Element (Beta release), MsgBox removed entirely, font setting for InputText Element, packing change risky change that allows some Elements to be resized,removed command parameter from Menu Element, new function names for ReadNonBlocking (Finalize, PreRead), change to text element autosizing and wrapping (yet again), lots of parameter additions to Popup functions (colors, etc).
3.03.00 New feature - One Line Progress Meters, new display_row_numbers for Table Element, fixed bug in EasyProgresssMeters (function will soon go away), OneLine and Easy progress meters set to grab anywhere but can be turned off.
03,04.00 Sept 18, 2018 - New features - Graph Element, Frame Element, more settings exposed to Popup calls. See notes below for more.
03.04.01 Sept 18, 2018 - See release notes
03.05.00 Sept 20, 2018 - See release notes
03.05.01 Sept 22, 2018 - See release notes
03.05.02 Sept 23, 2018 - See release notes
03.06.00 Sept 23, 2018 - Goodbye FlexForm, hello Window
03.08.00 Sept 25, 2018 - Tab and TabGroup Elements\
01.00.00 for 2.7 Sept 25, 2018 - First release for 2.7
03.08.04 Sept 30, 2018 - See release notes
03.09.00 Oct 1, 2018
2.7 01.01.00 Oct 1, 2018
2.7 01.01.02 Oct 8, 2018
03.09.01 Oct 8, 2018
3.9.3 & 1.1.3 Oct 11, 2018
3.9.4 & 1.1.4 Oct 16, 2018
3.10.1 & 1.2.1 Oct 20, 2018
3.10.3 & 1.2.3 Oct 23, 2018
3.11.0 & 1.11.0 Oct 28, 2018
3.12.0 & 1.12.0 Oct 28, 2018
3.13.0 & 1.13.0 Oct 29, 2018
3.14.0 & 1.14.0 Nov 2, 2018
3.15.0 & 1.15.0 Nov 20, 2018
3.16.0 & 1.16.0 Nov 26, 2018
3.17.0 & 1.17.0 Dec 1, 2018

Release Notes

2.3 - Sliders, Listbox's and Image elements (oh my!)

If using Progress Meters, avoid cancelling them when you have another window open. It could lead to future windows being blank. It's being worked on.

New debug printing capability. sg.Print

2.5 Discovered issue with scroll bar on Output elements. The bar will match size of ROW not the size of the element. Normally you never notice this due to where on a form the Output element goes.

Listboxes are still without scrollwheels. The mouse can drag to see more items. The mouse scrollwheel will also scroll the list and will page up and page down keys.

2.7 Is the "feature complete" release. Pretty much all features are done and in the code

2.8 More text color controls. The caller has more control over things like the focus and what buttons should be clicked when enter key is pressed. Return values as a dictionary! (NICE addition)

2.9 COLUMNS! This is the biggest feature and had the biggest impact on the code base. It was a difficult feature to add, but it was worth it. Can now make even more layouts. Almost any layout is possible with this addition.

.................. insert releases 2.9 to 2.30 .................

3.0 We've come a long way baby! Time for a major revision bump. One reason is that the numbers started to confuse people the latest release was 2.30, but some people read it as 2.3 and thought it went backwards. I kinda messed up the 2.x series of numbers, so why not start with a clean slate. A lot has happened anyway so it's well earned.

One change that will set PySimpleGUI apart is the parlor trick of being able to move the window by clicking on it anywhere. This is turned on by default. It's not a common way to interact with windows. Normally you have to move using the titlebar. Not so with PySimpleGUI. Now you can drag using any part of the window. You will want to turn off for windows with sliders. This feature is enabled in the Window call.

Related to the Grab Anywhere feature is the no_titlebar option, again found in the call to Window. Your window will be a spiffy, borderless window. It's a really interesting effect. Slight problem is that you do not have an icon on the taskbar with these types of windows, so if you don't supply a button to close the window, there's no way to close it other than task manager.

3.0.2 Still making changes to Update methods with many more ahead in the future. Continue to mess with grab anywhere option. Needed to disable in more places such as the PopupGetText function. Any time these is text input on a form, you generally want to turn off the grab anywhere feature.

3.2.0

Biggest change was the addition of the Table Element. Trying to make changes so that form resizing is a possibility but unknown if will work in the long run. Removed all MsgBox, Get* functions and replaced with Popup functions. Popups had multiple new parameters added to change the look and feel of a popup.

3.3.0

OneLineProgressMeter function added which gives you not only a one-line solution to progress meters, but it also gives you the ability to have more than 1 running at the same time, something not possible with the EasyProgressMeterCall

3.4.0

  • Frame - New Element - a labelled frame for grouping elements. Similar to Column
  • Graph (like a Canvas element except uses the caller's coordinate system rather than tkinter's).
  • initial_folder - sets starting folder for browsing type buttons (browse for file/folder).
  • Buttons return key value rather than button text If a key is specified,
  • OneLineProgressMeter! Replaced EasyProgressMeter (sorry folks that's the way progress works sometimes)
  • Popup - changed ALL of the Popup calls to provide many more customization settings
    • Popup
    • PopupGetFolder
    • PopupGetFile
    • PopupGetText
    • Popup
    • PopupNoButtons
    • PopupNonBlocking
    • PopupNoTitlebar
    • PopupAutoClose
    • PopupCancel
    • PopupOK
    • PopupOKCancel
    • PopupYesNo

3.4.1

  • Button.GetText - Button class method. Returns the current text being shown on a button.
  • Menu - Tearoff option. Determines if menus should allow them to be torn off
  • Help - Shorcut button. Like Submit, cancel, etc
  • ReadButton - shortcut for ReadFormButton

3.5.0

  • Tool Tips for all elements
  • Clickable text
  • Text Element relief setting
  • Keys as targets for buttons
  • New names for buttons:
    • Button = SimpleButton
    • RButton = ReadButton = ReadFormButton
  • Double clickable list entries
  • Auto sizing table widths works now
  • Feature DELETED - Scaling. Removed from all elements

3.5.1

  • Bug fix for broken PySimpleGUI if Python version < 3.6 (sorry!)
  • LOTS of Readme changes

3.5.2

  • Made Finalize() in a way that it can be chained
  • Fixed bug in return values from Frame Element contents

3.6.0

  • Renamed FlexForm to Window
  • Removed LookAndFeel capability from Mac platform.

3.8.0

  • Tab and TabGroup Elements - awesome new capabilities

1.0.0 Python 2.7

It's official. There is a 2.7 version of PySimpleGUI!

3.8.2

  • Exposed TKOut in Output Element
  • DrawText added to Graph Elements
  • Removed Window.UpdateElements
  • Window.grab_anywere defaults to False

3.8.3

  • Listbox, Slider, Combobox, Checkbox, Spin, Tab Group - if change_submits is set, will return the Element's key rather than ''
  • Added change_submits capability to Checkbox, Tab Group
  • Combobox - Can set value to an Index into the Values table rather than the Value itself
  • Warnings added to Drawing routines for Graph element (rather than crashing)
  • Window - can "force top level" window to be used rather than a normal window. Means that instead of calling Tk to get a window, will call TopLevel to get the window
  • Window Disable / Enable - Disables events (button clicks, etc) for a Window. Use this when you open a second window and want to disable the first window from doing anything. This will simulate a 'dialog box'
  • Tab Group returns a value with Window is Read. Return value is the string of the selected tab
  • Turned off grab_anywhere for Popups
  • New parameter, default_extension, for PopupGetFile
  • Keyboard shortcuts for menu items. Can hold ALT key to select items in men
  • Removed old-style Tabs - Risky change because it hit fundamental window packing and creation. Will also break any old code using this style tab (sorry folks this is how progress happens)

3.8.6

  • Fix for Menus.
  • Fixed table colors. Now they work
  • Fixed returning keys for tabs
  • Window Hide / UnHide methods
  • Changed all Popups to remove context manager
  • Error checking for Graphing objects and for Element Updates

3.9.0 & 1.1.0

  • The FIRST UNIFIED version of the code!
  • Python 2.7 got a TON of features . Look back to 1.0 release for the list
  • Tab locations - Can place Tabs on top, bottom, left, right now instead of only the top

3.9.1 & 1.1.2

  • Tab features
    • Themes
    • Enable / Disable
    • Tab text colors
    • Selected tab color
  • New GetListValues method for Listbox
  • Can now have multiple progress bars in 1 window
  • Fix for closing debug-output window with other windows open
  • Topanga Look and Feel setting
  • User can create new look and feel settings / can access the look and feel table
  • New PopupQuick call. Shows a non-blocking popup window with auto-close
  • Tree Element partially done (don't use despite it showing up)

3.9.3 & 1.1.3

  • Disabled setting when creating element for:
    • Input
    • Combo
    • Option Menu
    • Listbox
    • Radio
    • Checkbox
    • Spinner
    • Multiline
    • Buttons
    • Slider
  • Doc strings on all Elements updated
  • Buttons can take image data as well as image files
  • Button Update can change images
  • Images can have background color
  • Table element new num_rows parameter
  • Table Element new alternating_row_color parameter
  • Tree Element
  • Window Disappear / Reappear methods
  • Popup buttons resized to same size
  • Exposed look and feel table

3.9.4 & 1.1.4

  • Parameter order change for Button.Update so that new button ext is at front
  • New Graph.DrawArc method
  • Slider tick interval parameter for labeling sliders
  • Menu tearoff now disabled by default
  • Tree Data printing simplified and made prettier
  • Window resizable parameter. Defaults to not resizable
  • Button images can have text over them now
  • BUG fix in listbox double-click. First bug fix in months
  • New Look And Feel capability. List predefined settings using ListOfLookAndFeelValues

3.10.1 & 1.2.1

  • Combobox new readonly parameter in init and Update
  • Better default sizes for Slider
  • Read of Tables now returns which rows are selected (big damned deal feature)
  • PARTIAL support of Table.Update with new values (use at your own peril)
  • Alpha channel setting for Windows
  • Timeout setting for Window.Read (big damned deal feature)
  • Icon can be base64 image now in SetIcon call
  • Window.FindElementWithFocus call
  • Window.Move allows moving window anywhere on screen
  • Window.Minimize will minimize to taskbar
  • Button background color can be set to system default (i.e. not changed)

3.10.2 & 1.2.2

Emergency patch release... going out same day as previous release

  • The timeout timer for the new Read with timer wasn't being properly shut down
  • The Image.Update method appears to not have been written correctly. It didn't handle base64 images like the other elements that deal with images (buttons)

3.10.3 & 1.2.3

  • New element - Vertical Separator
  • New parameter for InputText - change_submits. If True will cause Read to return when a button fills in the InputText element
  • Read with timeout = 0 is same as read non blocking and is the new preferred method
    • Will return event == None if window closed
  • New Close method will close all window types
  • Scrollbars for Tables automatically added (no need for a Column Element)
  • Table Update method complete
  • Turned off expand when packing row frame... was accidentally turned on (primary reason for this release)
  • Try added to Image Update so won't crash if bad image passed in

3.11.0 & 1.11.0

  • Syncing up the second digit of the releases so that they stay in sync better. the 2.7 release is built literally from the 3.x code so they really are the same
  • Reworked Read call... significantly.
  • Realtime buttons work with timeouts or blocking read
  • Removed default value parm on Buttons and Button Updates
  • New Tree Element parm show_expanded. Causes Tree to be shown as fully expanded
  • Tree Element now returns which rows are selected when Read
  • New Window method BringToFront
  • Shortcut buttons no longer close windows!
  • Added CloseButton, CButton that closes the windows

3.12.0 & 1.12.0

  • Changed Button to be the same as ReadButton which means it will no longer close the window
  • All shortcut buttons no longer close the window
  • Updating a table clears selected rows information in return values
  • Progress meter uses new CloseButton
  • Popups use new CloseButton

3.13.0 & 1.13.0

  • Improved multiple window handling of Popups when the X is used to close
  • Change submits added for:
    • Multiline
    • Input Text
    • Table
    • Tree
  • Option to close calendar chooser when date selected
  • Update for Tree Element
  • Scroll bars for Trees

3.14.0 & 1.14.0

  • More windowing changes...
    • using a hidden root windowing (Tk())
    • all children are Toplevel() windows
  • Read only setting for:
    • Input Text
    • Multiline
  • Font setting for InputCombo, Multiline
  • change_submits setting for Radio Element
  • SetFocus for multiline, input elements
  • Default mon, day, year for calendar chooser button
  • Tree element update, added ability to change a single key
  • Message parm removed from ReadNonBlocking
  • Fix for closing windows using X
  • CurrentLocation method for Windows
  • Debug Window options
    • location
    • font
    • no_button
    • no_titlebar
    • grab_anywhere
    • keep_on_top
  • New Print / EasyPrint options
    • location
    • font
    • no_button
    • no_titlebar
    • grab_anywhere
    • keep_on_top
  • New popup, PopupQuickMessage
  • PopupGetFolder, PopupGetFile new initial_folder parm

3.15.0 & 1.15.0

  • Error checking for InputText.Get method
  • Text color, background color added to multiline element.Update
  • Update method for Output Element - gives ability to clear the output
  • Graph Element - Read returns values if new flages set
    • Change submits, drag submits
    • Returns x,y coordinates
  • Column element new parm vertical_scroll_only
  • Table element new parm - bind return key - returns if return or double click
  • New Window parms - size, disable_close
  • "Better" multiwindow capabilities
  • Window.Size property
  • Popups - new title parm, custom_text
    • title sets the window title
    • custom_text - single string or tuple string sets text on button(s)

3.16.0 & 1.16.0

  • Bug fix in PopupScrolled
  • New Element shortcut function for FindElement
  • Dummy Stretch Element made for backwards compatibility with Qt
  • Timer function prints in milliseconds now, was seconds

3.17.0 &1.17.0 2-Dec-2018

3.17.0 2-Dec-2017

  • Tooltip offset now programmable. Set variable DEFAULT_TOOLTIP_OFFSET. Defaults to (20,-20)
  • Tooltips are always on top now
  • Disable menu items
  • Menu items can have keys
  • StatusBar Element (preparing for a real status bar in Qt)
  • enable_events parameter added to ALL Elements capable of generating events
  • InputText.Update select parameter will select the input text
  • Listbox.Update - set_to_index parameter will select a single items
  • Menus can be updated!
  • Menus have an entry in the return values
  • LayoutAndRead depricated
  • Multi-window support continues (X detection)
  • PopupScrolled now has a location parameter
  • row_height parameter to Table Element
  • Stretch Element (DUMMY) so that can be source code compatible with Qt
  • ButtonMenu Element (DUMMY) so can be source code compat with Qt. Will implement eventually

3.18.0 11-Dec-2018

NOTE - Menus are broken on version 2.7. Don't know how long they've been this way. Please get off legacy Python if that's what you're running.

  • Default progress bar length changed to shorter
  • Master window and tracking of num open windows moved from global to Window class variable
  • Element visibility setting (when created and when Updating element)
  • Input text visiblity
  • Combo visiblity
  • Combo replaces InputCombo as the primary class name
  • Option menu visibility
  • Listbox visiblity
  • Listbox new SetFocus method
  • Radio visibility
  • Checkbox visibility
  • Spin visiblity
  • Spin new Get method returns current value
  • Multiline visiblity
  • Text visibility
  • StatusBar visiblity
  • Output visibility
  • Button visibility
  • Button SetFocus
  • ProgressBar - New Update method (used only for visibility)
  • Image - clickable images! enable_events parameter
  • Image visibility
  • Canvas visibility
  • Graph visibility
  • Graph - new DrawImage capability (finally)
  • Frame visibility
  • Tab visibility (may not be fully functional)
  • TabGroup visibility
  • Slider visibility
  • Slider - new disable_number_display parameter
  • Column visibilty
  • Menu visibility - Not functional
  • Table visibility
  • Table - new num_rows parm for Update - changes number of visible rows
  • Tree visiblity
  • Window - New element_padding parameter will get padding for entire window
  • OneLineProgressMeter - Completely REPLACED the implementation
  • OneLineProgressMeter - can get reason for the cancellation (cancel button versus X)
  • EasyProgressMeter - completely removed. Use OneLineProgressMeter instead
  • Debug window, EasyPrint, Print - debug window will re-open if printed to after being closed
  • SetOptions - can change the error button color
  • Much bigger window created when running PySimpleGUI.py by itself. Meant to help with regression testing

3.19.2 13-Dec-2018

  • Warning for Mac's when trying to change button color
  • New parms for Button.Update - image_size and image_subsample
  • Buttons - remove highlight when border depth == 0
  • OneLineProgressMeter - better layout implementation

3.20.0 & 1.20.0 18-Dec-2018

  • New Pane Element
  • Graph.DeleteFigure method
  • disable_minimize - New parameter for Window
  • Fix for 2.7 menus
  • Debug Window no longer re-routes stdout by default
  • Can re-route by specifying in Print / EasyPrint call
  • New non-blocking for PopupScrolled
  • Can set title for PopupScrolled window

3.21.0 & 1.21.0 28-Dec-2018

  • ButtonMenu Element
  • Embedded base64 default icon
  • Input Text Right click menu
  • Disabled Input Text are now 'readonly' instead of disabled
  • Listbox right click menu
  • Multiline right click menu
  • Text right click menu
  • Output right click menu
  • Image right click menu
  • Canvas right click menu
  • Graph right click menu
  • Frame right click menu
  • Tab, tabgroup right click menu (unsure if works correctly)
  • Column right click menu
  • Table right click menu
  • Tree right click menu
  • Window level right click menu
  • Window icon can be filename or bytes (Base64 string)
  • Window.Maximize method
  • Attempted to use Styles better with Combobox
  • Fixed bug blocking setting bar colors in OneLineProgressMeter

3.22.0 PySimpleGUI / 1.22.0 PySimpleGUI27

  • Added type hints to some portions of the code
  • Output element can be made invisible
  • Image sizing and subsample for Button images
  • Invisibility for ButtonMenusup
  • Attempt at specifying size of Column elements (limited success)
  • Table Element
    • New row_colors parameter
    • New vertical_scroll_only parameter - NOTE - will have to disable to get horizontal scrollbars
  • Tree Element
    • New row_height parameter
    • New feature - Icons for tree entries using filename or Base64 images
  • Fix for bug sending back continuous mouse events
  • New parameter silence_on_error for FindElement / Element calls
  • Slider returns float now
  • Fix for Menus when using Python 2.7
  • Combobox Styling (again)

3.2.0 PySimpleGUI / 1.23.0 PySimpleGUI27 16-Jan-2019

  • Animated GIFs!
  • Calendar Chooser stays on top of other windows
  • Fixed bug of no column headings for Tables
  • Tables now use the font parameter

3.24.0 1.24.0 16-Jan-2019

  • PopupAnimated - A popup call for showing "loading" type of windows

3.25 & 1.25 20-Feb-2019

  • Comments :-)
  • Convert Text to string right away
  • Caught exceptions when main program shut down with X
  • Caught exceptions in all of the graphics primitives
  • Added parameter exportselection=False to Listbox so can use multiple listboxes
  • OneLineProgressMeter - Can now change the text on every call if desired

3.27.0 PySimpleGUI 31-Mar-2019

Mixup.... 3.26 changes don't appear to have been correctly released so releasing in 3.27 now

  • do_not_clear now defaults to TRUE!!!
    • Input Element
    • Multiline Element
  • Enable Radio Buttons to be in different containers
  • Ability to modify Autoscroll setting in Multiline.Update call
  • PopupGetFolder, PopupGetFile, PopupGetText - title defaults to message if none provided
  • PopupAnimated - image_source can be a filename or bytes (base64)
  • Option Menu can now have values updated

3.28.0 11-Apr-2019 PySimpleGUI

  • NEW Window Parameter - layout - second parameter. Can pass in layout directly now!
  • New shortcuts
    • I = InputText
    • B = Btn = Butt = Button
  • Convert button text to string when creating buttons
  • Buttons are returned now as well as input fields when searching for element with focus

3.29 22-Apr-2019

  • New method for Graph - RelocateFigure
  • Output Element no longer accepts focus

3.32.0 PySimpleGUI 24-May-2019

  • Rework of ALLL Tooltips. Was always displaying at uttuper left part of element. Not displays closer to where mouse entered or edited
  • New Element.Widget base class variable. Brings tkinter into the newer architecture of user accessibility to underlying GUI Frameworks' widgets
  • New SetTooltip Element method. Means all Elements gain this method. Can set the tooltip on the fly now for all elements
  • Include scroll bar when making visible / invisible Listbox Elements
  • New Radio Element method - Radio.ResetGroup() sets all elements in the Radio Group to False* Added borderwidth to Multiline Element
  • Button.Click() - new method - Generates a button click even as if a user clicked a button (at the tkinter level)
  • Made a Graph.Images dictionary to keep track of images being used in a graph. When graph is deleted, all of the accociated images should be deleted too.'
  • Added Graph.SetFocus() to give a Graph Element the focus just as you can input elements
  • Table new parameter - hide_vertical_scroll if True will hide the table's vertical bars
  • Window - new parameter - transparent_color. Causes a single color to become completely transparent such that you see through the window, you can click through the window. Its like tineows never was there.
  • The new Window.AllKeysDict = {} has been adopted by all PySimpleGUI ports. It's a new method of automatically creating missing keys, storing and retrieving keys in general for a window.
  • Changed how window.Maximize is implemented previously used the '-fullscreen' attribute. Now uses the 'zoomed' state
  • Window gets a new Normal() method to return from Maximize state. Sets root.state('normal')
  • Window.Close() now closes the special Window.hidden_master_root window when the "last" window is closed
  • Window.SetTransparentColor method added. Same effect as if window was created with parameter set
  • An Element's Widget stored in .Widget attribute
  • Making ComboBox's ID unique by using it's Key
  • Changed Multiline to be sunken and have a border depth setting now
  • Removed a second canvas that was being used for Graph element.
  • Changed how no titlebar is implemented running on Linux versus Windows. -type splash now used for Linux
  • PopupScrolled - Added back using CloseButton to close the window
  • Fixed PopupGetFolder to use correct PySimpleGUI program constructs (keys)
  • PopupGetText populated values carrectly using the value variable, used keys
  • PopupAnimated finally gets a completely transparent background

3.33.0 and 1.33 PySimpleGUI 25-May-2019

  • Emergency fix due to debugger. Old bug was that Image Element was not testing for COLOR_SYSTEM_DEFAULT correctly.

3.34.0 PySimpleGUI & 1.34.0 PySimpleGUI27 25-May-2019

pip rhw w cenf

  • Fixed Window.Maximize and Window.Normal - needed special code for Linux
  • Check for DEFAULT_SCROLLBAR_COLOR not being the COLOR_SYSTEM_DEFAULT (crashed)

3.35 PySimpleGUI & 1.35 PySimpleGUI27 27-May-2019

  • Bug fix - when setting default for Checkbox it was also disabling the element!

3.36 PySimpleGUI & 1.36 PySimpleGUI27 29-May-2019

A combination of user requests, and needs of new imwatchingyou debugger

  • New Debugger Icon for future built-in debugger
  • Fixed bug in FindBoundReturnKey - needed to also check Panes
  • NEW Window functions to turn on/off the Grab Anywhere feature
    • Window.GrabAnyWhereOn()
    • Window.GrabAnyWhereOff()
  • New "Debugger" button that's built-in like other buttons. It's a TINY button with a logo. For future use when a debugger is built into PySimpleGUI itself (SOON!)
  • Change Text Element Wrap Length calculation. Went fromn +40 pixels to +10 pixels in formula
  • PopupGetFile has new parameter - multiple_files. If True then allows selection of multiple files

3.37 PySimpleGUI & 1.37 PySimpleGUI27 1-June-2019

  • The built-in debugger is HERE - might not WORK exactly yet, but a lot of code went into te PySimpleGUI.py file for this. At the moment, the imwatchingyou package is THE way to use a PySimpleGUI debugger. But soon enough you won't need that project in order to debug your program.
  • Some strange code reformatting snuck in. There are 351 differences between this and previous release. I'm not sure what happened but am looking at every change by hand.
  • New Calendar Button features
    • locale, format - new parameters to TKCalendar call
    • Use custom icon for window if one has been set
    • New parameters to CalendarButton - locale, format
  • The bulk of the built-in PySimpleGUI debugger has been added but is not yet "officially supported". Try pressing "break" or "ctrl+break" on your keyboard.
    • New bindings for break / pause button and debugger
    • New Debug button will launch debugger.
    • New parameter debugger_enabled added to Window call. Default is enabled.
    • Your progam's call to Read is all that's needed to refresh debugger
    • New Window methods to control debugger access
      • EnableDebugger - turns on HOTKEYS to debugger
      • DisableDebugger - turns off HOTKEYS to debugger
  • Restored wrap len for Text elements back from +10 to +40 pixels
  • PopupGetFolder, PopupGetFile - fixed so that the "hidden" master window stays hidden (a Linux problem)
  • Added support for Multiple Files to PopupGetFiles when no_window option has been set.

3.38 PySimpleGUI, 1.38 PySimpleGUI27

  • Multiline - now has a "read only" state if created as "Disabled"
  • Multiline - If window is created as resizable, then Multiline Elements will now expand when the window is enlarged, a feature long asked for.
  • Output Element expands in the Y Direction
  • "Expandable Rows" option added to PackFormIntoFrame allowing future elements to also expand
  • Error Element - silence_on_error option
  • Text Element wrapping - FINALLY got it right? No more "Fudge factor" added
  • PopupScrolled - Windows are now resizable
  • Option to "launch built-in debugger" from the test harness
  • Rememeber that the Debugger is still in this code! It may or may not be operational as it's one version back from the latest release of the imwatchingyou debugger code. This code needs to be integrated back in

3.39 PySimpleGUI & 1.39 PySimpleGUI27 13-June-2019

  • Ported the imwatchingyou debugger code into PySimpleGUI code
    • Replaced old debugger built-in code with the newer imwatchingyou version
    • Required removing all of the 'sg.' before PySimpleGUI calls since not importing
    • Dynamically create the debugger object when first call to refresh or show is made
  • Started the procecss of renaming Class Methods that are private to start with _
  • Needed for the automatic documentation generation that's being worked on
  • Fixed crash when clicking the Debug button
  • Fixed bug in DeleteFigure. Needed to delete image separately
  • Added more type hints
  • New TabGroup method SelectTab(index) selects a Tab within a TabGroup
  • New Table.Update parameter - select_rows. List of rows to select (0 is first)
  • Error checking in Window.Layout provides error "hints" to the user
    • Looks for badly placed ']'
    • Looks for functions missing '()'
    • Pops up a window warning user instead of crashing
    • May have to revisit if the popups start getting in the way
  • New implementations of Window.Disable() and Window.Enable()
    • Previously did not work correctly at all
    • Now using the "-disabled" attribute
  • Allow Comboboxes to have empty starting values
    • Was crashing
    • Enables application to fill these in later

4.0.0 PySimpleGUI & 2.0.0 PySimpleGUI27 19-June-2019

  • DOC STRINGS DOCS STRINGS DOC STRINGS!
    • Your IDE is about to become very happy
    • All Elements have actual documentation in the call signature
    • The Readme and ReadTheDocs will be generated going forward using the CODE
    • HUGE Thanks for @nngogol for both copying & adding all those strings, but also for making an entire document creation system.
  • New version string for PySimpleGUI.py
  • New parameter to ALL SetFocus calls.
    • def SetFocus(self, force=False)
    • If force is True, then a call to focus_force is made instead of focus_set
  • Get - New Radio Button Method. Returns True is the Radio Button is set
  • Rename of Debugger class to _Debugger so IDEs don't get confused
  • User read access to last Button Color set now available via property Button.ButtonColor
  • Rename of a number of callback handlers to start with _
  • Fix for memory leak in Read call. Every call to read lost a little memory due to root.protocol calls
  • Listbox.Update - New parameter - scroll_to_index - scroll view so that index is shown at the top
  • First PyPI release to use new documentation!

Upcoming

Make suggestions people! Future release features

Code Condition

Make it run
Make it right
Make it fast

It's a recipe for success if done right. PySimpleGUI has completed the "Make it run" phase. It's far from "right" in many ways. These are being worked on. The module is particularly poor for PEP 8 compliance. It was a learning exercise that turned into a somewhat complete GUI solution for lightweight problems.

While the internals to PySimpleGUI are a tad sketchy, the public interfaces into the SDK are more strictly defined and comply with PEP 8 for the most part.

Please log bugs and suggestions in the GitHub! It will only make the code stronger and better in the end, a good thing for us all, right?

Design

A moment about the design-spirit of PySimpleGUI. From the beginning, this package was meant to take advantage of Python's capabilities with the goal of programming ease.

Single File While not the best programming practice, the implementation resulted in a single file solution. Only one file is needed, PySimpleGUI.py. You can post this file, email it, and easily import it using one statement.

Functions as objects In Python, functions behave just like object. When you're placing a Text Element into your form, you may be sometimes calling a function and other times declaring an object. If you use the word Text, then you're getting an object. If you're using Txt, then you're calling a function that returns a Text object.

Lists It seemed quite natural to use Python's powerful list constructs when possible. The form is specified as a series of lists. Each "row" of the GUI is represented as a list of Elements. When the form read returns the results to the user, all of the results are presented as a single list. This makes reading a form's values super-simple to do in a single line of Python code.

Dictionaries Want to view your form's results as a dictionary instead of a list... no problem, just use the key keyword on your elements. For complex forms with a lot of values that need to be changed frequently, this is by far the best way of consuming the results.

You can also look up elements using their keys. This is an excellent way to update elements in reaction to another element. Call form.FindElement(key) to get the Element.

Named / Optional Parameters This is a language feature that is featured heavily in all of the API calls, both functions and classes. Elements are configured, in-place, by setting one or more optional parameters. For example, a Text element's color is chosen by setting the optional text_color parameter.

tkinter tkinter is the "official" GUI that Python supports. It runs on Windows, Linux, and Mac. It was chosen as the first target GUI framework due to its ubiquity. Nearly all Python installations, with the exception of Ubuntu Linux, come pre-loaded with tkinter. It is the "simplest" of the GUI frameworks to get up an running (among Qt, WxPython, Kivy, etc).

From the start of the PSG project, tkinter was not meant to be the only underlying GUI framework for PySimpleGUI. It is merely a starting point. All journeys begin with one step forward and choosing tkinter was the first of many steps for PySimpleGUI. Now there are 4 ports up and running - tkinter, WxPython, Qt and Remi (web support)

Author

Mike - who wrote PySimpleGUI is not important. It's the software that's important

License

GNU Lesser General Public License (LGPL 3) +

Acknowledgments

SORRY!! Will add these back. Lost due to file length limitation