DEV Community: pyrtugues

Criando um dragão em Pyrtugues

pyrtugues — Sun, 11 Oct 2026 19:42:42 +0000

Criando um dragão que segue o mouse com Pyrtugues e Pygame 🐉

Já imaginou criar um jogo usando comandos de programação em português?

Neste tutorial, vamos criar um pequeno projeto gráfico com Pyrtugues e Pygame: um dragão esmeralda que segue o mouse, com corpo sinuoso, asas roxas, chifres dourados e olhos brilhantes. ✨

A ideia é aprender programação fazendo algo visual, sem depender de imagens prontas. O dragão será desenhado usando formas geométricas, cores e coordenadas.

🐍 O que é o Pyrtugues?

O Pyrtugues é um projeto educacional de programação baseado na lógica do Python. Ele permite escrever código com comandos em português e traduzi-lo para Python.

Por exemplo:

mostrar("Olá, mundo!")

É traduzido para:

print("Olá, mundo!")

Isso permite aprender conceitos de programação em português enquanto você acompanha como eles aparecem no Python.

🎮 O que vamos criar?

Nosso projeto terá:

Um dragão verde com detalhes brilhantes.
Um corpo que acompanha o caminho percorrido pelo mouse.
Asas roxas e espinhos ao longo do corpo.
Olhos dourados e chifres.
Um céu escuro com estrelas.
Um controle simples para fechar a janela.

Tudo será desenhado pelo Pygame, então não precisamos baixar sprites ou imagens externas.

🛠️ Antes de começar

Este exemplo é voltado à versão Desktop do Pyrtugues, utilizando a integração com Pygame.

Você pode encontrar o código-fonte e as instruções de instalação no repositório oficial do Pyrtugues.

A disponibilidade dos recursos pode variar conforme a versão do tradutor e o ambiente. O exemplo utiliza os aliases de Pygame documentados no código do projeto.

💻 Código completo

Crie um arquivo de código no Pyrtugues Desktop e experimente o seguinte exemplo:

importar jogo

jogo.iniciar()

janela = jogo.display.criar_janela((1000, 700))
jogo.display.definir_título("Dragão Esmeralda — Pyrtugues")

relogio = jogo.tempo.relógio()

x, y = jogo.mouse.posição()

# Criamos os pontos iniciais do corpo.
rastro = []

para i em intervalo(130):
    rastro.adicionar((x - i * 3, y))

# Estrelas fixas no fundo.
estrelas = [
    (38, 45), (120, 90), (210, 55), (310, 120),
    (430, 65), (540, 100), (650, 45), (750, 115),
    (870, 70), (960, 140), (80, 220), (190, 300),
    (340, 250), (500, 190), (680, 280), (820, 220),
    (930, 350), (100, 460), (260, 520), (430, 610),
    (600, 520), (770, 600), (900, 500), (970, 610)
]

executando = verdadeiro

