psychopy 2025.1.1__py3-none-any.whl → 2025.2.1__py3-none-any.whl

psychopy/app/builder/validators.py

@@ -50,19 +50,17 @@ class ValidatorWarning:
         Symbolic constant representing the type of warning. Values can be one of
         `VALIDATOR_WARNING_NONE`, `VALIDATOR_WARNING_NAME`,
         `VALIDATOR_WARNING_SYNTAX` or `VALIDATOR_WARNING_FONT_MISSING`.
+    allowed : bool
+        If False, this warning should prevent the user from proceeding
 
     """
-    __slots__ = [
-        '_parent',
-        '_control',
-        '_msg',
-        '_kind']
 
-    def __init__(self, parent, control, msg="", kind=VALIDATOR_WARNING_NONE):
+    def __init__(self, parent, control, msg="", kind=VALIDATOR_WARNING_NONE, allowed=True):
         self.parent = parent
         self.control = control
         self.msg = msg
         self.kind = kind
+        self.allowed = allowed or self.kind in [VALIDATOR_WARNING_FONT_MISSING]
 
     @property
     def parent(self):
@@ -118,12 +116,6 @@ class ValidatorWarning:
         """`True` if this is a namespace warning (`bool`)."""
         return self._kind == VALIDATOR_WARNING_NAME
 
-    @property
-    def allowed(self):
-        """`True` if this is a non-critical message which doesn't disable the OK button"""
-        return self.kind in [VALIDATOR_WARNING_FONT_MISSING]
-
-
 class WarningManager:
     """Manager for warnings produced by validators associated with controls
     within the component properties dialog. Assumes that the `parent` dialog
@@ -159,11 +151,26 @@ class WarningManager:
 
     @property
     def OK(self):
-        """`True` if there are no warnings (`bool`)."""
+        """
+        Return
+        ======
+        bool
+            True if there are no messages which aren't `.allowed`
+        """
         if len(self._warnings) == 0:
             return True
         else:
             return all(warning.allowed for warning in self._warnings.values())
+    
+    @property
+    def isEmtpy(self):
+        """
+        Returns
+        -------
+        bool
+            True if there are no warnings at all, even allowed ones.
+        """
+        return len(self._warnings) == 0
 
     @property
     def parent(self):
@@ -200,7 +207,7 @@ class WarningManager:
         _, warnings = self._warnings.items()
         return [warning.control for warning in warnings]
 
-    def setWarning(self, control, msg='', kind=VALIDATOR_WARNING_NONE):
+    def setWarning(self, control, msg='', kind=VALIDATOR_WARNING_NONE, allowed=True):
         """Set a warning for a control. A control can only have one active
         warning associate with it at any given time.
 
@@ -213,10 +220,11 @@ class WarningManager:
         kind : int
             Symbolic constant representing the type of warning (e.g.,
             `VALIDATOR_WARN_SYNTAX`).
-
+        allowed : bool
+            If False, prevent the user from continuing
         """
         self._warnings[id(control)] = ValidatorWarning(
-            self.parent, control, msg, kind)
+            self.parent, control, msg, kind, allowed)
 
     def getWarning(self, control):
         """Get an active warning associated with the control.
@@ -500,7 +508,7 @@ class CodeSnippetValidator(BaseValidator):
             # get var names from val, check against namespace:
             code = experiment.getCodeFromParamStr(val, target="PsychoPy")
             try:
-                names = list(stringtools.getVariables(code))
+                names = list(stringtools.getVariableDefs(code))
                 parent.warnings.clearWarning(control)
             except (SyntaxError, TypeError) as e:
                 # empty '' compiles to a syntax error, ignore

psychopy/app/coder/coder.py

@@ -1101,7 +1101,7 @@ class CoderFrame(BaseAuiFrame, handlers.ThemeMixin):
         self.showingReloadDialog = False
 
         # default window title string
-        self.winTitle = "PsychoPy Coder (v{})".format(self.app.version)
+        self.winTitle = title
 
         # we didn't have the key or the win was minimized/invalid
         if self.appData['winH'] == 0 or self.appData['winW'] == 0:
@@ -2856,6 +2856,17 @@ class CoderFrame(BaseAuiFrame, handlers.ThemeMixin):
         # UnitTestFrame.Show()
 
     def openPluginManager(self, evt=None):
