SES Debugger (Set break points with contextual awareness.)

じ☆ve冰风

SES Debugger v1.2
by Solistra​

Introduction
This script provides a simple debugger with break point functionality using the SES Console. Essentially, you establish a series of break points on specific lines within scripts in the Ace Script Editor — when the line is encountered, execution stops and the SES Console is opened with the active class at the time of the break as the context. This is primarily a scripter’s tool.

Change Log

• v1.2 (April 18th, 2014) - Removed Tracer dependency, bug fixes.
  
• v1.1 (April 14th, 2014) - Fix potential encoding errors.
  
• v1.0 (April 11th, 2014) - Initial release.
  

Features

• Dynamic setting of break points in code execution.
  
• Displays code surrounding the break point when encountered.
  
• Console context is automatically set to the object which triggered the break point.
  
• Iterates over defined break points until stopped.
  

Screenshot
Spoiler

​

Usage
The debugger may be started by pressing F6 (by default -- this is able to be configured in the configuration area) or by explicitly starting it through the SES Console or a script call:
 
                Code:       

1. SES::Debugger.start

复制代码

Once the debugger has started, it will trace Ruby code execution until one of the configured break points has been encountered. Once a break point is reached, execution is halted and control is handed to you through the SES Console. See the documentation for the SES Console script for more detailed information about the console itself.

You may stop the debugger at any time while it is running by entering the following either through the SES Console or a script call:
 
                Code:       

1. SES::Debugger.stop

复制代码

Break points are stored as a hash in the SES:
ebugger module (aptly named "@breakpoints"). The instance variable storing the hash is also a reader method for the module, allowing you to dynamically add, remove, or modify the breakpoints during game execution. Break points are defined within the hash with the file name of the script as the key and an array of line numbers to serve as break points as the value.

For example, let's assume that we want to break every time Scene_Base is told to update. In order to set up that break point, we could do one of two things (depending on when we need the break point set): we can either include the break point in the configuration area of the script, or we can set the point dynamically at some point during the game's execution (either through a REPL -- such as the console -- or a script call). The following examples demonstrate both methods:
 
                Code:       

1. # Configuration area.@breakpoints = {  'Scene_Base' => [40],}# Dynamically adding the break point.SES::Debugger.breakpoints['Scene_Base'] = [40]

复制代码

If we then decide that we need to break whenever Scene_Base performs a basic update, we can either add line 46 to the configuration area or add it during runtime like so:
 
                Code:       

1. SES::Debugger.breakpoints['Scene_Base'].push(46)

复制代码

Script
This script is available from SES VX Ace.

Installation
This script requires the SES Core (v2.0), and Console (v1.0) scripts in order to function.

Place this script below Materials, but above Main. Place this script below the SES Core and SES Console, but above other custom scripts.

Credit and Thanks

• Solistra
  

Author's Notes
This script is made available under the terms of the MIT Expat license. View this page for more information.


本贴来自国际rpgmaker官方论坛作者:Solistra处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/ses-debugger-set-break-points-with-contextual-awareness.26077/