enquanto executando:

    # Verificamos os eventos da janela.
    para evento em jogo.eventos.obter():

        se evento.type == jogo.sair_evento:
            executando = falso

        se evento.type == jogo.tecla_pressionada_evento e evento.key == jogo.esc:
            executando = falso

    # Posição atual do mouse.
    x, y = jogo.mouse.posição()

    # Adicionamos posições ao rastro quando o mouse se move.
    antigo_x, antigo_y = rastro[0]

    dx = x - antigo_x
    dy = y - antigo_y

    se dx * dx + dy * dy >= 9:
        rastro.inserir(0, (x, y))
        rastro = rastro[:130]

    # Fundo noturno.
    janela.preencher((8, 12, 29))

    # Estrelas do cenário.
    para estrela em estrelas:
        jogo.desenho.círculo(
            janela,
            (100, 160, 210),
            estrela,
            2
        )

    # Desenhamos as asas atrás do corpo.
    asa_x, asa_y = rastro[18]

    # Asa superior: contorno e membrana.
    jogo.desenho.polígono(
        janela,
        (7, 22, 45),
        [
            (asa_x, asa_y),
            (asa_x - 14, asa_y - 19),
            (asa_x - 38, asa_y - 49),
            (asa_x - 36, asa_y - 17),
            (asa_x - 55, asa_y - 29),
            (asa_x - 38, asa_y + 2),
            (asa_x - 10, asa_y + 8)
        ]
    )

    jogo.desenho.polígono(
        janela,
        (116, 64, 184),
        [
            (asa_x - 5, asa_y - 3),
            (asa_x - 14, asa_y - 19),
            (asa_x - 34, asa_y - 39),
            (asa_x - 31, asa_y - 14),
            (asa_x - 46, asa_y - 21),
            (asa_x - 32, asa_y + 1)
        ]
    )

    # Asa inferior.
    jogo.desenho.polígono(
        janela,
        (7, 22, 45),
        [
            (asa_x, asa_y),
            (asa_x - 14, asa_y + 19),
            (asa_x - 38, asa_y + 49),
            (asa_x - 36, asa_y + 17),
            (asa_x - 55, asa_y + 29),
            (asa_x - 38, asa_y - 2),
            (asa_x - 10, asa_y - 8)
        ]
    )

    jogo.desenho.polígono(
        janela,
        (91, 49, 157),
        [
            (asa_x - 5, asa_y + 3),
            (asa_x - 14, asa_y + 19),
            (asa_x - 34, asa_y + 39),
            (asa_x - 31, asa_y + 14),
            (asa_x - 46, asa_y + 21),
            (asa_x - 32, asa_y - 1)
        ]
    )

    # Corpo sinuoso: desenhamos da cauda até a cabeça.
    # A largura aumenta conforme nos aproximamos da cabeça.
    para i em intervalo(120, 0, -1):

        corpo_x, corpo_y = rastro[i]
        proximo_x, proximo_y = rastro[i - 1]

        largura = 8 + (120 - i) // 5

        # Contorno escuro.
        jogo.desenho.linha(
            janela,
            (5, 31, 43),
            (corpo_x, corpo_y),
            (proximo_x, proximo_y),
            largura + 8
        )

        # Corpo esmeralda.
        jogo.desenho.linha(
            janela,
            (25, 170, 112),
            (corpo_x, corpo_y),
            (proximo_x, proximo_y),
            largura
        )

        # Reflexo verde-claro.
        jogo.desenho.linha(
            janela,
            (108, 255, 192),
            (corpo_x, corpo_y),
            (proximo_x, proximo_y),
            2
        )

    # Escamas brilhantes.
    para i em intervalo(10, 112, 10):

        escama_x, escama_y = rastro[i]

        jogo.desenho.círculo(
            janela,
            (153, 255, 192),
            (escama_x, escama_y - 6),
            3
        )

        jogo.desenho.círculo(
            janela,
            (231, 244, 153),
            (escama_x, escama_y - 6),
            1
        )

    # Espinhos ao longo das costas.
    para i em intervalo(20, 110, 18):

        espinho_x, espinho_y = rastro[i]

        jogo.desenho.polígono(
            janela,
            (5, 52, 54),
            [
                (espinho_x, espinho_y - 20),
                (espinho_x - 9, espinho_y - 2),
                (espinho_x + 9, espinho_y - 2)
            ]
        )

        jogo.desenho.polígono(
            janela,
            (93, 255, 165),
            [
                (espinho_x, espinho_y - 15),
                (espinho_x - 5, espinho_y - 4),
                (espinho_x + 5, espinho_y - 4)
            ]
        )

    # Pequenas partículas mágicas pelo caminho.
    para i em intervalo(8, 100, 23):

        brilho_x, brilho_y = rastro[i]

        jogo.desenho.círculo(
            janela,
            (100, 255, 230),
            (brilho_x, brilho_y + 13),
            2
        )

    # Cabeça: base escura.
    jogo.desenho.círculo(
        janela,
        (5, 28, 37),
        (x - 2, y - 1),
        24
    )

    # Formato externo da cabeça.
    jogo.desenho.polígono(
        janela,
        (5, 36, 43),
        [
            (x - 22, y - 14),
            (x - 8, y - 23),
            (x + 13, y - 18),
            (x + 24, y - 8),
            (x + 37, y - 5),
            (x + 30, y + 7),
            (x + 12, y + 10),
            (x - 10, y + 7),
            (x - 22, y + 3)
        ]
    )

    # Cor principal da cabeça.
    jogo.desenho.polígono(
        janela,
        (38, 205, 125),
        [
            (x - 17, y - 12),
            (x - 7, y - 18),
            (x + 11, y - 14),
            (x + 20, y - 7),
            (x + 31, y - 5),
            (x + 25, y + 2),
            (x + 10, y + 5),
            (x - 8, y + 4),
            (x - 17, y)
        ]
    )

    # Chifres dourados.
    jogo.desenho.polígono(
        janela,
        (239, 191, 81),
        [
            (x - 15, y - 15),
            (x - 23, y - 34),
            (x - 5, y - 20)
        ]
    )

    jogo.desenho.polígono(
        janela,
        (255, 224, 130),
        [
            (x - 13, y - 19),
            (x - 20, y - 30),
            (x - 9, y - 21)
        ]
    )

    jogo.desenho.polígono(
        janela,
        (239, 191, 81),
        [
            (x - 4, y - 17),
            (x + 2, y - 35),
            (x + 8, y - 15)
        ]
    )

    # Olho dourado e pupila.
    jogo.desenho.círculo(
        janela,
        (255, 221, 110),
        (x + 10, y - 10),
        6
    )

    jogo.desenho.círculo(
        janela,
        (12, 25, 32),
        (x + 12, y - 10),
        3
    )

    jogo.desenho.círculo(
        janela,
        (255, 255, 255),
        (x + 11, y - 12),
        1
    )

    # Narinas e boca.
    jogo.desenho.círculo(
        janela,
        (5, 52, 48),
        (x + 25, y - 5),
        2
    )

    jogo.desenho.círculo(
        janela,
        (5, 52, 48),
        (x + 30, y - 3),
        2
    )

    jogo.desenho.linha(
        janela,
        (5, 52, 48),
        (x + 12, y + 5),
        (x + 27, y + 4),
        3
    )

    # Mantém a animação fluida.
    relogio.marcar_fps(60)

    jogo.display.atualizar_tela()

