Python

Linguagem versátil para desenvolvimento web, ciência de dados, automação, IA e muito mais.

⚡ Instalação automatizada

Versão do Python:

Linux / WSL

curl -fsSL https://rafaelferreira2312.github.io/devforge/scripts/python/install.sh | bash -s 3.12

Windows PowerShell (Admin)

Set-ExecutionPolicy Bypass -Scope Process; iex "& { $(irm https://rafaelferreira2312.github.io/devforge/scripts/python/install.ps1) } 3.12"

macOS (Homebrew)

curl -fsSL https://rafaelferreira2312.github.io/devforge/scripts/python/install.sh | bash -s 3.12

Os scripts fazem backup automático da sua lista de pacotes pip antes de instalar.

Requisitos mínimos

CPU: 2+ núcleos (x86_64 ou ARM64)
RAM: 2 GB (recomendado 4 GB para Data Science)
Armazenamento: 5 GB SSD
SO: Ubuntu 20.04+, Debian 11+, RHEL 8+, Windows 10/11, macOS 11+

Hardware recomendado (Dev)

Notebook: Dell XPS, MacBook Pro M1/M2, Lenovo ThinkPad
CPU: i7 / Ryzen 7 ou superior (para ML)
RAM: 16 GB (32 GB para Data Science + containers)
GPU: NVIDIA CUDA (para treinamento de IA)

🛠️ Stack recomendada

Ferramentas essenciais

Gerenciador de ambientes: virtualenv / conda
Gerenciador de pacotes: pip / poetry
Framework web: Django / Flask / FastAPI
Data Science: Jupyter Notebook / VS Code
Versionamento: git + GitHub

Extensões VSCode

Python (Microsoft)
Pylance
Python Docstring Generator
Jupyter
Python Test Explorer

Docker (opcional)

docker run -it --rm python:3.12-slim python -c "print('DevForge - Python Ready!')"

🔧 Troubleshooting (diagnósticos reais)

❌ Erro: "python: command not found"

Causa: Python não instalado ou PATH não configurado.
Solução: Verifique com which python3 ou reinstale usando o script DevForge.

⚠️ Erro: "pip: command not found"

Causa: pip não instalado.
Solução: python -m ensurepip --upgrade ou sudo apt install python3-pip

🐘 Erro: "ModuleNotFoundError: No module named 'xyz'"

Causa: Pacote não instalado no ambiente atual.
Solução: Ative o virtualenv e instale: pip install xyz

⚠️ Aviso: "pip is being invoked by an old script wrapper"

Causa: Versão do pip desatualizada.
Solução: python -m pip install --upgrade pip

Diagnóstico automático:

python3 --version && pip3 --version && pip3 list --format=freeze | head -10 && echo "---" && which python3 && which pip3

Este comando verifica: versão do Python, versão do pip, 10 primeiros pacotes instalados e localização dos binários.

⚠️ IMPORTANTE - Como executar os scripts corretamente

Os scripts abaixo funcionam em Windows, Linux e macOS. Siga as instruções específicas do seu sistema:

WINDOWS (PowerShell)


            # ERRO COMUM: "arquivo não assinado" ou "execução de scripts desabilitada"
            # SOLUÇÃO 1: Executar com bypass (recomendado)
            powershell -ExecutionPolicy Bypass -File "C:\caminho\script.ps1"

            # SOLUÇÃO 2: Baixar e executar direto (pode ter erro de codificação)
            powershell -ExecutionPolicy Bypass -Command "iex (irm https://.../script.ps1)"

            # SOLUÇÃO 3: Habilitar execução permanentemente (como Administrador)
            Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

            # Se houver erros de acentuação (caracteres estranhos): O script ainda funciona, apenas a saída visual pode ficar distorcida

LINUX / WSL (Bash)


            # ERRO COMUM: "permission denied" ou "comando não encontrado"
            # SOLUÇÃO 1: Dar permissão de execução (obrigatório)
            chmod +x script.sh

            # SOLUÇÃO 2: Executar o script
            ./script.sh

            # SOLUÇÃO 3: Executar via curl (baixar e executar direto)
            curl -fsSL https://.../script.sh | bash

            # SOLUÇÃO 4: Se der erro de permissão, use sudo (cuidado!)
            sudo chmod +x script.sh && sudo ./script.sh

            # Se houver erros de permissão: Execute 'ls -la script.sh' para verificar permissões atuais

macOS (Terminal / Zsh)


            # ERRO COMUM: "permission denied" ou "operation not permitted"
            # SOLUÇÃO 1: Dar permissão de execução
            chmod +x script.sh

            # SOLUÇÃO 2: Executar o script
            ./script.sh

            # SOLUÇÃO 3: Se der erro de "quarentena" (arquivo baixado da internet)
            xattr -d com.apple.quarantine script.sh

            # SOLUÇÃO 4: Executar via curl
            curl -fsSL https://.../script.sh | bash

            # Se erro persistir: Vá em Preferências do Sistema → Segurança e Privacidade → Permitir execução

Dicas importantes:
• Windows: Se aparecerem caracteres estranhos (ex: "�" ou "Ã§Ã£o"), ignore - o script funciona normalmente. Para evitar, baixe o script localmente e execute.
• Linux/macOS: Sempre use chmod +x antes de executar scripts baixados.
• WSL (Windows): Siga as instruções do Linux, mas certifique-se de que o script está dentro do sistema de arquivos do Linux (não no /mnt/c/).

📜 Scripts prontos

install.sh install.ps1 uninstall.sh backup-env.sh

Scripts verificados no Ubuntu 22.04/24.04, Debian 12, macOS 13+ e Windows 10/11.

⚙️ Comandos pip úteis

pip install requests – instala um pacote

pip freeze > requirements.txt – exporta dependências

pip install -r requirements.txt – instala dependências

pip uninstall pacote – remove um pacote

pip list --outdated – lista pacotes desatualizados

📦 Ambientes virtuais (virtualenv)

python -m venv venv – cria ambiente virtual

source venv/bin/activate – ativa (Linux/Mac)

venv\Scripts\activate – ativa (Windows)

deactivate – desativa ambiente

❓ Perguntas frequentes

Como gerenciar múltiplas versões do Python?

Use o pyenv: pyenv install 3.11.5 && pyenv global 3.11.5. O script de instalação do DevForge inclui o pyenv opcionalmente.

O script de instalação faz backup dos meus pacotes?

Sim! Antes de qualquer modificação, o script salva a lista de pacotes pip em ~/pip-packages-backup.txt.

Python para Data Science: qual versão usar?

Use Python 3.11 ou 3.12 com Anaconda ou Miniconda para gerenciar bibliotecas como numpy, pandas, tensorflow.

Como acelerar instalação de pacotes pip?

Use cache: pip install --cache-dir ~/.pip-cache pacote ou mude para o mirror brasileiro: -i https://mirror.ufscar.br/pypi/web/simple