Partilhar via


Executar lint no código Python no Visual Studio

O processo de lint destaca problemas de sintaxe e estilo da linguagem no código-fonte Python. É possível executar um linter no código a fim de identificar e corrigir erros sutis de programação ou práticas de codificação não convencionais que possam gerar erros. O lint é capaz de detectar o uso de uma variável não inicializada ou indefinida, chamadas para funções indefinidas, ausência de parênteses e outros problemas sutis, como tentativas de redefinição de tipos ou funções internos. O lint é diferente da formatação porque analisa a forma como o código é executado e detecta erros, enquanto a formatação apenas reestrutura a forma como o código é exibido.

Duas opções comuns de lint incluem PyLint e MyPy. Essas ferramentas são amplamente usadas para verificar erros em código Python e incentivar bons padrões de codificação em Python. Ambas são integradas em projetos do Visual Studio para Python.

Pré-requisitos

  • Visual Studio. Para instalar o produto, siga as etapas em Instalar o Visual Studio.
  • Acesso a um projeto do Python para execução de ferramentas de lint em código existente.

Executar uma ferramenta de lint

As ferramentas de lint do Visual Studio estão disponíveis no Gerenciador de Soluções.

As etapas a seguir mostram como utilizar um linter para verificar o código.

  1. No Visual Studio, clique com o botão direito do mouse em um projeto do Python no Gerenciador de Soluções e escolha Python, depois selecione Executar PyLint ou Executar MyPy:

    Captura de tela mostrando os comandos de lint disponíveis para projetos Python no gerenciador de soluções.

    O comando solicita que você instale o linter escolhido no ambiente ativo, caso ainda não esteja presente.

  2. Após a execução do linter no código, analise todos os avisos e erros de lint na janela Lista de Erros:

    Captura de tela mostrando a lista de erros e avisos pylint do arquivo de código no Visual Studio.

  3. Clique duas vezes em um erro ou aviso para acessar o local do problema no código-fonte.

Configurar opções de linha de comando

O PyLint e o MyPy oferecem opções de linha de comando para definir as configurações de lint para seu projeto.

Esta seção mostra um exemplo que utiliza as opções de linha de comando do PyLint para controlar o comportamento do PyLint por meio de um arquivo de configuração .pylintrc. Esse arquivo pode ser colocado na raiz de um projeto do Python no Visual Studio ou em outra pasta, dependendo da abrangência desejada para aplicação das configurações.

As etapas a seguir suprimem os avisos "docstring ausente" (conforme mostrado na imagem anterior) usando um arquivo .pylintrc no projeto do Python.

  1. Na linha de comando, navegue até a pasta raiz do projeto que contém o arquivo .pyproj e execute o seguinte comando para gerar um arquivo de configuração comentado:

    pylint --generate-rcfile > .pylintrc
    
  2. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Adicionar>Item Existente.

  3. Na caixa de diálogo, acesse a pasta que contém o novo arquivo .pylintrc. Selecione o arquivo .pylintrc e Adicionar.

  4. No Gerenciador de Soluções, abra o arquivo .pylintrc para edição.

  5. Você pode definir diversas configurações no arquivo. Esse exemplo mostra como desativar um aviso.

    1. Encontre a seção [MESSAGES CONTROL], depois encontre a configuração disable dentro dessa seção.

      Captura de tela mostrando a configuração de desabilitação na seção CONTROLE DE MENSAGENS do arquivo pylintrc no Visual Studio.

      A configuração disable consiste em uma longa cadeia de mensagens específicas, à qual é possível acrescentar os avisos desejados.

    2. Anexe a cadeia ,missing-docstring (incluindo a vírgula) ao valor da configuração disable:

      Captura de tela mostrando como appender uma mensagem de aviso específica à configuração de desabilitação no arquivo pylintrc no Visual Studio.

  6. Salve o arquivo .pylintrc.

  7. Execute o PyLint novamente. Observe que os avisos de “docstring ausente” foram suprimidos.

Utilizar o arquivo pylintrc do compartilhamento de rede

É possível utilizar um arquivo .pylintrc de um compartilhamento de rede.

  1. Crie uma variável de ambiente chamada PYLINTRC.

  2. Atribua à variável o valor do nome de arquivo no compartilhamento de rede utilizando um caminho UNC ou uma letra de unidade mapeada. Por exemplo, PYLINTRC=\\myshare\python\.pylintrc.