Como desabilito um aviso do Pylint?

Estou tentando desativar o aviso C0321 ("mais de uma instrução em uma única linha" - geralmente coloco ifinstruções com resultados curtos de uma linha na mesma linha), no Pylint 0.21.1 (se isso importa: somando 0,20. 1, comum 0.50.3, Python 2.6.6 (r266: 84292, 15 de setembro de 2010, 16:22:56).

Tentei adicionar disable=C0321o arquivo de configuração do Pylint, mas o Pylint insiste em denunciá-lo de qualquer maneira. Variações sobre essa linha (como disable=0321ou disable=C321) são sinalizadas como erros, então pylint faz reconhecer a opção adequada, é apenas ignorá-lo.

Isso é um bug do Pylint ou estou fazendo algo errado? Existe alguma maneira de contornar isso? Eu realmente gostaria de me livrar desse barulho.

pylint --generate-rcfile mostra assim:

[MESSAGES CONTROL]

# Enable the message, report, category or checker with the given id(s). You can
# either give multiple identifier separated by comma (,) or put this option
# multiple time.
#enable=

# Disable the message, report, category or checker with the given id(s). You
# can either give multiple identifier separated by comma (,) or put this option
# multiple time (only on the command line, not in the configuration file where
# it should appear only once).
#disable=

Portanto, parece que você ~/.pylintrcdeve ter as disable=linhas dentro de uma seção [MESSAGES CONTROL].

Eu tive esse problema usando o Eclipse e resolvi-o da seguinte maneira:

na pasta pylint (por exemplo C:\Python26\Lib\site-packages\pylint), mantenha pressionada a tecla Shift, clique com o botão direito do mouse e escolha abrir o comando do Windows nessa pasta. Tipo:

lint.py --generate-rcfile > standard.rc

Isso cria o standard.rcarquivo de configuração. Abra-o no bloco de notas e em [MESSAGES CONTROL], remova o comentário disable=e adicione os IDs da mensagem que deseja desativar, por exemplo:

disable=W0511, C0321

Salve o arquivo e, em Eclipse-> janela-> preferências-> PyDev-> pylint, na caixa de argumentos, digite:

--rcfile=C:\Python26\Lib\site-packages\pylint\standard.rc

Agora deve funcionar ...

Você também pode adicionar um comentário na parte superior do seu código que será interpretado pelo pylint:

# pylint: disable=C0321

link para todos os códigos de mensagem pylint

Adicionar, por exemplo, --disable-ids=C0321na caixa de argumentos não funciona. Todas as mensagens pylint disponíveis são armazenadas no dicionário _messages, um atributo de uma instância da pylint.utils.MessagesHandlerMixInclasse. Ao executar o pylint com o argumento --disable-ids=...(pelo menos sem um arquivo de configuração), este dicionário está inicialmente vazio, gerando uma exceção KeyError no pylint ( pylint.utils.MessagesHandlerMixIn.check_message_id(). No Eclipse, você pode ver esta mensagem de erro no Pylint Console (windows - show view - Console , selecione console do Pylint nas opções do console, além do ícone do console.)

A partir do Pylint v. 0.25.3, é possível usar os nomes simbólicos para desativar avisos em vez de ter que lembrar todos esses números de código . Por exemplo:

# pylint: disable=locally-disabled, multiple-statements, fixme, line-too-long

Esse estilo é mais instrutivo que os códigos de erro enigmático e também mais prático, pois as versões mais recentes do Pylint apenas emitem o nome simbólico, não o código de erro.

A correspondência entre nomes e códigos simbólicos pode ser encontrada aqui .

Um comentário de desativação pode ser inserido em sua própria linha, aplicando a desativação a tudo o que vem depois no mesmo bloco. Como alternativa, ele pode ser inserido no final da linha para a qual se destina a ser aplicado.

Se o pylint emitir " Locally disabling" mensagens, você pode se livrar delas incluindo a desativação locally-disabled primeiro, como no exemplo acima.

Para desativar um aviso localmente em um bloco, adicione

# pylint: disable=C0321

para esse bloco.

Existem várias maneiras de desativar avisos e erros do Pylint. Qual deles usar tem a ver com o quão global ou localmente você deseja aplicar a desativação - uma importante decisão de design.

Várias abordagens

1. Em um ou mais pylintrcarquivos.

Isso envolve mais do que o ~/.pylintrcarquivo (no diretório $ HOME), conforme descrito por Chris Morgan. O Pylint procurará arquivos rc, com uma precedência que valorize os arquivos "mais próximos" mais altamente:

• Um pylintrcarquivo no diretório de trabalho atual; ou

• Se o diretório de trabalho atual estiver em um módulo Python (ou seja, ele contém um __init__.pyarquivo), procure na hierarquia dos módulos Python até que um pylintrcarquivo seja encontrado; ou

• O arquivo nomeado pela variável de ambiente PYLINTRC; ou

• Se você possui um diretório inicial que não é /root:

  • ~/.pylintrc; ou

  • ~/.config/pylintrc; ou

  • /etc/pylintrc

Observe que a maioria desses arquivos é nomeada pylintrc- apenas o arquivo ~possui um ponto inicial.

No seu pylintrcarquivo, adicione linhas para desativar mensagens específicas de pilões. Por exemplo:

[MESSAGES CONTROL]
disable=locally-disabled

2. Desativa ainda mais a partir da pylintlinha de comando, conforme descrito por Aboo e Cairnarvon. Isso parece pylint --disable=bad-builtin. Repita --disablepara suprimir itens adicionais.

3. Desativa ainda mais as linhas de código Python individuais, conforme descrito por Imolit. Eles se parecem com some statement # pylint: disable=broad-except(comentário extra no final da linha de origem original) e se aplicam apenas à linha atual . Minha abordagem é sempre colocá-las no final de outras linhas de código para que não sejam confundidas com o estilo do bloco, veja abaixo.

4. Desativa ainda mais definido para blocos maiores de código Python, até completar os arquivos de origem.

   • Eles se parecem # pragma pylint: disable=bad-whitespace(observe a pragmapalavra-chave).

   • Isso se aplica a todas as linhas após o pragma. Colocar um bloco no topo de um arquivo faz com que as supressões se apliquem a todo o arquivo. Colocar o mesmo bloco mais baixo no arquivo os aplica apenas às linhas que seguem o bloco. Minha abordagem é sempre colocá-los em uma linha própria, para que não sejam confundidos com o estilo de linha única, veja acima.

   • Quando uma supressão deve ser aplicada apenas dentro de um intervalo de código, use # pragma pylint: enable=bad-whitespace(agora usando enablenão disable) para interromper a supressão.

Observe que a desativação de uma única linha usa a # pylintsintaxe, enquanto a desativação dessa linha em diante usa a # pragma pylintsintaxe. Estes são fáceis de confundir, especialmente ao copiar e colar.

Juntando tudo

Eu costumo usar uma mistura dessas abordagens.

• Eu uso ~/.pylintrcpara padrões absolutamente globais - muito poucos deles.

• Uso o nível do projeto pylintrcem diferentes níveis nos módulos Python quando existem padrões específicos do projeto. Especialmente quando você recebe o código de outra pessoa ou equipe, pode achar que eles usam convenções que você não prefere, mas não deseja refazer o código. Manter as configurações nesse nível ajuda a não espalhar essas práticas para outros projetos.

• Eu uso os pragmas de estilo de bloco na parte superior dos arquivos de origem únicos. Gosto de desativar os pragmas (pare de suprimir as mensagens) no calor do desenvolvimento, mesmo para os padrões Pylint com os quais não concordo (como "muito poucos métodos públicos" - sempre recebo esse aviso nas classes Exception personalizadas) - mas é útil ver mais / talvez todas as mensagens Pylint enquanto você está desenvolvendo. Dessa forma, você pode encontrar os casos que deseja resolver com pragmas de linha única (veja abaixo) ou apenas adicionar comentários ao próximo desenvolvedor para explicar por que esse aviso está correto neste caso.

• Deixo alguns pragmas em estilo de bloco ativados mesmo quando o código está pronto para o check-in. Tento usar alguns deles, mas quando faz sentido para o módulo, não há problema em fazer isso como documentação. No entanto, tento deixar o mínimo possível, de preferência nenhum.

• Eu uso o estilo de comentário de linha única para solucionar erros especialmente potentes. Por exemplo, se há um lugar onde realmente faz sentido except Exception as exc, eu coloco a # pylint: disable=broad-exceptlinha nessa linha, em vez de uma abordagem mais global, porque essa é uma exceção estranha e precisa ser destacada, basicamente como uma forma de documentação.

Como tudo no Python, você pode agir em diferentes níveis de indireção. Meu conselho é pensar no que pertence a qual nível, para que você não tenha uma abordagem muito branda ao Pylint.

Você também pode usar o seguinte comando:

pylint --disable=C0321  test.py

Minha versão pylint é 0.25.1.

Esta é uma FAQ :

4.1 É possível desativar localmente uma mensagem específica?

Sim, esse recurso foi adicionado no Pylint 0.11. Isso pode ser feito adicionando
# pylint: disable=some-message,another-oneno nível de bloco desejado ou no final da linha de código desejada.

4.2 Existe uma maneira de desativar uma mensagem apenas para um módulo específico?

Sim, você pode desativar ou ativar mensagens (desativadas globalmente) no nível do módulo adicionando a opção correspondente em um comentário na parte superior do arquivo:

# pylint: disable=wildcard-import, method-hidden
# pylint: enable=too-many-lines

Você pode desativar as mensagens:

• numérica ID: E1101, E1102etc.
• mensagem simbólica: no-member, undefined-variableetc.
• o nome de um grupo de verificações. Você pode pegar aqueles com pylint --list-groups.
• categoria de cheques: C, R, W, etc.
• todos os cheques com all.

Veja os documentos (ou execute pylint --list-msgsno terminal) para obter a lista completa de pylintmensagens. Os documentos também fornecem um bom exemplo de como usar esse recurso.

Você só precisa adicionar uma linha para desativar o que deseja desativar. Por exemplo

#pylint: disable = line-too-long, too-many-lines, no-name-in-module, import-error, multiple-imports, pointless-string-statement, wrong-import-order

Adicione isso no nº 1 do seu módulo

Caso isso ajude alguém, se você estiver usando o Visual Studio Code, espera que o arquivo esteja na codificação UTF8. Para gerar o arquivo, executei pylint --generate-rcfile | out-file -encoding utf8 .pylintrcno PowerShell.

De acordo com a documentação do pylint , o mais fácil é usar este gráfico :

• Verificações relacionadas à convenção C
• R verificações relacionadas à refatoração
• W vários avisos
• Erros E, para prováveis ​​erros no código
• F fatal, se ocorrer um erro que impeça o pylint de continuar o processamento.

Então, pode-se usar:

pylint -j 0 --disable=I,E,R,W,C,F YOUR_FILES_LOC

A sintaxe do Python permite mais de uma instrução em uma linha, separada por ponto e vírgula (;). No entanto, limitar cada linha a uma instrução torna mais fácil para um ser humano seguir a lógica de um programa ao lê-la.

Portanto, outra maneira de resolver esse problema é entender por que a mensagem do fiapo existe e não colocar mais de uma declaração em uma linha.

Sim, você pode achar mais fácil escrever várias instruções por linha; no entanto, o pylint é para todos os outros leitores do seu código, não apenas para você.

Você pode tentar o seguinte:

Edite "C: \ Usuários \ Seu Usuário \ AppData \ Roaming \ Código \ Usuário \ settings.json" e adicione python.linting.pylintArgslinhas no final, como mostrado abaixo:

{
    "team.showWelcomeMessage": false,
    "python.dataScience.sendSelectionToInteractiveWindow": true,
    "git.enableSmartCommit": true,
    "powershell.codeFormatting.useCorrectCasing": true,
    "files.autoSave": "onWindowChange",
    "python.linting.pylintArgs": [
        "--load-plugins=pylint_django",
        "--errors-only"
    ],
}