From 829ececa2cd21999f280054b53ac59d1e187294f Mon Sep 17 00:00:00 2001 From: MikeTheWatchGuy Date: Sat, 10 Nov 2018 20:22:53 -0500 Subject: [PATCH 1/2] Updated Readme --- PySimpleGUIQt/readme.md | 162 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 PySimpleGUIQt/readme.md diff --git a/PySimpleGUIQt/readme.md b/PySimpleGUIQt/readme.md new file mode 100644 index 00000000..ca35bb6f --- /dev/null +++ b/PySimpleGUIQt/readme.md @@ -0,0 +1,162 @@ + + + + + + + + +![pysimplegui_logo](https://user-images.githubusercontent.com/13696193/43165867-fe02e3b2-8f62-11e8-9fd0-cc7c86b11772.png) + +[![Downloads](http://pepy.tech/badge/pysimpleguiqt)](http://pepy.tech/project/pysimplegui) + + + ![Awesome Meter](https://img.shields.io/badge/Awesome_meter-1000-yellow.svg) + + ![Python Version](https://img.shields.io/badge/Python-3.x-yellow.svg) + + + + + + +# PySimpleGUIQt + + +## The Pre-Alpha Release + +[Announcements of Latest Developments](https://github.com/MikeTheWatchGuy/PySimpleGUI/issues/142) + + + + ----- +## Getting Started with PySimpleGUIQt + +Welcome to the Pre-Alpha Release of PySimpleGUI for Qt! + +You can use the exact same code that you are running on the older, tkinter, version of PySimpleGUI. + +PySimpleGUIQt uses **PySide2** for access to Qt. + +### Differences between PySimpleGUI and PySimpleGUIQt + +#### Sizes +IMPORTANT NOTE if you are porting from tkinter to Qt - You will need to make one important change to your code.... **You must change your size parameters to be in PIXELS instead of CHARACTERS**. + +#### Fonts + +Fonts should be in the format (font family, size). The original PySimpleGUI also allowed a font string 'Family Size' but that option is not available (yet) in the Qt version. I'll add it though so the code ports straight over. + + + +### Installing PySimpleGUIQt for Python 3 + + pip install --upgrade PySimpleGUIQt + +On some systems you need to run pip3. + + pip3 install --upgrade PySimpleGUIQt + + +### Installing PySide2 for Python 3 + +```pip install PySide2``` + + + + + +## Testing your installation + +Once you have installed, or copied the .py file to your app folder, you can test the installation using python. At the command prompt start up Python. +``` +python3 +>>> import PySimpleGUIQt +>>> PySimpleGUIQt.main() +``` + +You will see a sample window in the center of your screen. If it's not installed correctly you are likely to get an error message during one of those commands + +Here is the window you should see: + +![sample window](https://user-images.githubusercontent.com/13696193/46097669-79efa500-c190-11e8-885c-e5d4d5d09ea6.jpg) + + + +## Prerequisites +Python 3 +PySide2 + + + +## Using - Python 3 + +To use in your code, simply import.... + `import PySimpleGUIQt as sg` + +Then use the exact same code as any other PySimpleGUI program that runs on tkinter. + +## Status + +### Functioning features +Features are being added daily to this Qt port of PySimpleGUI. +These Elements are "complete" (a relative term... more are more complete than others): +* Text +* Input single line +* Input multiline +* Output multiline (new) +* Dial (new) +* Output - reroute stdout +* Spinner +* Sliders +* Buttons - RButtons, CButtons, Short-cut Buttons +* Checkbox +* Radio Buttons +* Listbox +* ComboBox +* Labeled Frames +* Columns - enables you to make pretty much any layout! +* Alpha channel for windows +* No Title Bar setting +* Enter submits for multiline +* Fonts +* Colors for text and background +* Timeouts for Read calls +* Change Submits parametes for most Elements +* Table + * Basic display + * Read selected rows + * change_submits events + * Updates +* Image as a background (new feature) + + + + +## Missing Features + +Notable MISSING features at the moment include: +* Graphs Element +* Image Element +* Tree Element - the more complex Elements have not yet been ported. Stay tuned, new ones being added daily! +* Tab & tab group Elements +* Menus +* Change submits - for radio buttons + + + + +## Design + +## Author +MikeTheWatchGuy + +## Demo Code Contributors + + +## License + +GNU Lesser General Public License (LGPL 3) + + +## Acknowledgments + From 81e68abd280cd458a0189084868bd84ecdc7829f Mon Sep 17 00:00:00 2001 From: MikeTheWatchGuy Date: Sat, 10 Nov 2018 20:25:29 -0500 Subject: [PATCH 2/2] Readme update with Qt info --- docs/index.md | 17 +++++++++++++---- readme.md | 17 +++++++++++++---- 2 files changed, 26 insertions(+), 8 deletions(-) diff --git a/docs/index.md b/docs/index.md index 15d9aaec..23bc07cc 100644 --- a/docs/index.md +++ b/docs/index.md @@ -21,12 +21,17 @@ # PySimpleGUI - -## Now supports both Python 2.7 & 3 - + +# NEW for NOV 2018 - Run Qt using PySimpleGUI! + +## Supports both Python 2.7 & 3 when using tkinter + + ![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_3.x_Version-3.14.1-red.svg?longCache=true&style=for-the-badge) - ![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-1.14.1-blue.svg?longCache=true&style=for-the-badge) +![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-1.14.1-blue.svg?longCache=true&style=for-the-badge) + +![Python Version](https://img.shields.io/badge/PySimpleGUIQt_For_Python_3.x_Version-0.4.0-gold.svg?longCache=true&style=for-the-badge) [Announcements of Latest Developments](https://github.com/MikeTheWatchGuy/PySimpleGUI/issues/142) @@ -50,6 +55,10 @@ The native GUI framework for perfectionists with deadlines #### Note regarding Python versions As of 9/25/2018 **both Python 3 and Python 2.7 are supported**! The Python 3 version is named `PySimpleGUI`. The Python 2.7 version is `PySimpleGUI27`. They are installed separately and the imports are different. See instructions in Installation section for more info. +#### Qt Version + +Check out the new PySimpleGUI port to the Qt GUI Framework. You can learn more on the [PySimpleGUIQt GitHub site](https://github.com/MikeTheWatchGuy/PySimpleGUI/tree/master/PySimpleGUIQt). There is a separate Readme file for the Qt version that you'll find there. Give it a shot if you're looking for something a bit more "modern". + ------------------------------------------------------------------------ diff --git a/readme.md b/readme.md index 15d9aaec..23bc07cc 100644 --- a/readme.md +++ b/readme.md @@ -21,12 +21,17 @@ # PySimpleGUI - -## Now supports both Python 2.7 & 3 - + +# NEW for NOV 2018 - Run Qt using PySimpleGUI! + +## Supports both Python 2.7 & 3 when using tkinter + + ![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_3.x_Version-3.14.1-red.svg?longCache=true&style=for-the-badge) - ![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-1.14.1-blue.svg?longCache=true&style=for-the-badge) +![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-1.14.1-blue.svg?longCache=true&style=for-the-badge) + +![Python Version](https://img.shields.io/badge/PySimpleGUIQt_For_Python_3.x_Version-0.4.0-gold.svg?longCache=true&style=for-the-badge) [Announcements of Latest Developments](https://github.com/MikeTheWatchGuy/PySimpleGUI/issues/142) @@ -50,6 +55,10 @@ The native GUI framework for perfectionists with deadlines #### Note regarding Python versions As of 9/25/2018 **both Python 3 and Python 2.7 are supported**! The Python 3 version is named `PySimpleGUI`. The Python 2.7 version is `PySimpleGUI27`. They are installed separately and the imports are different. See instructions in Installation section for more info. +#### Qt Version + +Check out the new PySimpleGUI port to the Qt GUI Framework. You can learn more on the [PySimpleGUIQt GitHub site](https://github.com/MikeTheWatchGuy/PySimpleGUI/tree/master/PySimpleGUIQt). There is a separate Readme file for the Qt version that you'll find there. Give it a shot if you're looking for something a bit more "modern". + ------------------------------------------------------------------------