Portulong v0.0.2 (Professional Web Edition)

Linguagem de programação 100% em Português de Portugal para criar páginas web e aplicações completas com interpretador, servidor integrado e extensão VS Code — tudo num único ficheiro .ptg.

🚀 Instalação

pip install portulong

Configurar VS Code (automático)

ptg config

Instala automaticamente a extensão VS Code embutida no pacote, configura syntax highlighting, snippets e linter.

💻 Comandos CLI

🎯 Exemplo Nike Showcase

Um website estilo landing page / showcase moderno (estilo Nike: preto, branco, cinzento) com navegação por abas, animações e SPA total:

ptg rodar exemplo_nike.ptg

📝 Sintaxe 100% PT-PT

Estrutura

pagina "Minha Pagina"
servidor:
    porta 3000
    computador local
fim_servidor

Backend e Dados

supabase:
    url "https://teu-projeto.supabase.co"
    chave "tua-chave-api"
fim_supabase

rota GET /api/contagem:
    resposta = {"total": 42, "ativos": 38}
fim_rota

SPA Multi-ecras

tela "inicio":
    caixa "hero":
        titulo2 "Bem-vindo"
        botao "Ver Produtos" acao "mostrar_tela('produtos')"
    fim_caixa
fim_tela

tela "produtos":
    titulo2 "Catálogo"
    botao "Voltar" acao "mostrar_tela('inicio')"
fim_tela

CSS em Português (Liberdade Total)

estilo:
.hero {
    fundo: preto;
    cor: branco;
    opacidade: 0.9;
    transicao: todos 0.3s suave;
    transformar: escorregarY(-5px);
    animacao: pulse 2s infinito;
}

@keyframes pulse {
    0% { opacidade: 0.6; }
    50% { opacidade: 1; }
    100% { opacidade: 0.6; }
}

@media (max-width: 768px) {
    .hero { espacamento: 15px; }
}
fim_estilo

Lógica e Script

script:
funcao carregar_dados():
    escrever("Portulong carregado!")
fim_funcao
fim_script

🎨 Extensão VS Code

Recursos

• Syntax Highlighting — Cores para blocos, UI, CSS, lógica
• Snippets Inteligentes — ptg-base, ptg-animacao, ptg-media, ptg-supabase
• Abreviaturas — cx → caixa, bt → botao, t1 → titulo1
• Linter — Blocos não fechados + palavras em inglês
• Hover Tooltips — Explicações em português
• Quick-Fix — Corrige inglês → PT-PT com 1 clique
• Color Decorators — Seletores visuais de cor
• Auto-indentação — Aumenta/recua automático

📦 Desenvolvimento

git clone https://github.com/silvio-blip/portulong.git
cd portulong
pip install -e .
ptg rodar exemplo_nike.ptg

📤 Publicar no PyPI

A publicação é automática via GitHub Actions quando há push para main.

Manualmente:

python -m build
twine upload dist/*

📄 Licença

MIT