portulong 0.0.1__tar.gz

portulong-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 portulong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

portulong-0.0.1/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: portulong
+Version: 0.0.1
+Summary: Linguagem 100% PT-PT para desenvolvimento web — interpretador, servidor e extensão VS Code integrados.
+Author: Silvio
+Author-email: silvio@portulong.dev
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: discord
+Requires-Dist: discord.py>=2.0.0; extra == "discord"
+Provides-Extra: supabase
+Requires-Dist: supabase; extra == "supabase"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: vsce; extra == "dev"
+Dynamic: author-email
+Dynamic: license-file
+Dynamic: requires-python
+
+# Portulong (v1.1.0)
+
+Linguagem de programação em Português de Portugal para criar páginas web e aplicações completas com interpretador e servidor integrado.
+
+## Instalação
+
+```bash
+pip install portulong-sistema
+```
+
+## Utilização
+
+Para executar um ficheiro `.ptg`:
+
+```bash
+ptg meu_programa.ptg
+```
+
+Para iniciar o servidor web integrado:
+
+```bash
+ptg meu_programa.ptg --servidor
+```
+
+## Publicar no PyPI
+
+Para publicar a versão **1.1.0** no PyPI:
+
+```bash
+# 1. Instalar as ferramentas de publicação
+pip install --upgrade build twine
+
+# 2. Gerar o pacote em dist/
+python -m build
+
+# 3. Enviar para o PyPI
+twine upload dist/*
+```
+
+Ou execute diretamente o script auxiliar:
+```bash
+bash publicar_pypi.sh
+```
+
+## Exemplo (`ola_mundo.ptg`)
+
+```ptg
+pagina "Minha Primeira Pagina"
+
+cabecalho "Olá, Mundo em Portulong!"
+paragrafo "Criado com sintaxe 100% em Português de Portugal."
+
+estilo:
+corpo { fundo: #f0fdf4; espacamento: 40px; }
+
+script:
+escrever("ola tudo ?")
+```
+
+## Novidades v1.1.0
+
+### Bloco Supabase Declarativo
+Conecte à sua base de dados Supabase com uma sintaxe simples:
+
+```ptg
+supabase:
+    url "https://teu-projeto.supabase.co"
+    chave "tua-chave-api"
+fim_supabase
+```
+
+### Rotas Backend com Execução Dinâmica
+Rotas que executam código Python e retornam JSON dinamicamente:
+
+```ptg
+rota GET /api/usuarios:
+    resposta = {"usuarios": [{"id": 1, "nome": "João"}]}
+fim_rota
+
+rota POST /api/usuario:
+    nome_usuario = dados.get("nome", "")
+    resposta = {"sucesso": verdadeiro, "mensagem": "Utilizador " + nome_usuario + " criado!"}
+fim_rota
+```
+
+### Múltiplos Ecrãs (SPA)
+Crie aplicações de página única com navegação sem recarregar:
+
+```ptg
+tela "inicio":
+    cabecalho "Bem-vindo"
+    botao "Ir para Dashboard" acao "mostrar_tela('dashboard')"
+fim_tela
+
+tela "dashboard":
+    cabecalho "Dashboard"
+    botao "Voltar" acao "mostrar_tela('inicio')"
+fim_tela
+```
+
+### CSS Avançado — Liberdade Total
+Suporte completo a animações, responsividade e efeitos visuais:
+
+```ptg
+estilo:
+@keyframes pulse {
+    0% { opacidade: 0.6; }
+    50% { opacidade: 1; }
+    100% { opacidade: 0.6; }
+}
+
+@media (max-width: 768px) {
+    corpo { espacamento: 15px; }
+}
+
+.botao-animado {
+    animacao: pulse 2s infinito;
+    transformar: escorregar(10px);
+    fundo: linear-gradient(135deg, #2563eb, #1e40af);
+}
+fim_estilo
+```

portulong-0.0.1/README.md