jogo.sair()

🧠 Como o dragão segue o mouse?

A parte mais importante é o rastro.

se dx * dx + dy * dy >= 9:
    rastro.inserir(0, (x, y))
    rastro = rastro[:130]

Cada vez que o mouse se desloca o suficiente, guardamos a nova posição no começo da lista. As posições antigas continuam atrás dela.

Depois, o código desenha linhas entre esses pontos. Como o corpo é desenhado da cauda para a cabeça, podemos aumentar sua largura conforme nos aproximamos do cursor.

É isso que cria a sensação de um dragão serpentino acompanhando o movimento, em vez de uma figura estática que apenas muda de posição.

🐍 O que o Pyrtugues traduz?

O código usa aliases documentados no projeto para operações do Pygame. Por exemplo:

Pyrtugues	Pygame
`jogo.iniciar()`	`pygame.init()`
`jogo.display.criar_janela()`	`pygame.display.set_mode()`
`jogo.mouse.posição()`	`pygame.mouse.get_pos()`
`jogo.desenho.círculo()`	`pygame.draw.circle()`
`jogo.desenho.linha()`	`pygame.draw.line()`
`jogo.display.atualizar_tela()`	`pygame.display.flip()`

O objetivo é manter a lógica de programação próxima do Python, permitindo escrever comandos em português e observar suas correspondências.

Você pode consultar os aliases e a implementação na documentação e no código do Pyrtugues.

🚀 Ideias para continuar

Agora que temos o dragão seguindo o mouse, existem várias formas de evoluir o projeto:

Fazer as asas baterem durante o movimento.
Adicionar partículas de fogo pela boca.
Criar obstáculos e colisões.
Fazer o dragão perseguir um objeto.
Adicionar sons e música.
Criar pontos e uma pontuação.

Cada melhoria pode ensinar um novo conceito, como animação, eventos, condições, colisões ou controle de tempo.

📚 Conheça o Pyrtugues

🐙 GitHub: https://github.com/pyrtugues/Pyrtugues

🌐 Site de apresentação: https://pyrtugues-apre.pages.dev/

📚 Curso: https://pyrtugues.pages.dev/

💻 Editor Web: https://pyrtugues-editor.pages.dev/

🧩 Extensão para VS Code: https://open-vsx.org/extension/pyrtugues/pyrtugues

O Pyrtugues é um projeto educacional em evolução. Consulte a documentação e a licença oficial antes de utilizar o projeto.

Programar não precisa começar com uma barreira de idioma. Você pode começar com uma ideia, transformá-la em código e aprender cada vez mais enquanto constrói.

Qual criatura você criaria com Pyrtugues? 🐉💚

python #pygame #beginners #programming

Pyrtugues vs Portugol: qual é a melhor opção em português para aprender Python?

pyrtugues — Sun, 04 Oct 2026 21:17:26 +0000

Pyrtugues vs Portugol: qual é a melhor opção em português para aprender Python?

Existem várias iniciativas de programação em português no Brasil. Cada uma tenta resolver um problema importante: reduzir a barreira do inglês no primeiro contato com programação.

Mas elas fazem isso de formas bem diferentes.

Algumas focam em lógica e pseudocódigo. Outras criam linguagens próprias. E algumas tentam manter uma relação mais próxima de linguagens já utilizadas no mercado.

Neste post, vou comparar Portugol / Visualg, Delégua, Pituguês e Pyrtugues e mostrar por que o Pyrtugues tem uma proposta diferente para quem quer aprender programação em português e chegar ao Python.

