PL/SQL & SQL Formatter (Trivadis)

Extensión "wrapper" que invoca tvdformat.jar (o SQLcl) como proceso externo para formatear PL/SQL/SQL con las reglas de Trivadis. No incluye ni redistribuye ningún artefacto de Oracle — el usuario configura la ruta a su propia instalación.

Requisitos previos (a cargo del usuario)

1. JDK 17+ instalado.
2. tvdformat.jar, descargado desde los releases de plsql-formatter-settings (o compilado localmente), o una instalación de Oracle SQLcl si prefieres useSqlcl: true.
3. El archivo xml y arbori se puede descargar directo desde XML y Arbori

Configuración mínima

{
  "plsqlFormatter.jarPath": "C:/tools/tvdformat.jar",
  "plsqlFormatter.profiles": [
    {
      "name": "Trivadis Default",
      "xmlPath": "C:/tools/trivadis_advanced_format.xml",
      "arboriPath": "C:/tools/trivadis_custom_format.arbori"
    }
  ],
  "plsqlFormatter.activeProfile": "Trivadis Default"
}

Ejecuta el comando PL/SQL Formatter: Verify Setup para comprobar que todo está bien configurado.

Ajustar reglas de estilo sin editar el XML a mano

{
  "plsqlFormatter.rules.keywordCase": "upper",
  "plsqlFormatter.rules.identifierCase": "lower",
  "plsqlFormatter.rules.useTab": false,
  "plsqlFormatter.rules.indentSize": 4,
  "plsqlFormatter.rules.commaBreak": "before"
}

Estos overrides se aplican sobre una copia temporal del XML del perfil activo en cada formateo — el archivo original no se modifica. Requiere que el perfil activo tenga un xmlPath a un archivo real (no "default").

Para claves del XML no cubiertas por un setting dedicado, usa el override libre:

{
  "plsqlFormatter.rules.raw": {
    "flowControl": "oracle.dbtools.app.Format.FlowControl.IndentedActions"
  }
}

Convivencia con "Oracle SQL Developer for VSCode"

Ambas extensiones pueden estar instaladas a la vez. VS Code permite elegir, por lenguaje, qué formateador usar por defecto:

{
  "[oracle-sql]": {
    "editor.defaultFormatter": "tu-publisher.plsql-trivadis-formatter"
  }
}

También puedes elegir puntualmente con el comando "Format Document With...", que muestra un selector con todos los formateadores registrados para el archivo activo.

Nota sobre licencias

Esta extensión no descarga ni empaqueta tvdformat.jar, dbtools-common.jar ni ningún componente de SQLcl/SQL Developer. Es responsabilidad del usuario obtenerlos directamente de Oracle / del repositorio de plsql-formatter-settings bajo sus respectivas licencias.