DebugRunner 1.2.0

DebugRunner

Librería que se instala en el proceso que se va a depurar para ejecutar métodos manualmente durante una sesión de depuración, resolviendo las dependencias desde el IServiceProvider real de la aplicación (misma base de datos, mismo appsettings.json, mismo scope de ejecución).

La extensión de Visual Studio "Run Method Manually" se comunica con esta librería de dos formas:

• Canal por archivos (≥ 1.1.0, preferido): Initialize arranca un listener que vigila %TEMP%\DebugRunner\{pid}\cmd-*.json. La extensión escribe ahí el comando y el runner lo ejecuta en un hilo propio del proceso (thread pool), sin detener la aplicación y sin evaluación de expresiones del debugger. Los breakpoints dentro del método se detienen con normalidad.
• Evaluación de expresiones (fallback, < 1.1.0): la extensión evalúa DebugRunner.Runner.Run(...) vía dte.Debugger.GetExpression con el debugger en break mode.

En ambos casos todo el trabajo de DI ocurre dentro del proceso vivo.

Instalación

dotnet add package DebugRunner

Integración

Agrega una línea en tu Program.cs, después de builder.Build():

#if DEBUG
DebugRunner.Runner.Initialize(app.Services);
#endif

Uso

La extensión evalúa expresiones como estas dentro del proceso depurado:

DebugRunner.Runner.Run("MiApp.Services.UsuariosService", "ObtenerPorId", new string[] { "5", null })
DebugRunner.Runner.RunJob("MiApp.Jobs.ReporteJob", "{\"nombre\":\"x\"}")

Ambos métodos devuelven siempre un string JSON estructurado (nunca lanzan excepciones): { "success": true, "result": ..., "resultType": "..." } o { "success": false, "exceptionType": "...", "message": "...", "stackTrace": "..." }.

• Los argumentos van en JSON: primitivos crudos (123, true), strings/Guid/ DateTime/enums como JSON string ("abc", "Monday"), objetos complejos como JSON. Los CancellationToken se pasan siempre como None y los parámetros opcionales omitidos usan su valor por defecto.
• Si el tipo no está registrado en DI, se crea con ActivatorUtilities.
• Los métodos Task/Task<T>/ValueTask/ValueTask<T> se desenvuelven automáticamente.
• RunJob dispara jobs de Quartz.NET por reflexión (sin referenciar Quartz).