🎯 O problema comum

Quando alguém começa a programar, normalmente precisa lidar com vários desafios ao mesmo tempo:

Lógica de programação
Sintaxe e estrutura
Conceitos abstratos, como variáveis e funções
Vocabulário técnico em inglês

O quarto item pode ser uma barreira desnecessária para quem ainda está aprendendo os conceitos básicos.

Por exemplo:

if idade >= 18:
    print("Maior de idade")

Para alguém que nunca programou, existem duas coisas diferentes para entender:

o que o programa está fazendo;
o que if e print significam.

É justamente nesse ponto que entram as linguagens de programação em português.

Mas cada projeto escolhe uma estratégia diferente.

📚 As principais opções

🇧🇷 Portugol / Visualg

O que é: uma abordagem baseada em pseudocódigo estruturado, muito utilizada no ensino de lógica de programação no Brasil.

Exemplo:

algoritmo "soma"
var
   a, b, resultado: inteiro
inicio
   escreva("Digite o primeiro número: ")
   leia(a)

   escreva("Digite o segundo número: ")
   leia(b)

   resultado <- a + b

   escreva("A soma é: ", resultado)
fim

Pontos fortes

✅ Excelente para aprender lógica
✅ Muito utilizado no ensino
✅ Sintaxe em português
✅ Boa introdução a algoritmos

E a relação com Python?

O principal ponto é que o Portugol possui uma sintaxe própria.

Ao migrar para Python, o estudante precisa aprender uma nova estrutura.

Por exemplo:

se idade >= 18 entao

Em Python:

if idade >= 18:

Isso não significa que Portugol seja ruim.

Significa apenas que a proposta é diferente.

🇧🇷 Delégua

O que é: uma linguagem de programação criada para oferecer uma experiência de programação em português, com foco educacional e um ecossistema próprio.

Pontos fortes

✅ Sintaxe em português
✅ Linguagem própria
✅ Projeto aberto
✅ Voltada para educação e aprendizado

Diferença para Python

A Delégua não tem como objetivo simplesmente traduzir Python.

Ela possui sua própria linguagem e seu próprio ecossistema.

Por isso, quem quiser migrar posteriormente para Python ainda terá uma etapa de adaptação.

🐍 Pituguês

O que é: uma proposta de programação em português inspirada na sintaxe do Python e relacionada ao ecossistema da Delégua.

Pontos fortes

✅ Sintaxe próxima do Python
✅ Programação em português
✅ Aproxima conceitos de programação de uma linguagem popular

Diferença para Python

Apesar da inspiração, Pituguês e Python não são a mesma linguagem.

O Pituguês possui sua própria implementação e seu próprio contexto.

Para quem procura uma experiência próxima de Python em português, essa é justamente uma das características mais interessantes da proposta.

🔴 Outras iniciativas

Existem também outras linguagens e projetos voltados à programação em português, como G-Portugol e Potigol.

Cada um possui sua própria proposta, público e nível de desenvolvimento.

Isso mostra que a ideia de tornar programação mais acessível em português não é nova.

🟢 Pyrtugues

O que é: uma linguagem/sintaxe em português que traduz o código para Python executável.

A proposta principal é utilizar português para reduzir a barreira inicial sem se afastar da estrutura do Python.

Exemplo:

idade = 12

se idade maior que 10:
    mostrar("Olá! Você pode programar!")

O código é traduzido para:

idade = 12

if idade > 10:
    print("Olá! Você pode programar!")

A lógica continua sendo a mesma.

A diferença está principalmente na sintaxe utilizada pelo estudante.

🧠 O que torna o Pyrtugues diferente?

1. É uma ponte, não necessariamente um destino

O objetivo do Pyrtugues não é impedir o estudante de aprender Python.

É justamente o contrário.

A proposta é:

Português
   ↓
Pyrtugues
   ↓
Python

O estudante pode começar usando palavras em português e, posteriormente, reconhecer os equivalentes em Python.

2. A estrutura continua próxima do Python

O Pyrtugues mantém vários elementos familiares para quem pretende aprender Python:

indentação;
dois-pontos (:);
estruturas condicionais;
laços de repetição;
funções;
operadores;
variáveis.

Por exemplo:

se idade maior ou igual a 18:
    mostrar("Maior de idade")
senão:
    mostrar("Menor de idade")

A estrutura é muito próxima de:

if idade >= 18:
    print("Maior de idade")
else:
    print("Menor de idade")

3. A migração pode ser muito direta

Em exemplos simples, várias palavras podem ser relacionadas diretamente:

se       → if
senão    → else
senão se → elif
mostrar  → print
pergunte → input
inteiro  → int
decimal  → float

