Guia de Uso do Sistema

1. Verificar o Ambiente

Certifique-se de que o sistema está pronto para trabalhar executando o comando principal no seu terminal sem adicionar mais nada.

langpy

2. Uso Essencial

Execute seus arquivos de código diretamente

Crie um arquivo de texto com a extensão do seu idioma (`.pypt` para português) e coloque-o para rodar com o comando básico.

# ola.pypt
definir main():
    nome = "Mundo"
    imprimir(f"Olá {nome}!")

main()

langpy ola.pypt

3. Extensões do Sistema

O ambiente identifica o dicionário a ser usado segundo o tipo de arquivo

• Português (extensão `.pypt`): Ativa comandos naturais como `definir`, `se`, `para`, `imprimir`.
• Espanhol (extensão `.pyes`): Ativa comandos naturais como `definir`, `si`, `para`, `imprimir`.
• Francês (extensão `.pyfr`): Ativa comandos naturais como `definir`, `si`, `pour`, `imprimer`.

4. Estrutura de Projetos Avançados

Ideal para ensinar como um software real é organizado em pastas

Você pode agrupar múltiplos arquivos dentro de um diretório utilizando `__main__.pypt` como o ponto de partida principal.

meu_projeto/
├── __main__.pypt     # Arquivo principal de execução
├── math.pypt            # Módulo ou classe local
└── utils/
    ├── __init__.pypt
    └── helpers.pypt

langpy meu_projeto/

5. A Ponte: Converter para Python Padrão

Exporte sua lógica nativa para arquivos limpos no padrão da indústria

Pronto para o próximo passo? Gere arquivos `.py` tradicionais prontos para serem abertos com o intérprete oficial do Python em qualquer lugar do mundo.

langpy transpile script.pypt

O conversor analisa de forma inteligente as pastas e módulos locais internos, traduzindo-os em cascata enquanto mantém a estrutura exata do seu projeto intacta.

# main.pypt chama internamente utils/math.pypt:
# main.pypt              → main.py
# utils/math.pypt     → utils/math.py

6. Exportar para Pastas Específicas

Separe seu ambiente de aprendizado dos seus arquivos de produção

Use a instrução `--output` para dizer ao sistema em qual pasta exclusiva você quer salvar a versão traduzida em formato limpo.

langpy transpile main.pypt --output pasta_saida/
langpy transpile main.pypt -o pasta_saida/

7. Dicionário Completo de Comandos

langpy <arquivo ou pasta>

Execute em tempo real um script individual ou um diretório estruturado.

langpy script.pypt
langpy meu_projeto/

langpy transpile

Inicia o processo de conversão da lógica em português para código limpo compatível com a indústria.

langpy transpile script.pypt

--output / -o

Define o caminho de destino exato para os seus arquivos convertidos.

langpy transpile script.pypt --output pasta_saida/

--force / -f

Obriga o sistema a sobrescrever os arquivos `.py` anteriores caso existam modificações.

langpy transpile script.pypt --force

--help

Exibe o guia de ajuda rápida com a lista de comandos disponíveis no terminal.

langpy --help

--version

Mostra a versão exata instalada no sistema.

langpy --version

8. Compatibilidade Total com Bibliotecas Reais

Use ferramentas profissionais como NumPy ou Pandas desde o primeiro dia

Você não está preso a um brinquedo lógico. Pode importar qualquer biblioteca científica ou de dados do Python e combiná-la com seus comandos nativos.

# math.pypt
definir soma(a, b):
    retornar a + b

definir subtracao(a, b):
    retornar a - b

# main.pypt
de operacoes importar soma, subtracao
importar numpy como np

definir analisar_dados():
    # Usa suas funções em português
    resultado = soma(10, 5)
    imprimir(f"Soma: {resultado}")
    
    # Usa qualquer ecossistema nativo do Python
    dados = np.array([1, 2, 3, 4, 5])
    imprimir(f"Média: {np.mean(dados)}")

analizar_dados()

langpy main.pypt

9. Mecânica de Funcionamento

O LangPy processa apenas o texto das instruções chave de controle, traduzindo-as limpadamente para o Python e deixando o restante (seus comentários ou textos) intacto.

1. Analisa a extensão do arquivo inserido (`.pyes`, `.pypt` ou `.pyfr`).
2. Decompõe o script utilizando as ferramentas de leitura da biblioteca padrão do Python.
3. Substitui exclusivamente os identificadores lógicos mapeados para o seu idioma (os textos simples permanecem protegidos).
4. Reconstrói a estrutura como um arquivo de código Python completamente válido.
5. Executa-o diretamente na máquina virtual nativa do sistema operacional.