+        import psychopy.app.plugin_manager.packageIndex as packageIndex
+        if packageIndex.isIndexing():
+            msg = _translate("The package index is currently being updated. "
+                             "Please try again later.")
+            wx.MessageBox(
+                msg,
+                _translate("Package indexing in progress"),
+                style=wx.OK | wx.ICON_INFORMATION
+            )
+            return
+        
         dlg = psychopy.app.plugin_manager.dialog.EnvironmentManagerDlg(self)
         dlg.Show()
         # Do post-close checks

psychopy/app/coder/repl.py

@@ -349,7 +349,9 @@ class PythonREPLCtrl(wx.Panel, handlers.ThemeMixin):
             "Starting Python interpreter session, please wait ...\n")
 
         # setup the sub-process
-        wx.BeginBusyCursor()
+        if wx.Platform != '__WXGTK__':
+            wx.BeginBusyCursor()
+
         self._process = wx.Process(self)
         self._process.Redirect()
 
@@ -373,7 +375,8 @@ class PythonREPLCtrl(wx.Panel, handlers.ThemeMixin):
         self._lastTextPos = self.txtTerm.GetLastPosition()
         self.toolbar.update()
 
-        wx.EndBusyCursor()
+        if wx.Platform != '__WXGTK__':
+            wx.EndBusyCursor()
 
     def interrupt(self, evt=None):
         """Send a keyboard interrupt signal to the interpreter.

psychopy/app/colorpicker/__init__.py

@@ -566,7 +566,7 @@ class PsychoColorPicker(ColorPickerDialog):
                 self.context.GetCurrentPos(), "(" + self.getOutputValue() + ")")
 
         self._saveState()  # retain state
-        self.Close()
+        self.EndModal(wx.ID_OK)
 
     def OnCopy(self, event):
         """Event to copy the color to the clipboard as a value.

psychopy/app/deviceManager/__init__.py

@@ -0,0 +1 @@
+from .dialog import DeviceManagerDlg, AddDeviceDlg

psychopy/app/deviceManager/addDialog.py