Assim, o estudante consegue começar a perceber que existe uma correspondência entre a sintaxe em português e a sintaxe do Python.

4. O projeto vai além de exemplos básicos

O Pyrtugues não foi pensado apenas para:

"Olá, mundo!"

A proposta também inclui utilização com bibliotecas do ecossistema Python.

Entre os recursos disponíveis estão:

🎮 Pygame
🖥️ CustomTkinter
📊 bibliotecas de dados
📈 bibliotecas de gráficos
🌐 bibliotecas web
🧮 bibliotecas científicas

A ideia é permitir que o estudante possa avançar dos primeiros exercícios para projetos maiores.

5. Diferentes formas de usar

O projeto possui diferentes formas de utilização, incluindo:

🌐 editor web;
💻 aplicativo desktop;
🧩 extensão para VS Code;
🐍 execução através do Python.

Isso permite que o estudante escolha um ambiente de acordo com o que está aprendendo.

📊 Comparação

Em vez de perguntar simplesmente “qual é a melhor?”, talvez seja melhor perguntar:

Qual ferramenta é mais adequada para determinado objetivo?

Aspecto	Portugol / Visualg	Delégua	Pituguês	Pyrtugues
Programação em português	✅	✅	✅	✅
Foco educacional	✅	✅	✅	✅
Sintaxe inspirada em Python	⚠️	⚠️	✅	✅
Traduz para Python	❌	❌	⚠️	✅
Executa Python gerado	❌	❌	❌	✅
Ecossistema Python	❌	❌	⚠️	✅
VS Code	⚠️	⚠️	⚠️	✅
Pygame	❌	❌	❌	✅
CustomTkinter	❌	❌	❌	✅
Objetivo de facilitar a transição para Python	⚠️	⚠️	✅	✅

Observação: as ferramentas possuem objetivos diferentes. A ausência de determinado recurso não significa que o projeto seja ruim.

💻 Exemplo: calculadora de média

Vamos fazer o mesmo programa utilizando Portugol, Pyrtugues e Python.

🟡 Portugol

algoritmo "media"
var
   n1, n2, media: real
inicio
   escreva("Nota 1: ")
   leia(n1)

   escreva("Nota 2: ")
   leia(n2)

   media <- (n1 + n2) / 2

   se media >= 7 entao
      escreva("Aprovado")
   senao
      escreva("Reprovado")
fim

🟢 Pyrtugues

n1 = decimal(pergunte("Nota 1: "))
n2 = decimal(pergunte("Nota 2: "))

media = (n1 + n2) / 2

se media maior ou igual a 7:
    mostrar("Aprovado")
senão:
    mostrar("Reprovado")

🐍 Python gerado

n1 = float(input("Nota 1: "))
n2 = float(input("Nota 2: "))

media = (n1 + n2) / 2

if media >= 7:
    print("Aprovado")
else:
    print("Reprovado")

O que podemos observar?

No Portugol, a sintaxe é própria da ferramenta.

No Pyrtugues, a estrutura continua próxima do Python:

se       → if
senão    → else
mostrar  → print
pergunte → input
decimal  → float

O objetivo não é dizer que uma abordagem é universalmente melhor.

A diferença está no caminho que cada ferramenta oferece ao estudante.

🎯 Por que o Python é importante nessa discussão?

Python é utilizado em várias áreas da computação e possui um ecossistema muito grande.

Existem bibliotecas para:

desenvolvimento web;
automação;
ciência de dados;
inteligência artificial;
jogos;
interfaces gráficas;
computação científica;
análise de dados.

Por isso, uma ferramenta que utiliza Python como destino pode funcionar como uma forma de introdução ao ecossistema real da linguagem.

🏁 Então, qual é a melhor?

A resposta depende do objetivo.

Objetivo	Opção
Aprender lógica e algoritmos	Portugol / Visualg
Programar em português com uma linguagem própria	Delégua
Utilizar uma linguagem em português inspirada em Python	Pituguês
Aprender programação em português mantendo Python como destino	Pyrtugues

Não existe uma ferramenta perfeita para todas as situações.

O ponto principal do Pyrtugues é outro:

reduzir a barreira do inglês sem afastar o estudante do Python.

🚀 Conheça o Pyrtugues

🌐 Site oficial: pyrtugues.pages.dev

🧪 Editor Web: pyrtugues-editor.pages.dev

💻 Extensão VS Code: Open VSX

🐙 GitHub: github.com/pyrtugues

É gratuito.

Na versão Web, não é necessário instalar o programa para experimentar.

💭 Conclusão

Programação em português não é uma ideia nova.

