pttb-lang 2.8.0

PTTB (Português Técnico do Brasil) - A Brazilian-themed programming language

PTTB - Português Técnico do Brasil 🇧🇷 (v2.6.0)

A linguagem de programação que fala a língua do desenvolvedor brasileiro.

PTTB (Português Técnico do Brasil) é um ecossistema completo de desenvolvimento que traduz a rotina do desenvolvedor CLT para um runtime de alta performance em Python.

Como este repositório é privado, este documento serve como o Manual Oficial de Referência para uso via pip.

---

🚀 Instalação e Início Rápido

pip install pttb-lang

Comandos da CLI (Ecossistema JAM)

• pttb init: Cria a estrutura de projeto (pttjam.yaml, main.pttb, libs/).
• pttb run [arquivo]: Executa seu código PTTB.
• pttb build: Gera artefatos (.exe, .dmg, .bin) na pasta build/.
• pttb search [termo]: Busca pacotes no repositório nacional.
• pttb publish [arquivo]: Cria um pacote .ptpc comprimido para compartilhar.
• pttb add [arquivo.ptpc]: Instala um pacote local enviado por um colega.

---

🛠️ Guia de Sintaxe (Gramática Brasileira)

1. Variáveis e Tipos

definir nome = "Gemini"         // String
definir saldo = 1200.50         // Número
definir eTrabalhador = verdadeiro // Booleano (verdadeiro/falso)

2. Estruturas de Dados

// Listas (Arrays)
definir lanche = caixaDePaesDeQueijo ["Coxinha", "Kibe"]
mandaMsg(lanche[0])

// Dicionários (Objetos)
definir conta = inventarioDoZAP { "titular": "Dev", "saldo": 0 }
mandaMsg(conta.titular)

3. Controle de Fluxo

// Condicionais
sePixAceitou (saldo > 1000) {
    mandaMsg("Partiu churrasco!")
} sePixNegou {
    mandaMsg("Fica em casa...")
}

// Loops
enquantoFilaNaoAnda (x < 10) { x = x + 1 }

praCadaDesgraca item em lanche { mandaMsg(item) }

4. Funções (Contrato CLT)

funcaoCLT calcularImposto(valor) {
    sePixAceitou (valor > 5000) {
        retornar valor * 0.27
    }
    retornar valor * 0.10
}

---

📦 Bibliotecas Nativas de Elite

O PTTB vem com funções poderosas integradas ao sistema:

• Rede: fazRequisicao(url) - Faz um GET HTTP real.
• Sistema: executaComando(cmd) - Roda comandos no terminal.
• Arquivos: leArquivo(path) e escreveArquivo(path, conteudo).
• Interface: StartExternalUI(titulo, config) - Cria janelas profissionais estilo Python/IDLE.
• Ciência: criaMatriz(r, c) - Processamento de tensores brasileiros.
• Segurança: validaDocumento(doc, "CPF") - Validação real de documentos.

---

🧪 Tratamento de Erros (A "Sorte" do Dev)

tentaA_Sorte {
    // Código perigoso que pode dar ruim
    definir resultado = 10 / 0
} seDeuRuim {
    mandaMsg("O sistema entrou em colapso emocional, mas eu capturei!")
}

---

🤝 Comunidade e Suporte

O PTTB é focado em portabilidade. Se você criou um módulo incrível, use pttb publish e compartilhe o arquivo .ptpc. O PTTB utiliza Hydration para inflar esse código no projeto de destino.

Powered by PTTB Engine - A revolução brasileira no mundo da programação.