format_config.md

TDS: Formatação de Código Fonte

Requisitos

• formatação ativada

Configuração

Por padrão, a formatação de código fonte vem desligado. Para ligá-lo acesse File | Preferences | Settings e localize 4gl ou advpl, conforme a linguagem de programação que deseja configurar.

Lhe será apresentado algo semelhante a:

Saiba mais sobre precedência de configurações em User and Workspace Settings.

O bloco [4gl] (ou [advpl]), são configurações ligadas a ativação dos processos pelo VS-Code associadas ao editor da linguagem e 4gl.formatter (ou advpl.formatter), são as opções de formatação propriamente.

Para sobrescrever os valores padrão, acione Edit in settings.json ou Add item, informando os valores solicitados.

Saiba mais em Formatting e Indentation.

Configurações [4gl] ou [advpl]

A formatação para AdvPL está parcialmente implementada.

• "files.encoding": "windows1252" | "windows1251"

  Indica a codificação dos arquivos com código fonte. A codificação 1251 deve ser utilizada em fontes com strings no alfabeto cirílico.

• "editor.formatOnType": true | false

  Habilita a formatação durante a digitação.

• "editor.formatOnPaste": true | false

  Habilita a formatação em blocos colados.

• "editor.formatOnSave": true | false

  Habilita a formatação ao salvar o arquivo.

• "editor.formatOnSaveMode": "*file*" | "modifications"

  Indica o modo de formatação ao salvar o arquivo.

• "editor.insertSpaces": auto | false | true

  Controla se o editor irá inserir espaços para tabulações. Se definido como auto, o valor será calculado com base no arquivo aberto.

• "editor.tabSize": auto | number

  Controla o tamanho de renderização da tabulação. Se definido como auto, o valor será calculado com base no arquivo aberto.

• "files.trimTrailingWhitespace": false | true

  Habilita a remoção de caracteres não significativos ao final da linha.

Configurações 4gl.formatter ou advpl.formatter

Veja Prettier 4GL Plugin para detalhes sobre as opções.

Exemplo com os valores padrão

Arquivo settings.json

{
  ...,
  "[4gl]": {
    "files.encoding": "windows1252",
    "editor.formatOnType": false,
    "editor.formatOnPaste": false,
    "editor.formatOnSave": false,
    "editor.formatOnSaveMode": "file",
    "editor.tabSize": 4,
    "editor.insertSpaces": false,
    "files.trimTrailingWhitespace": false,
  },
  "4gl.formatter": {
    "keywordsCase": "upper",
    "stringStyle": "ignore",
    "formatNumber": false,
    "operatorSpacing": false
  }
  ...,
}