@@ -0,0 +1,122 @@
+# Portulong (v1.1.0)
+
+Linguagem de programação em Português de Portugal para criar páginas web e aplicações completas com interpretador e servidor integrado.
+
+## Instalação
+
+```bash
+pip install portulong-sistema
+```
+
+## Utilização
+
+Para executar um ficheiro `.ptg`:
+
+```bash
+ptg meu_programa.ptg
+```
+
+Para iniciar o servidor web integrado:
+
+```bash
+ptg meu_programa.ptg --servidor
+```
+
+## Publicar no PyPI
+
+Para publicar a versão **1.1.0** no PyPI:
+
+```bash
+# 1. Instalar as ferramentas de publicação
+pip install --upgrade build twine
+
+# 2. Gerar o pacote em dist/
+python -m build
+
+# 3. Enviar para o PyPI
+twine upload dist/*
+```
+
+Ou execute diretamente o script auxiliar:
+```bash
+bash publicar_pypi.sh
+```
+
+## Exemplo (`ola_mundo.ptg`)
+
+```ptg
+pagina "Minha Primeira Pagina"
+
+cabecalho "Olá, Mundo em Portulong!"
+paragrafo "Criado com sintaxe 100% em Português de Portugal."
+
+estilo:
+corpo { fundo: #f0fdf4; espacamento: 40px; }
+
+script:
+escrever("ola tudo ?")
+```
+
+## Novidades v1.1.0
+
+### Bloco Supabase Declarativo
+Conecte à sua base de dados Supabase com uma sintaxe simples:
+
+```ptg
+supabase:
+    url "https://teu-projeto.supabase.co"
+    chave "tua-chave-api"
+fim_supabase
+```
+
+### Rotas Backend com Execução Dinâmica
+Rotas que executam código Python e retornam JSON dinamicamente:
+
+```ptg
+rota GET /api/usuarios:
+    resposta = {"usuarios": [{"id": 1, "nome": "João"}]}
+fim_rota
+
+rota POST /api/usuario:
+    nome_usuario = dados.get("nome", "")
+    resposta = {"sucesso": verdadeiro, "mensagem": "Utilizador " + nome_usuario + " criado!"}
+fim_rota
+```
+
+### Múltiplos Ecrãs (SPA)
+Crie aplicações de página única com navegação sem recarregar:
+
+```ptg
+tela "inicio":
+    cabecalho "Bem-vindo"
+    botao "Ir para Dashboard" acao "mostrar_tela('dashboard')"
+fim_tela
+
+tela "dashboard":
+    cabecalho "Dashboard"
+    botao "Voltar" acao "mostrar_tela('inicio')"
+fim_tela
+```
+
+### CSS Avançado — Liberdade Total
+Suporte completo a animações, responsividade e efeitos visuais:
+
+```ptg
+estilo:
+@keyframes pulse {
+    0% { opacidade: 0.6; }
+    50% { opacidade: 1; }
+    100% { opacidade: 0.6; }
+}
+
+@media (max-width: 768px) {
+    corpo { espacamento: 15px; }
+}
+
+.botao-animado {
+    animacao: pulse 2s infinito;
+    transformar: escorregar(10px);
+    fundo: linear-gradient(135deg, #2563eb, #1e40af);
+}
+fim_estilo
+```

portulong-0.0.1/portulong/__init__.py

@@ -0,0 +1,10 @@
+__version__ = "0.0.1"
+__author__ = "Silvio"
+__license__ = "MIT"
+
+from .core import Empretador, PortulongCompilador
+from .erros import PortulongErro, ErroSintaxe, ErroServidor
+from . import discord
+from . import ambiente
+from . import base_dados
+from . import bots

portulong-0.0.1/portulong/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

portulong-0.0.1/portulong/ambiente.py

@@ -0,0 +1,48 @@
+"""
+Módulo Ambiente Portulong (.env)
+100% em Português de Portugal para carregar e gerir variáveis de ambiente.
+"""
+
+import os
+import sys
+
+def carregar_ambiente(caminho=".env"):
+    """Carrega variáveis de um ficheiro .env para o ambiente de execução."""
+    if not os.path.exists(caminho):
+        return False
+    try:
+        with open(caminho, "r", encoding="utf-8") as f:
+            for linha in f:
+                linha = linha.strip()
+                if not linha or linha.startswith("#"):
+                    continue
+                if "=" in linha:
+                    chave, valor = linha.split("=", 1)
+                    chave = chave.strip()
+                    valor = valor.strip().strip('"\'')
+                    os.environ[chave] = valor
+        return True
+    except Exception as e:
+        print(f"Erro ao carregar .env: {e}")
+        return False
+
+def obter_ambiente(chave, padrao=None):
+    """Obtém o valor de uma variável de ambiente."""
+    return os.environ.get(chave, padrao)
+
+def obter_variavel(chave, padrao=None):
+    """Alias em português para obter uma variável."""
+    return os.environ.get(chave, padrao)
+
+def definir_ambiente(chave, valor):
+    """Define uma variável de ambiente em tempo de execução."""
+    os.environ[chave] = str(valor)
+
+def verificar_ambiente():
+    """Verifica se o interpretador Python 3 está ativo."""
+    return sys.version_info.major >= 3
+
+# Aliases em português
+carregar_env = carregar_ambiente
+obter = obter_ambiente
+definir = definir_ambiente

portulong-0.0.1/portulong/base_dados.py

