Melhorar mensagem enviada para Telegram com erro encontrado em arquivo .po pelo linter #294

Activity

1. rffontenelle commented on Apr 5, 2026

   

   rffontenelle

   on Apr 5, 2026

   Collaborator

   More actions

   Atualmente, quando o linter encontra um erro no .po, é enviada uma mensagem para o Telegram semelhante a essa

   

   O problema disso é que a linha 1280, deste exemplo, do arquivo não é encontrável pelo Transifex.

   De fato, ao executar sphinx-lint com um PO, ele retorna a primeira linha do conjunto específico de localização fonte (#:), mensagem fonte (msgid) e mensagem traduzida (msgstr). Isso é diferente da execução com um arquivo reST, que retorna a linha do arquivo reST.

   Então, seria útil que nessa mensagem viesse a URL para a linha no repositório. No caso, seria

   https://github.com/python/python-docs-pt-br/blob/3.14/library/string.po#L1280

   Ou com o link permanente:

   python-docs-pt-br/library/string.po

   Line 1280 in 3dfcdb8

   ">>> '{0}, {1}, {2}'.format('a', 'b', 'c')\n"

   Possível. O ideal seria que o sphinx-lint retornasse essa referência de local e linha fonte do reST quando executado contra um arquivo PO.

   Mas podemos implementar algo localmente: tratar as informações de nome de arquivo e linha informado exatamente na saída do sphinx-lint, e dá construir outra saída informando a referência à linha específica para uso no occurrence: do Transifex.

   Adicionalmente, talvez ficasse mais claro se a mensagem/link fosse para a linha com a msgstr e não a msgid. E talvez com mais algum texto explicativo.

   Tecnicamente possível, um pouco mais trabalhoso, mas acho que não tão eficiente do que ter a referência ao arquivo-fonte e linha para usar no occurrence: do Transifex.

   Adicionalmente 2, enviar um URL para pesquisar no TX por uma strings com o texto da string alvo. Para o exemplo seria:

   https://app.transifex.com/python-doc/python-newest/translate/#pt_BR/library--string/592013921?q=text%3A'%3E%3E%3E%20\'{0}%2C%20{1}%2C%20{2}\'.format(\'a\'%2C%20\'b\'%2C%20\'c\')'

   Note que foi necessário remover o \n da URL.

   Usar um link com occurrence para a linha seria mais limpo. Por exemplo, para occurrence:662 ficaria:

   https://app.transifex.com/python-doc/python-newest/translate/#pt_BR/library--string?q=occurrence%3A662

   No entanto, mensagens do Telegram têm um limite de 4096 caracteres. Dependendo da quantidade de ocorrências, a GitHub Action que usamos para envio da notificação simplesmente falha por a mensagem ser grande demais. Isso teria que ser contornado implementando um envio de mensagem francionando-a no limite antes de enviar.
2. python

   deleted a comment from jaudelogarcia735-png on Aug 2, 2026