Existem projetos diferentes, com objetivos diferentes, e todos podem ter seu espaço no ensino de programação.

O Pyrtugues escolheu um caminho específico:

Português
   ↓
Aprender programação
   ↓
Pyrtugues
   ↓
Python

A ideia é que o português seja uma porta de entrada, e não uma barreira entre o estudante e o ecossistema Python.

Por isso, em vez de perguntar:

“Qual linguagem em português é a melhor?”

Talvez a pergunta mais interessante seja:

“Qual delas é mais adequada para o que eu quero aprender?”

E, para quem quer começar em português tendo o Python como destino, essa é justamente a proposta do Pyrtugues.

🐍 Pyrtugues

Programação em português.

Lógica de Python.

Uma ponte para aprender.

Criado por Vinicius Caracciolo.

❤️ Qual abordagem você prefere para aprender programação: Portugol, Delégua, Pituguês, Pyrtugues ou Python direto?

Como funciona o tradutor do Pyrtugues

pyrtugues — Tue, 29 Sep 2026 22:51:55 +0000

Como funciona o tradutor do Pyrtugues por dentro

Tempo de leitura: ~6 minutos

No meu primeiro post eu apresentei o Pyrtugues: uma linguagem de programação em português que traduz código para Python real. Muita gente perguntou como isso funciona por dentro.

Esse post responde. Vou mostrar os desafios técnicos de traduzir código entre linguagens e como resolvi cada um.

Se você nunca escreveu um tradutor, esse post é pra você. Se já escreveu, talvez encontre algo interessante.

O problema básico

Traduzir mostrar("Olá") para print("Olá") parece simples. E é — se você só tem uma linha.

O problema começa quando o código tem strings, comentários e f-strings. Veja esse exemplo:

nome = "Maria e João"
mostrar(f"Olá, {nome}!")
# Isso é um comentário com se, senão, mostrar

Se você fizer uma tradução ingênua (substituir toda palavra-chave), o resultado vira uma bagunça:

nome = "Maria and João"     # ❌ ERRADO - "e" virou "and"
print(f"Olá, {nome}!")       # ✅ Ok
# Isso é um comentário com if, else, print   # ❌ ERRADO

Três problemas apareceram:

O "e" dentro da string virou "and"
O comentário foi traduzido
O Python não entende isso

A solução: proteger strings antes de traduzir

A primeira coisa que o tradutor faz é esconder todas as strings e comentários antes de mexer no código. Uso um scanner que percorre caractere por caractere:

def proteger_strings_e_comentarios(codigo):
    blocos = []
    resultado = []
    i = 0

    while i < len(codigo):
        # Comentário: protege tudo depois de #
        if codigo[i] == "#":
            inicio = i
            while i < len(codigo) and codigo[i] != "\n":
                i += 1
            resultado.append(guardar(codigo[inicio:i]))
            continue

        # String: protege tudo entre aspas
        if codigo[i] in '"\'':
            # ... lógica de detecção ...
            resultado.append(guardar(codigo[inicio:i]))
            continue

        resultado.append(codigo[i])
        i += 1

    return "".join(resultado), blocos

Cada string/comentário vira um placeholder único tipo __PYRT_STR_0__. Depois o tradutor roda em paz, e no final os placeholders são restaurados.

Resultado: as strings ficam intocadas. ✅

O caso mais difícil: f-strings

F-strings são strings especiais que contêm expressões Python dentro de chaves:

mostrar(f"Olá, {nome}! Você tem {idade mais 1} anos.")

O tradutor precisa:

Não traduzir o texto normal da f-string ("Olá, ...")
Traduzir as expressões dentro das chaves ({idade mais 1} → {idade + 1})

A solução é processar cada f-string separadamente, identificando onde começa e termina cada {...}:

def _traduzir_fstring(match):
    texto = match.group(0)
    # ... encontrar prefixo e aspas ...
    corpo = texto[...]

    partes = []
    i = 0
    while i < len(corpo):
        if corpo[i] == '{':
            # Encontrar o } correspondente
            profundidade = 1
            j = i + 1
            while j < len(corpo) and profundidade:
                if corpo[j] == '{': profundidade += 1
                elif corpo[j] == '}': profundidade -= 1
                j += 1

            # Traduzir a expressão interna
            expr = corpo[i+1:j-1]
            partes.append('{' + traduzir_expressao(expr) + '}')
            i = j
        else:
            partes.append(corpo[i])
            i += 1

    return prefixo + quote + ''.join(partes) + quote

Isso funciona mesmo com f-strings aninhadas ou expressões complexas como {minha_lista[0] mais 10}.

O truque das palavras contextuais

