Depurar scripts de Python en Visual Studio Code
En este apartado asumimos que tiene instalada una versión actual de Visual Studio Code (VS Code) con la extensión ms-python.python. Lea con detenimiento la guía oficial de configuraciones de Python en Visual Studio Code.
Tenga en cuenta que:
•Esta guía usa raptorxmlxbrl-python como comando para ejecutar RaptorXML+XBRL Server como intérprete de Python.
•El ejecutable raptorxmlxbrl-python está disponible en la carpeta bin de su carpeta de aplicación de RaptorXML+XBRL Server.
Resumen
A continuación explicamos dos métodos para usar VS Code para depurar scripts de Python en RaptorXML+XBRL Server.
•El método 1 también funciona con servidores y devoluciones de llamada Python con RaptorXML (--script option).
•El método 2 no necesita que modifique el código fuente. Se trata de una invocación modificada de RaptorXML. Este método no funciona con servidores ni devoluciones de llamada Python con RaptorXML (--script option).
•Los dos métodos funcionan con intérpretes Python estándar y el módulo Python de RaptorXML importado ('import altova_api.v2 as altova').
Método 1: cambiar el código fuente
Siga estos pasos:
1.Ejecute: raptorxml-python -m pip install --upgrade debugpy
2.Añada estas líneas a su código fuente Python:
python
import debugpy
debugpy.listen(5678)
debugpy.wait_for_client()
debugpy.breakpoint()
3.Copie esta configuración de lanzamiento en el archivo launch.json de VS Code (los valores predeterminados sirven para los valores anteriores) y selecciónela para ejecutar el comando Run.
json5
{
"name": "Python: Remote Attach",
"type": "python",
"request": "attach",
"connect": {
"host": "localhost",
"port": 5678
},
"pathMappings": [
{
"localRoot": "${workspaceFolder}",
"remoteRoot": "."
}
]
}
También puede llevar a cabo la ejecución con el comando de menú Run->Add Configuration...->Python->Remote Attach con los valores predeterminados aceptados.
4.Ejecute su script de Python (o RaptorXML con devoluciones de llamada --script) normalmente.
5.Empiece a depurar (por lo general con la tecla de acceso rápido F5).
Método 2: usar una línea de comandos modificada
Siga estos pasos:
1.Añada una configuración de lanzamiento (como en el método 1) y selecciónela para ejecutar el comando Run.
2.Añada un punto de interrupción a su script de Python.
3.Ejecute el comando: raptorxml-python -m debugpy --listen 0.0.0.0:5678 --wait-for-client your-script-.py
4.Empiece a depurar (por lo general con la tecla de acceso rápido F5).
Nota: la depuración también funciona con contenedores y servidores remotos. Tiene que cambiar la clave host de la entrada connect en la configuración de lanzamiento. También puede usar otros puertos, siempre que el código o la línea de comandos y launch.json tengan los mismos valores.
Configurar raptorxml-python.exe como intérprete predeterminado para VS Code
Puede configurar raptorxml-python.exe como intérprete Python predeterminado para VS Code. Para ello añada este fragmento de código a su archivo settigs.json de VS Code:
json
"python.defaultInterpreterPath": "/path/to/raptorxml-python.exe"
...
En este caso también es posible usar una configuración de lanzamiento "Archivo actual" que inicie el script de depuración. Consulte la documentación oficial de VS Code para más detalles.