@@ -0,0 +1,218 @@
+from psychopy.app.deviceManager.utils import DeviceImageList
+from psychopy.app.builder.dialogs.paramCtrls import EVT_PARAM_CHANGED, ParamCtrl
+from psychopy.app.builder.validators import WarningManager
+from psychopy.app.themes import fonts, icons
+from psychopy.experiment.devices import DeviceBackend
+from psychopy.experiment.params import Param
+from psychopy.hardware.manager import DeviceManager
+from psychopy import logging
+from psychopy.localization import _translate
+
+
+import wx
+
+
+class AddDeviceDlg(wx.Dialog):
+
+    availableDevices = None
+
+    def __init__(self, parent, deviceName=""):
+        wx.Dialog.__init__(
+            self, parent, title="Add device",
+            size=(540, 540),
+            style=wx.RESIZE_BORDER | wx.CAPTION | wx.CLOSE_BOX
+        )
+        # attributes to store selection
+        self.selectedCls = None
+        self.selectedProfile = None
+        # setup warnings
+        self.warnings = WarningManager(self)
+        # setup sizers
+        self.border = wx.BoxSizer(wx.VERTICAL)
+        self.SetSizer(self.border)
+        self.sizer = wx.BoxSizer(wx.VERTICAL)
+        self.border.Add(
+            self.sizer, proportion=1, border=12, flag=wx.EXPAND | wx.ALL
+        )
+        # name ctrl
+        self.nameLbl = wx.StaticText(self, label=_translate("Device name"))
+        self.sizer.Add(
+            self.nameLbl, border=6, flag=wx.EXPAND | wx.TOP
+        )
+        self.name = Param(
+            deviceName, valType="str", inputType="name",
+            label=_translate("Device label"),
+            hint=_translate(
+                "A name to refer to this device by in Device Manager."
+            )
+        )
+        self.nameCtrl = ParamCtrl(
+            self,
+            field="name",
+            param=self.name,
+            element=None,
+            warnings=self.warnings
+        )
+        # bump up the font size
+        self.nameCtrl.ctrl.SetFont(fonts.AppFont(
+            pointSize=int(fonts.AppFont.pointSize*1.5),
+            bold=True
+        ).obj)
+        self.sizer.Add(
+            self.nameCtrl, border=6, flag=wx.EXPAND | wx.BOTTOM
+        )
+        self.nameCtrl.Bind(EVT_PARAM_CHANGED, self.validate)
+
+        # devices ctrl
+        self.devicesLbl = wx.StaticText(self, label=_translate("Available devices"))
+        self.sizer.Add(
+            self.devicesLbl, border=6, flag=wx.EXPAND | wx.TOP
+        )
+        self.devicesCtrl = wx.TreeCtrl(
+            self,
+            style=wx.TR_HIDE_ROOT | wx.TR_HAS_BUTTONS | wx.TR_NO_LINES
+        )
+        self.imageList = DeviceImageList(width=24, height=24)
+        self.devicesCtrl.SetImageList(self.imageList)
+        self.devicesCtrl.SetIndent(6)
+        self.sizer.Add(
+            self.devicesCtrl, proportion=1, border=6, flag=wx.EXPAND | wx.BOTTOM
+        )
+        self.devicesCtrl.Bind(wx.EVT_TREE_SEL_CHANGED, self.onSelectItem)
+        self.devicesLoadingLbl = wx.StaticText(
+            self,
+            label=_translate("Scanning...")
+        )
+        self.sizer.Add(
+            self.devicesLoadingLbl, border=6, flag=wx.EXPAND | wx.ALL
+        )
+        # warnings panel
+        self.sizer.Add(
+            self.warnings.output, border=6, flag=wx.EXPAND | wx.TOP
+        )
+        # add ctrls
+        self.ctrls = self.CreateStdDialogButtonSizer(
+            flags=wx.OK | wx.CANCEL
+        )
+        self.border.Add(
+            self.ctrls, border=12, flag=wx.EXPAND | wx.LEFT | wx.RIGHT | wx.BOTTOM
+        )
+        # get handle of OK button
+        for item in self.ctrls.GetChildren():
+            if item.Window is not None and item.Window.GetId() == wx.ID_OK:
+                self.okBtn = item.Window
+        self.Layout()
+        # queue populate command
+        self.Bind(wx.EVT_IDLE, self.populateAsync)
+        # start off with focus on name field
+        self.nameCtrl.SetFocus()
+
+    def validate(self, evt=None):
+        self.okBtn.Enable(
+            self.warnings.OK
+            and self.selectedCls is not None
+            and self.selectedProfile is not None
+        )
+
+    def populate(self):
+        """
+        Populate the devices tree control from DeviceManager
+        """
+        # start off with "loading devices" message
+        self.devicesLoadingLbl.Show()
+        self.devicesCtrl.Hide()
+        self.Layout()
+        # get array of available devices by backend
+        if AddDeviceDlg.availableDevices is None:
+            AddDeviceDlg.availableDevices = {}
+            for backend in DeviceBackend.getAllBackends():
+                try:
+                    AddDeviceDlg.availableDevices[backend] = DeviceManager.getAvailableDevices(backend.deviceClass)
+                except Exception as err:
+                    logging.warn("Failed to scan for {backend.deviceClass} devices, reason: {err}")
+        # clear ctrl
+        self.devicesCtrl.DeleteAllItems()
+        self.branchClasses = {}
+        # add a root
+        root = self.devicesCtrl.AddRoot("Available devices")
+        # iterate through classes...
+        for cls, profiles in self.availableDevices.items():
+            # don't add label if there's no profiles
+            if len(profiles) == 0:
+                continue
+            # add a child for each class
+            branch = self.devicesCtrl.AppendItem(
+                root, 
+                cls.backendLabel or cls.__name__, 
+                image=self.imageList.getIcon(cls) or -1
+            )
+            self.devicesCtrl.SetItemBold(branch)
+            # store ref to branch class
+            self.branchClasses[branch] = cls
+            # iterate through profiles...
+            for profile in profiles:
+                self.devicesCtrl.AppendItem(branch, profile.get("deviceName", "unnamed"))
+        # expand and show
+        self.devicesCtrl.ExpandAll()
+        self.devicesLoadingLbl.Hide()
+        self.devicesCtrl.Show()
+        self.Layout()
+
+    def populateAsync(self, evt):
+        """
+        Call `.populate` from an asynchronous event handler, the unbind it.
+
+        Parameters
+        ----------
+        evt : wx.IdleEvent
+            wx event triggering this call
+        """
+        # populate
+        self.populate()
+        # unbind
+        if evt.EventType == wx.EVT_IDLE.typeId:
+            self.Unbind(wx.EVT_IDLE)
+
+    def getDevice(self):
+        """
+        Get the Device object from the choice made in this ctrl.
+
+        Returns
+        -------
+        psychopy.experiment.devices.DeviceBackend
+            Backend object for the chosen device
+        """
+        # create device object
+        device = self.selectedCls(self.selectedProfile)
+        # store name
+        device.params['deviceLabel'].val = self.nameCtrl.getValue()
+
+        return device
+
+    def onSelectItem(self, evt):
+        evt.Skip()
+        # this event is triggered on deletion due to a bug in wx.TreeCtrl, so catch it
+        if not self.devicesCtrl:
+            return
+        # get id of selected profile and its parent
+        item = self.devicesCtrl.GetSelection()
+        branch = self.devicesCtrl.GetItemParent(item)
+        # update profile
+        if branch != self.devicesCtrl.GetRootItem():
+            # get class and device name
+            cls = self.branchClasses[branch]
+            name = self.devicesCtrl.GetItemText(item)
+            # find profile with matching name
+            profile = None
+            for thisProfile in self.availableDevices[cls]:
+                if thisProfile.get("deviceName", "unnamed") == name:
+                    profile = thisProfile
+                    break
+        else:
+            # if parent is the root node, selection isn't a profile
+            cls = profile = None
+        # store selected values
+        self.selectedCls = cls
+        self.selectedProfile = profile
+        # enable OK based on selection
+        self.validate()