Palavras como se, em, e, ou são ambíguas. Podem ser:

Palavra-chave (se idade > 10:)
Nome de variável (se = 10)
Parte de outra palavra (sete, sempre, tema)

Uso regex com contexto específico pra cada caso:

`se` só traduz no início de linha

# Só vira "if" se for início de uma condição
resultado = re.sub(
    r'^(\s*)se(?=\s+.+:)',  # início + indentação + se + expressão + :
    r'\1if',
    resultado,
    flags=re.MULTILINE
)

Isso garante que se idade > 10: vira if idade > 10:, mas se = 10 continua sendo variável.

`em` só traduz em loops

# Só vira "in" em "for x em y"
resultado = re.sub(
    r'\bfor\s+(\w+)\s+em\b',
    r'for \1 in',
    resultado
)

`e` / `ou` só entre expressões

# Só vira "and" / "or" entre duas expressões
resultado = re.sub(
    r'([a-zA-Z0-9_\)\]]+)\s+e\s+([a-zA-Z0-9_\(\[\{])',
    r'\1 and \2',
    resultado
)

Isso evita que "bom dia e boa tarde" vire "bom dia and boa tarde".

Métodos: só depois do ponto

Em Python, métodos são chamados depois de um ponto:

texto.upper()
lista.append("item")

Em Pyrtugues, usamos palavras em português nos mesmos lugares:

texto.maiúsculas()
lista.adicionar("item")

A tradução usa lookbehind pra garantir que só traduz depois do ponto:

# (?<=\.) significa "precedido por ."
resultado = re.sub(
    rf'(?<=\.)\s*{palavra}(?=\s*\()',
    traducao,
    resultado
)

Isso evita que uma variável chamada maiúsculas seja traduzida por engano.

O resultado final

O tradutor completo faz isso em sequência:

1. Proteger strings e comentários →  __PYRT_STR_0__, __PYRT_STR_1__...
2. Traduzir expressões dentro de f-strings
3. Traduzir palavras-chave com contexto (se, em, e, ou)
4. Traduzir métodos (só depois do ponto)
5. Traduzir operadores (mais, menos, vezes)
6. Restaurar strings e comentários
7. Retornar código Python

Linha 1 do Pyrtugues:

se idade maior que 10:
    mostrar("Olá!")

Linha 1 do Python gerado:

if idade > 10:
    print("Olá!")

E funciona com código complexo:

função calcular_media(notas):
    soma = 0
    para nota em notas:
        soma = soma mais nota
    retornar soma dividido por tamanho(notas)

nomes = ["Ana e Maria", "João e Pedro"]
para nome em nomes:
    mostrar(f"Processando: {nome}")

Vira:

def calcular_media(notas):
    soma = 0
    for nota in notas:
        soma = soma + nota
    return soma / len(notas)

nomes = ["Ana e Maria", "João e Pedro"]
for nome in nomes:
    print(f"Processando: {nome}")

Os "e" dentro das strings ficam preservados. ✅

O que aprendi nesse projeto

Fazer um tradutor parece simples até você tentar. Aprendi três lições:

Contexto é tudo. Substituir palavra por palavra não funciona. Precisa entender onde cada uma está.
Strings são sagradas. Proteja antes de qualquer coisa.
Teste com código real. Bug só aparece quando você tenta casos extremos.

O código completo tá no GitHub. Se você quiser contribuir com melhorias no tradutor, abre uma issue ou manda PR.

Vem testar

O Pyrtugues tá disponível em:

🌐 Site oficial: pyrtugues.pages.dev
💻 Editor Web: pyrtugues-editor.pages.dev
🐙 GitHub: github.com/pyrtugues

Ficou alguma dúvida sobre o tradutor? Quer saber mais sobre alguma parte específica? Comenta aqui embaixo que eu respondo!

📚 Posts anteriores

Pyrtugues: programação em português que gera Python de verdade

Pyrtugues — Programação em português. Lógica de Python. Uma ponte para aprender.

Criado por Vinicius Caracciolo (12 anos)

Pyrtugues: programação em português que gera Python de verdade

pyrtugues — Sun, 27 Sep 2026 20:29:00 +0000

Pyrtugues: A Ponte em Português para o Python que Crianças e Iniciantes Precisavam

Se você já tentou ensinar programação para uma criança ou para alguém que não fala inglês, sabe qual é o maior obstáculo: a barreira do idioma. Enquanto a lógica de programação é universal, os comandos como if, else, print e def são em inglês.

Ferramentas como o Portugol tentam resolver isso, mas trazem uma sintaxe complicada e engessada, que não se conecta com o que o mercado usa. O Pyrtugues nasceu para mudar esse cenário.