@@ -0,0 +1,120 @@
+"""
+Módulo Base de Dados e Supabase Portulong
+100% em Português de Portugal para integração com bases de dados e Supabase.
+"""
+
+import json
+import os
+import urllib.request
+import urllib.error
+
+class ClienteSupabase:
+    """Cliente nativo para conectar ao Supabase usando sintaxe 100% em Português."""
+    def __init__(self, url, chave):
+        self.url = url.rstrip("/")
+        self.chave = chave
+        self.cabecalhos = {
+            "apikey": self.chave,
+            "Authorization": f"Bearer {self.chave}",
+            "Content-Type": "application/json",
+            "Prefer": "return=representation"
+        }
+
+    def tabela(self, nome_tabela):
+        """Retorna um objeto de consulta para a tabela especificada."""
+        return ConsultaTabela(self.url, nome_tabela, self.cabecalhos)
+
+    def de(self, nome_tabela):
+        """Alias em português: supabase.de('utilizadores')"""
+        return self.tabela(nome_tabela)
+
+class ConsultaTabela:
+    def __init__(self, url_base, tabela, cabecalhos):
+        self.url = f"{url_base}/rest/v1/{tabela}"
+        self.cabecalhos = cabecalhos
+
+    def selecionar(self, colunas="*"):
+        """Executa um GET para buscar dados da tabela."""
+        url = f"{self.url}?select={colunas}"
+        req = urllib.request.Request(url, headers=self.cabecalhos)
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except Exception as e:
+            return {"erro": str(e)}
+
+    def inserir(self, dados):
+        """Executa um POST para inserir um novo registo."""
+        corpo = json.dumps(dados).encode("utf-8")
+        req = urllib.request.Request(self.url, data=corpo, headers=self.cabecalhos, method="POST")
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except Exception as e:
+            return {"erro": str(e)}
+
+    def atualizar(self, id_registo, dados):
+        """Executa um PATCH para atualizar um registo."""
+        url = f"{self.url}?id=eq.{id_registo}"
+        corpo = json.dumps(dados).encode("utf-8")
+        req = urllib.request.Request(url, data=corpo, headers=self.cabecalhos, method="PATCH")
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except Exception as e:
+            return {"erro": str(e)}
+
+    def apagar(self, id_registo):
+        """Executa um DELETE para remover um registo."""
+        url = f"{self.url}?id=eq.{id_registo}"
+        req = urllib.request.Request(url, headers=self.cabecalhos, method="DELETE")
+        try:
+            with urllib.request.urlopen(req) as resp:
+                return {"sucesso": True}
+        except Exception as e:
+            return {"erro": str(e)}
+
+def conectar_supabase(url, chave):
+    """Função em português para instanciar a conexão Supabase."""
+    return ClienteSupabase(url, chave)
+
+class BaseDadosMemoria:
+    """Base de dados em memória e ficheiro JSON para persistência simples."""
+    def __init__(self, arquivo="dados_portulong.json"):
+        self.arquivo = arquivo
+        self.tabelas = {}
+        self.carregar()
+
+    def carregar(self):
+        if os.path.exists(self.arquivo):
+            try:
+                with open(self.arquivo, "r", encoding="utf-8") as f:
+                    self.tabelas = json.load(f)
+            except Exception:
+                self.tabelas = {}
+
+    def guardar(self):
+        try:
+            with open(self.arquivo, "w", encoding="utf-8") as f:
+                json.dump(self.tabelas, f, ensure_ascii=False, indent=2)
+        except Exception as e:
+            print(f"Aviso base de dados: {e}")
+
+    def obter(self, tabela, id_registo=None):
+        dados_tabela = self.tabelas.get(tabela, [])
+        if id_registo is not None:
+            for r in dados_tabela:
+                if r.get("id") == id_registo:
+                    return r
+            return None
+        return dados_tabela
+
+    def inserir(self, tabela, registo):
+        if tabela not in self.tabelas:
+            self.tabelas[tabela] = []
+        dados_tabela = self.tabelas[tabela]
+        if "id" not in registo:
+            registo["id"] = len(dados_tabela) + 1
+        dados_tabela.append(registo)
+        self.guardar()
+        return registo

portulong-0.0.1/portulong/bots.py

@@ -0,0 +1,21 @@
+"""
+Módulo Bots Portulong (Discord, Telegram e Automação)
+100% em Português de Portugal.
+"""
+
+from . import discord
+
+class PortulongBot:
+    """Suporte geral para bots e automação em Portulong."""
+    def __init__(self, nome="Bot Portulong"):
+        self.nome = nome
+
+    def executar_tarefa(self, tarefa):
+        print(f"[{self.nome}] A executar tarefa: {tarefa}")
+        return True
+
+# Integração direta do submódulo Discord dentro de bots
+Discord = discord.BotDiscord
+CriarBotDiscord = discord.CriarBot
+Incorporado = discord.Incorporado
+Contexto = discord.ContextoPortulong