psychopy/app/deviceManager/dialog.py

@@ -0,0 +1,185 @@
+from psychopy.app.deviceManager.addDialog import AddDeviceDlg
+from psychopy.app.deviceManager.panel import DevicePanel
+from psychopy.app.deviceManager.utils import DeviceImageList
+from psychopy.preferences import prefs
+
+
+import wx
+
+
+class DeviceManagerDlg(wx.Dialog):
+    """
+    GUI for managing named devices, allows user to map device names specified in an experiment to 
+    physical devices on this machine.
+    """
+    def __init__(self, parent):
+        wx.Dialog.__init__(
+            self, parent, title="Device manager",
+            size=(720, 540),
+            style=wx.RESIZE_BORDER | wx.CAPTION | wx.CLOSE_BOX
+        )
+        self.SetMinSize((540, 256))
+        self.devices = prefs.devices.copy()
+        # setup sizers
+        self.border = wx.BoxSizer(wx.VERTICAL)
+        self.SetSizer(self.border)
+        self.sizer = wx.BoxSizer(wx.VERTICAL)
+        self.border.Add(
+            self.sizer, border=12, proportion=1, flag=wx.EXPAND | wx.ALL
+        )
+
+        # profiles notebook
+        self.profilesNotebook = wx.Listbook(self, style=wx.LB_LEFT)
+        self.sizer.Add(
+            self.profilesNotebook, border=0, proportion=1, flag=wx.EXPAND | wx.ALL
+        )
+        self.pages = {}
+        # resize the list ctrl
+        self.profilesListCtrl = self.profilesNotebook.GetListView()
+        self.profilesListCtrl.SetWindowStyleFlag(wx.LC_LIST)
+
+        if wx.Platform == "__WXMSW__":
+            self.profilesListCtrl.SetColumnWidth(-1, 128)
+            
+        self.profilesListCtrl.SetMinSize((128, 128))
+        self.profilesListCtrl.Refresh()
+        # apply cached devices image list
+        self.imageList = DeviceImageList(width=24, height=24)
+        self.profilesListCtrl.SetImageList(self.imageList, which=wx.IMAGE_LIST_SMALL)
+        # self.profilesListCtrl.SetWindowStyle(wx.LC_ICON)
+        # get list ctrl sizer so we can add ctrls
+        self.profilesListCtrl.sizer = self.profilesListCtrl.GetSizer()
+        if self.profilesListCtrl.sizer is None:
+            # on windows, ListCtrl doesn't have a sizer, so make one
+            self.profilesListCtrl.sizer = wx.BoxSizer(wx.VERTICAL)
+            self.profilesListCtrl.sizer.AddStretchSpacer(1)
+            self.profilesListCtrl.SetSizer(self.profilesListCtrl.sizer)
+        # add device button
+        self.addDeviceBtn = wx.Button(
+            self.profilesListCtrl, label="Add device"
+        )
+        self.addDeviceBtn.Bind(wx.EVT_BUTTON, self.onAddDeviceBtn)
+        self.profilesListCtrl.sizer.Add(
+            self.addDeviceBtn, border=6, flag=wx.EXPAND | wx.ALL
+        )
+
+        self.populate()
+
+        # add ctrls
+        self.ctrls = self.CreateStdDialogButtonSizer(
+            flags=wx.OK | wx.CANCEL
+        )
+        self.Bind(wx.EVT_BUTTON, self.onOK, id=wx.ID_OK)
+        self.border.Add(self.ctrls, border=12, flag=wx.EXPAND | wx.ALL)
+        # get handle of OK button
+        for item in self.ctrls.GetChildren():
+            if item.Window is not None and item.Window.GetId() == wx.ID_OK:
+                self.okBtn = item.Window
+
+        self.Layout()
+    
+    def populate(self):
+        """
+        Populate the device names ctrl from saved devices.
+        """
+        # add pages
+        for name, device in self.devices.items():
+            if name not in self.pages:
+                # create page
+                self.pages[name] = DevicePanel(
+                    parent=self.profilesNotebook, 
+                    dlg=self, 
+                    device=device
+                )
+                # add page
+                self.profilesNotebook.AddPage(
+                    text=name, page=self.pages[name], imageId=self.imageList.getIcon(device)
+                )
+        # add/remove a placeholder depending on whether there's no pages
+        if not len(self.pages):
+            self.pages[None] = wx.Panel(self.profilesNotebook)
+            self.profilesNotebook.AddPage(text="", page=self.pages[None])
+        elif None in self.pages:
+            self.profilesNotebook.RemovePage(
+                self.profilesNotebook.FindPage(self.pages[None])
+            )
+            del self.pages[None]
+    
+    def renameDevice(self, oldname, newname):
+        # set name param
+        self.devices[oldname].name = newname
+        # rename tab
+        self.profilesNotebook.SetPageText(
+            self.profilesNotebook.FindPage(self.pages[oldname]),
+            newname
+        )
+        # relocate in devices array
+        self.devices[newname] = self.devices.pop(oldname)
+        # relocate in pages array
+        self.pages[newname] = self.pages.pop(oldname)
+        # validate ok button
+        self.validate()
+
+    def onNameSelected(self, evt=None):
+        # get name
+        name = self.getCurrentName()
+        # disable whole panel if nothing is selected
+        self.devicePnl.Enable(name is not None)
+        # if mapped, show mapping
+        if name in self.pages:
+            self.profilesNotebook.ChangeSelection(
+                self.profilesNotebook.FindPage(self.pages[name])
+            )
+        
+        self.Layout()
+        self.Refresh()
+
+    def onAddDeviceBtn(self, evt=None):
+        dlg = AddDeviceDlg(self)
+
+        if dlg.ShowModal() == wx.ID_OK:
+            # get selected device
+            device = dlg.getDevice()
+            # create Device object
+            self.devices[device.name] = device
+
+        self.populate()
+    
+    def validate(self):
+        # enable/disable OK button if every page is okay
+        self.okBtn.Enable(all([
+            self.profilesNotebook.GetPage(i).warnings.OK 
+            for i in range(self.profilesNotebook.GetPageCount())
+        ]))
+    
+    def onOK(self, evt):
+        # run on OK methods from all params
+        for i in range(self.profilesNotebook.GetPageCount()):
+            page = self.profilesNotebook.GetPage(i)
+            if hasattr(page, "onElementOk"):
+                page.onElementOk(evt)
+        # save config
+        self.devices.save()
+        # reload in prefs so changes are applied this session
+        prefs.devices.reload()
+
+        evt.Skip()
+    
+    def getCurrentName(self):
+        """
+        Get the currently selected name.
+
+        Returns
+        -------
+        str
+            Current name
+        """
+        # get index of selection
+        i = self.namesCtrl.GetSelection()
+        # return None if none found
+        if i == wx.NOT_FOUND:
+            return None
+        # get name
+        name = self.namesCtrl.GetString(i)
+
+        return name