O que é o Pyrtugues?

O Pyrtugues é um projeto educacional de código aberto que funciona como uma ponte para o Python. Ele permite que você escreva código usando palavras em português, mas com a lógica idêntica à do Python.

Mais do que isso: o Pyrtugues traduz automaticamente o seu código em português para Python real, que pode ser executado e até mesmo usar a biblioteca Pygame para criar jogos.

Como Funciona?

A arquitetura do Pyrtugues é simples e poderosa:

Você escreve em Pyrtugues: se idade > 10: mostrar("Olá!")
O motor de tradução converte para Python: if idade > 10: print("Olá!")
O código Python é executado, permitindo que você veja o resultado real.

Um Exemplo Prático

Veja como é simples a transição:

Em Pyrtugues:

função saudacao(nome):
    retornar f"Olá, {nome}!"

mostrar(saudacao("Pyrtugues"))

Em Python (gerado automaticamente):

def saudacao(nome):
    return f"Olá, {nome}!"
print(saudacao("Pyrtugues"))

A lógica é a mesma. A única diferença é a sintaxe, que se torna muito mais amigável para quem está começando.

Por que o Pyrtugues é Diferente?

Sem Blocos: É programação textual de verdade, com código digitado, como no mundo real.

Ponte para o Python: Não te prende em uma linguagem "de brinquedo". Você aprende a lógica e, naturalmente, migra para o Python.

Suporte a Pygame: Crie jogos e aplicações gráficas enquanto aprende.

Versão Web e Desktop: Use no navegador ou baixe para Windows e Linux.

Conclusão

O Pyrtugues não veio para substituir o Python, mas para ser a porta de entrada ideal para ele. Se você é professor, pai ou está começando a programar e esbarra na barreira do inglês, o Pyrtugues é a ferramenta que faltava.

🌐 Site oficial: https://pyrtugues-apre.pages.dev

🧪 Editor Web: https://pyrtugues-editor.pages.dev

🔰 Curso: https://pyrtugues.pages.dev

💻 GitHub: https://github.com/pyrtugues/Pyrtugues

Você já conhecia o Pyrtugues? Deixa um comentário com a sua opinião!

DEV Community: pyrtugues

Criando um dragão em Pyrtugues

Criando um dragão que segue o mouse com Pyrtugues e Pygame 🐉

🐍 O que é o Pyrtugues?

🎮 O que vamos criar?

🛠️ Antes de começar

💻 Código completo

🧠 Como o dragão segue o mouse?

🐍 O que o Pyrtugues traduz?

🚀 Ideias para continuar

📚 Conheça o Pyrtugues

python #pygame #beginners #programming

Pyrtugues vs Portugol: qual é a melhor opção em português para aprender Python?

Pyrtugues vs Portugol: qual é a melhor opção em português para aprender Python?

🎯 O problema comum

📚 As principais opções

🇧🇷 Portugol / Visualg

Exemplo:

Pontos fortes

E a relação com Python?

🇧🇷 Delégua

Pontos fortes

Diferença para Python

🐍 Pituguês

Pontos fortes

Diferença para Python

🔴 Outras iniciativas

🟢 Pyrtugues

Exemplo:

🧠 O que torna o Pyrtugues diferente?

1. É uma ponte, não necessariamente um destino

2. A estrutura continua próxima do Python

3. A migração pode ser muito direta

4. O projeto vai além de exemplos básicos

5. Diferentes formas de usar

📊 Comparação

💻 Exemplo: calculadora de média

🟡 Portugol

🟢 Pyrtugues

🐍 Python gerado

O que podemos observar?

🎯 Por que o Python é importante nessa discussão?

🏁 Então, qual é a melhor?

🚀 Conheça o Pyrtugues

💭 Conclusão

🐍 Pyrtugues

Como funciona o tradutor do Pyrtugues

Como funciona o tradutor do Pyrtugues por dentro

O problema básico

A solução: proteger strings antes de traduzir

O caso mais difícil: f-strings

O truque das palavras contextuais

se só traduz no início de linha

em só traduz em loops

e / ou só entre expressões

Métodos: só depois do ponto

O resultado final

O que aprendi nesse projeto

Vem testar

📚 Posts anteriores

Pyrtugues: programação em português que gera Python de verdade

Pyrtugues: A Ponte em Português para o Python que Crianças e Iniciantes Precisavam

O que é o Pyrtugues?

Como Funciona?

Um Exemplo Prático

Por que o Pyrtugues é Diferente?

Conclusão

`se` só traduz no início de linha

`em` só traduz em loops

`e` / `ou` só entre expressões