Skip to content

SanzioMarcos/mini-python-pt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mini Python PT

Escreva Python em português.

O Mini Python PT é um tradutor em tempo de execução que permite escrever programas utilizando palavras em português, executando-os com o interpretador oficial do Python.

O projeto não cria uma nova linguagem. Ele apenas traduz as palavras reservadas para Python e executa o código.

Exemplo

Arquivo ola.ptpy

nome = entrada("Nome: ")

se nome == "Maria":
    escrever("Olá!")

senão:
    escrever("Bem-vinda!")

para i em intervalo(3):
    escrever(i)

É executado como:

python traduzir.py exemplos/ola.ptpy

Internamente o código torna-se:

nome = input("Nome: ")

if nome == "Maria":
    print("Olá!")

else:
    print("Bem-vinda!")

for i in range(3):
    print(i)

Tudo acontece em memória. Nenhum arquivo .py é gerado.


Estrutura

mini-python-pt/

├── traduzir.py
├── palavras.json
├── exemplos/
│   ├── ola.ptpy
│   ├── condicao.ptpy
│   └── repeticao.ptpy
└── README.md

Como executar

python traduzir.py exemplos/ola.ptpy

Como funciona

O fluxo é simples:

arquivo .ptpy
        │
        ▼
tokenização (tokenize)
        │
        ▼
substituição das palavras
        │
        ▼
exec()

O projeto utiliza o módulo tokenize da biblioteca padrão do Python para substituir apenas palavras da linguagem, preservando strings, comentários e demais elementos do código.


Palavras suportadas

Alguns exemplos:

Português Python
se if
senão else
senão_se elif
enquanto while
para for
em in
função def
retornar return
escrever print
entrada input
intervalo range
verdadeiro True
falso False
nenhum None
e and
ou or
não not

As traduções são definidas no arquivo palavras.json.


Objetivos

  • Tornar Python mais acessível para iniciantes.
  • Permitir que alunos escrevam programas utilizando palavras em português.
  • Aproveitar todo o ecossistema do Python.
  • Manter o projeto pequeno, simples e fácil de manter.

Não é

  • uma nova linguagem;
  • um compilador;
  • um interpretador próprio;
  • um concorrente do Python.

O objetivo é apenas oferecer uma camada de tradução para tornar a escrita do código mais natural para falantes da língua portuguesa.


Licença

MIT.

About

Projeto sobre programar em português.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages