Allow wxPython object methods to be called from any thread.
Project description
wxAnyThread: allow methods on wxPython objects to be called from any thread
In wxPython, methods that alter the state of the GUI are only safe to call from
the thread running the main event loop. Other threads must typically post
events to the GUI thread instead of invoking methods directly.
While there are builtin shortcuts for this (e.g. wx.CallAfter) they do not
capture the full semantics of a function call. This module provides an easy
way to invoke methods from any thread *transparently*, propagating return
values and exceptions back to the calling thread.
The main interface is a decorator named "anythread", which can be applied
to methods to make them safe to call from any thread, like so:
class MyFrame(wx.Frame):
@anythread
def GetSomeData():
dlg = MyQueryDialog(self,"Enter some data")
if dlg.ShowModal() == wx.ID_OK:
resp = dlg.GetResponse()
return int(resp)
else:
raise NoDataEnteredError()
The GetSomeData method can now be directly invoked from any thread.
The calling thread will block while the main GUI thread shows the dialog,
and will then receive a return value or exception as appropriate.
In wxPython, methods that alter the state of the GUI are only safe to call from
the thread running the main event loop. Other threads must typically post
events to the GUI thread instead of invoking methods directly.
While there are builtin shortcuts for this (e.g. wx.CallAfter) they do not
capture the full semantics of a function call. This module provides an easy
way to invoke methods from any thread *transparently*, propagating return
values and exceptions back to the calling thread.
The main interface is a decorator named "anythread", which can be applied
to methods to make them safe to call from any thread, like so:
class MyFrame(wx.Frame):
@anythread
def GetSomeData():
dlg = MyQueryDialog(self,"Enter some data")
if dlg.ShowModal() == wx.ID_OK:
resp = dlg.GetResponse()
return int(resp)
else:
raise NoDataEnteredError()
The GetSomeData method can now be directly invoked from any thread.
The calling thread will block while the main GUI thread shows the dialog,
and will then receive a return value or exception as appropriate.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
wxAnyThread-0.2.0.tar.gz
(2.8 kB
view details)
File details
Details for the file wxAnyThread-0.2.0.tar.gz
.
File metadata
- Download URL: wxAnyThread-0.2.0.tar.gz
- Upload date:
- Size: 2.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 81ba31c0dab2a500b409074b16c4f50dade183fb2c6735d64623f8342416ba65 |
|
MD5 | 34eb97a0d7db245e85ce2d0d909b2d74 |
|
BLAKE2b-256 | 2e1f517aba551e21b34b89864d5caf8d99aeaf3a876c422bd2bcf84fd25bcb77 |