Instalação Local e Configuração do Python
Detalhes técnicos para preparar um ambiente de desenvolvimento funcional em computadores de mesa, instalar o pacote LangPy via PIP e executar laboratórios de código nativo em português.
1. Verificação do Intérprete de Python
Para garantir a transpilação léxica dos módulos, é necessário ter o Python 3.10 ou superior instalado no sistema operacional local.
Você deve verificar a presença e a versão do intérprete executando a seguinte instrução no seu terminal de comandos de preferência:
- Windows: python --version
- macOS / Linux: python3 --version
Se o terminal indicar que o comando não é reconhecido ou se a versão relatada for obsoleta, baixe a versão estável mais recente no site oficial python.org. Em sistemas Windows, é imperativo marcar a opção "Add Python to PATH" durante o instalador para indexar o executável nas variáveis globais.
2. Configuração do Ambiente Virtual (Recomendado)
O uso de ambientes virtuais (`venv`) é a prática padrão na indústria e em laboratórios educacionais para isolar os pacotes de cada projeto, prevenindo conflitos de dependências com o sistema base.
Criação do ambiente
Abra o terminal no diretório atribuído para o seu espaço de trabalho ou laboratório escolar e execute:
- Windows: python -m venv venv
- macOS / Linux: python3 -m venv venv
Ativação
Para garantir que o pacote seja instalado dentro do contêiner do projeto, ative o ambiente de acordo com o seu sistema:
- Windows (Prompt de Comando / CMD): venv\Scripts\activate
- Windows (PowerShell): .\venv\Scripts\Activate.ps1
- macOS / Linux: source venv/bin/activate
3. Instalação via Gerenciador PIP
Com o ambiente virtual devidamente ativado no terminal, baixe a versão estável mais recente do transpilador oficial.
pip install langpy
Este pacote adiciona as ferramentas léxicas locais necessárias para mapear as instruções lógicas em português para código nativo compatível diretamente com qualquer script ou biblioteca padrão do Python.
4. Criação e Execução de Scripts Locais
O ambiente do LangPy utiliza a extensão de arquivo `.pypt` para agrupar os arquivos-fonte escritos com semântica em português.
- Abra qualquer editor de código de sua preferência (ex: VS Code, VSCodium, Kate ou um bloco de notas padrão).
- Crie um arquivo de texto em branco e salve sua estrutura com o nome `main.pypt`.
- Escreva a seguinte instrução inicial de verificação no seu editor:
imprimir("Olá do LangPy local")Execução pelo Terminal
Diferente dos scripts simples tradicionais do Python, o intérprete em português é invocado chamando diretamente o comando raiz instalado:
langpy main.pypt
O núcleo do LangPy resolverá a tradução semântica em tempo real e enviará a estrutura diretamente para a máquina virtual local do Python, garantindo exatamente o mesmo desempenho original.
Resolução de Erros Comuns de Ambiente
Durante a configuração de laboratórios de informática ou primeiros ambientes locais, é comum encontrar bloqueios de permissões. Aqui estão os diagnósticos e correções diretas.
Python ou pip não são reconhecidos como comandos do sistema
O terminal de comandos indica que o termo inserido não corresponde a um programa executável.
O instalador inicial omitiu a exportação dos caminhos binários para as variáveis de ambiente da máquina (PATH).
Execute novamente o instalador oficial do Python para a sua plataforma, escolha a opção de modificar ou reparar a instalação e certifique-se de que a caixa "Add Python to PATH" fique totalmente marcada antes de finalizar.
Restrição de políticas de execução (Erro no Windows PowerShell)
Ao tentar executar o comando de ativação do ambiente virtual local, o PowerShell exibe um aviso vermelho de segurança bloqueando o processo.
O sistema de segurança padrão do Windows previne a execução de scripts locais que não contem com assinaturas remotas dentro do terminal.
Conceda permissões temporárias executando a seguinte instrução com privilégios no seu PowerShell: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
O binário 'langpy' não é localizado no terminal
O terminal exibe que a ordem de execução não existe, apesar de ter baixado o pacote anteriormente.
O terminal atual perdeu a referência do ambiente virtual ativo ou a instalação global não possui permissões de acesso.
Certifique-se de visualizar a etiqueta do seu ambiente ativo entre parênteses no início da linha de comandos, atualize os componentes principais e tente uma reinstalação forçada com: python -m pip install --upgrade pip && pip install langpy
Incompatibilidades em tempo de execução
O sistema dispara exceções inesperadas ao processar um arquivo com extensão legítima .pypt.
A versão do intérprete de Python da máquina hospedeira é anterior aos padrões técnicos mínimos do transpilador.
Execute no seu terminal o comando `python --version` para validar seu ambiente e proceda com a migração do sistema para uma versão moderna igual ou superior ao Python 3.10.