Anúncios incomodam? Ir Sem anúncios Hoje 

Formatação de Código R (Styler / Estilo Tidyverse)

DesenvolvedorTexto

ANUNCIADO Remover?

ENTRADA

Processo Automático

SAÍDA

Lado cliente

ANUNCIADO Remover?

Guia

Formatação de Código R (Styler / Estilo Tidyverse)

Formata o código R conforme o estilo do tidyverse instantaneamente

O formatação de código R aplica convenções do tidyverse e do styler a qualquer script de R em seu navegador. Cole seu código e a ferramenta corrige os espaços ao redor <- das setas de atribuição, operadores de comparação e operadores de pipe como %>% e |>, indenta blocos aninhados e identifica qualquer linha que exceda o comprimento definido. Tudo é executado localmente no seu dispositivo, então seu código nunca sai da página.

Como usar

Cole seu código-fonte de R no área de entrada ou carregue um .R arquivo usando o seletor de arquivos.
Escolha a largura da indentação (2 espaços é o padrão do tidyverse; 4 espaços também é suportado).
Defina o comprimento máximo de linha para que a ferramenta possa identificar qualquer linha que ultrapasse o limite.
Ative ou desative se as atribuições de nível superior = devem ser reescritas para <- (os argumentos nomeados dentro de chamadas de função são sempre mantidos intocados).
Copie a saída formatada ou baixe como um .R arquivo.

Características

espaçamento tidyverse – Insere um espaço único em ambas as laterais dos operadores binários, operadores de comparação e pipes; mantém $, :: e @ aperto.
Largura da indentação configurável – Escolha 2 ou 4 espaços para blocos aninhados, corpos de funções e listas de argumentos multilinhas.
Detecção de linhas longas – Identifica todas as linhas que excedem o limite configurado (padrão é 80 caracteres).
Normalização de atribuições – Opicionalmente reescreve atribuições de nível superior = para <- sem tocar nos argumentos nomeados dentro de chamadas de função.
Verificação de sintaxe – Detecta parênteses, colchetes e chaves desbalanceados e strings não encerradas.
Segurança de comentários e strings – O tokenizer protege o texto de comentários, strings regulares, strings brutas (r"(...)") e identificadores entre aspas de backtick de serem reformateados.

Casos de uso comuns

Limpeza de scripts de R herdados de colaboradores ou gerados por ferramentas antigas.
Preparação de código para análise de dados ou aplicativos Shiny para revisão de código.
Normalização de trechos de código de tutoriais ou posts de blog antes de publicação.
Verificação rápida de blocos gerados dentro de Quarto, R Markdown ou notebooks do Jupyter.
Auditoria rápida de um script para linhas excessivamente longas antes de mesclar.

 Perguntas frequentes

O que é a guia de estilo do tidyverse?

A guia de estilo do tidyverse é um conjunto de convenções de codificação em R mantido pela comunidade, originalmente derivado das convenções do Google em R e refinado por Hadley Wickham. Ela estabelece regras de nomes, espaçamento, comprimento de linha, escolha do operador de atribuição e outras regras de formatação para que o código em R escrito por diferentes autores pareça e seja lido de forma consistente.
Por que o tidyverse prefere a seta de atribuição <- em vez de =?

O R suporta tanto <- quanto = para atribuição, mas eles se comportam de forma diferente em alguns contextos. O = também é usado para vincular argumentos nomeados de funções, o que pode tornar a leitura do código ambíguo sobre se uma identificação está sendo definida ou passada como parâmetro. A seta <- tem um único significado, o que torna a intenção mais clara e se alinha com as regras de parsing do R desde sua origem.
Qual a diferença entre %>% e |>?

%>% é o pipe magrittr, originalmente fornecido pelo pacote magrittr e popularizado pelo dplyr. |> é o pipe nativo do R adicionado na versão 4.1. Eles parecem semelhantes, mas %>% é uma chamada de função que suporta sintaxe de placeholder como . e pipe de atribuição %%, enquanto |> é uma reescrita leve no nível do parser, mais rápida e sem dependências externas. Ambos os pipes recebem um espaço em cada lado segundo as regras do tidyverse.
Por que 80 caracteres é o comprimento máximo convencional?

A convenção de 80 colunas data dos cartões de perfis e terminais antigos, mas persiste porque mantém o código legível em diferenças lado a lado, em telas pequenas de laptops e em materiais impressos. Muitos projetos relaxam isso para 100 ou 120 caracteres hoje, mas o tidyverse e o styler padronizam para 80 para manter compatibilidade com a maior variedade de editores e ferramentas de revisão.