/sublime_debugger-MayaUI

An adapter for debugging custom UI in Maya using Sublime Debugger in Sublime Text 3 and 4

Primary LanguagePythonMIT LicenseMIT

A Debug Adapter for Debugging functions called by Custom Maya UI Components

This adapter serves as a "middleman" between the Sublime Debugger plugin and a DAP implementation for python (debugpy) injected into Maya.

It intercepts a few DAP requests to establish a connection between the debugger and Maya, and otherwise forwards all communications between the debugger and debugpy normally.

Installation

To install from repo,

  • Open Sublime
  • Install the "Debugger" plugin with Package Control if not done already
  • In the "Preferences" menu, select "Browse Packages..."
  • Clone this repository into the folder opened by Sublime
  • Open the project you want to debug
    • If the debugger isn't open, select "Open" in the "Debugger" menu option
    • If it still doesn't open, ensure your project settings (Project -> Edit Project) are not empty, then try again
  • Under the "Debugger" menu, select "Add or Select Configuration"
  • Select "Add Configuration" from the suggestions
  • There should be a "Maya: Custom UI Debugging" option, click on it
  • You should have your project settings automatically opened, edited with the configuration
  • Save your project settings

Use

  • Go to Debugger -> Add or Select Configuration, and select "Maya: Custom UI Debugging"
  • Place breakpoints wherever needed
  • Press play -- Nothing will seem to happen other than the pause button lighting
  • In Maya, click on the relevant UI components to start debugging them

The Maya UI Adapter should now be functional just by pressing play.

If it is your first time installing the adapter and Maya is already open, make sure to restart Maya first (a first-time setup is performed).

Note

Currently only tested on Windows