PySimpleGUI/PySimpleGUIWeb
MikeTheWatchGuy 0488a5e95e PySimpleGUIWeb/readme.md updated from https://stackedit.io/ 2019-01-26 14:34:40 -05:00
..
Demo Programs Disable element, Release 0.2.0 2019-01-23 16:59:54 -05:00
PySimpleGUIWeb.py Relase 0.4.0 - Events for all elements, spinner, multiline output with updates, new test harness 2019-01-26 14:31:53 -05:00
readme.md PySimpleGUIWeb/readme.md updated from https://stackedit.io/ 2019-01-26 14:34:40 -05:00

readme.md

pysimplegui_logo

Downloads]

Awesome Meter

Python Version

Python Version

PySimpleGUIWeb

PySimpleGUI running in your web browser

Primary PySimpleGUI Documentation

To get instructions on how use PySimpleGUI's APIs, please reference the main documentation. This Readme is for information specific to the Web port of PySimpleGUI.

What is PySimpleGUIWeb?

PySimpleGUIWeb enables you to run your PySimpleGUI programs in your web browser. It utilizes a package called Remi to achieve this amazing package.

At the moment (Jan 26 2019) these elements are operational:

  • Text
  • Single line text input
  • Multiline Input
  • Multiline Output
  • Listbox
  • Combobox
  • Checkbox
  • Slider
  • Spinner (numbers only...hardcoded to 0 to 100)

Engineering Pre-Release Version 0.4.0

Announcements of Latest Developments

Having trouble? Visit the GitHub site and log an Issue.

Installation

Installation is quite simple:

pip install pysimpleguiweb

Should this not work, you can copy and paste the file PySimpleGUIWeb.py into your application folder.

Using

There are a lot of examples in the PySimpleGUI Cookbook as well as on the GitHub site. At the moment very few will work due to the limited number of features of the 0.1.0 release. It shouldn't be too long before they'll work.

To use PySimpleGUIWeb you need to import it: import PySimpleGUIWeb as sg

From there follow the code examples in the Coookbook and the Demo Programs. The only difference in those programs is the import statement. The remainder of the code should work without modification.

Requirements

PySimpleGUIWeb is based on the Remi project. You will need to install Remi prior to running PySimpleGUIWeb:

pip install remi

You can learn more about Remi on its homepage.

https://github.com/dddomodossola/remi

PySimpleGUIWeb runs only on Python 3. Legacy Python (2.7) is not supported.

What Works

  • Text Element
  • Input Text Element
  • Button Element
  • Combobox Element
  • Checkbox Element
  • Listbox Element
  • Window background color
  • Element padding
  • Read with timeout
  • Read with timeout = 0

Release Notes:

0.1.0 PySimpleGUIWeb 22-Jan-2019

  • Initial release
  • Text Element
  • Input Text Element
  • Button Element
  • Window class

0.2.0 PySimpleGUIWeb 23-Jan-2019

Day 2 of development brings fonts, sizes, and colors...

  • For all elements (Text, Input Text, Button):
    • Font family
    • Font size
    • Text Color
    • Background Color
    • Disable
    • Size
  • Button Color
  • Read timeouts (zero, non-zero, None/pend)
  • Window close
  • Window background color

0.3.0 PySimpleGUIWeb 24-Jan-2019

  • Checkbox Element
  • Combobox Element
  • Listbox Element
  • Element padding for all elements

0.4.0 PySimpleGUIWeb 26-Jan-2019

Functioning Elements

  • Text
  • Single line text input
  • Multiline Input
  • Multiline Output
  • Listbox
  • Combobox
  • Checkbox
  • Slider
  • Spinner (numbers only...hardcoded to 0 to 100)

New features

  • Tooltips for all elements (so cool this works)
  • Input Text events
  • Text clicked event
  • Listbox selected event
  • Combobox selected event
  • Checkbox Update
  • Disable parameter for all elements
  • Window.Close shuts down the server
  • Enabled exceptions during packing operation
  • New test harness exercises all element types

Design

Author

Mike B.

License

GNU Lesser General Public License (LGPL 3) +

Acknowledgments