📘 Documentação – platform_loader.sh (v1.2.0)

🧭 Visão Geral

O script platform_loader.sh é o carregador inteligente de módulos do projeto CopyToGDriver.
Ele detecta automaticamente o sistema operacional e inclui apenas os módulos necessários, garantindo total compatibilidade entre Linux, macOS e Windows (Git Bash / WSL / Cygwin).

⚙️ Função Principal

O script executa a função:

load_platform_modules

Essa função:

• Identifica o sistema operacional atual (Linux, macOS, Windows, WSL);
• Carrega módulos universais sempre presentes na pasta includes/crossplatform;
• Inclui módulos específicos somente se existirem (ex: path_utils.sh no Windows).

📁 Estrutura Esperada

A organização de diretórios recomendada é a seguinte:

CopyToGDriver/
├── CopyToGDriver.sh
├── includes/
│   ├── crossplatform/
│   │   ├── crossplatform_utils.sh
│   │   ├── crlf_protect.sh
│   │   ├── disk_utils.sh
│   │   ├── platform_loader.sh   ← ✅ ESTE SCRIPT
│   │   └── (outros utilitários universais)
│   ├── windows/
│   │   └── path_utils.sh
│   ├── linux/
│   │   └── (opcional)
│   ├── macos/
│   │   └── (opcional)
│   └── docs/
│       └── platform_loader.md

🧩 Módulos Carregados

🔹 Módulos Universais (sempre carregados)

🔹 Módulos Específicos (carregados apenas se existirem)

🧠 Lógica de Detecção de Plataforma

A função detect_os_type usa uname -s e padrões simples para identificar o ambiente:

Linux*     → Linux ou WSL
Darwin*    → macOS
CYGWIN*|MINGW*|MSYS* → Windows (Git Bash/Cygwin)

No caso do WSL, a detecção adicional é feita com:

grep -qi microsoft /proc/version

🚀 Exemplo de Uso no Script Principal

Dentro do CopyToGDriver.sh, adicione o seguinte bloco logo após definir SCRIPT_DIR:

# -----------------------------------------------------------
# 🔧 Inicialização de módulos universais
# -----------------------------------------------------------
if [[ -f "$SCRIPT_DIR/includes/crossplatform/platform_loader.sh" ]]; then
    source "$SCRIPT_DIR/includes/crossplatform/platform_loader.sh"
    load_platform_modules
else
    echo "❌ ERRO: platform_loader.sh não encontrado!"
    exit 1
fi

🧪 Teste Autônomo

O script pode ser executado sozinho para teste:

$ bash includes/crossplatform/platform_loader.sh
=====================================================
🔧 Iniciando carregamento de módulos (plataforma: Linux)
=====================================================
✅ Módulo carregado: crlf_protect.sh
✅ Módulo carregado: crossplatform_utils.sh
✅ Módulo carregado: disk_utils.sh
=====================================================
✅ Carregamento de módulos concluído.
=====================================================

🧩 Fluxo de Carregamento Interno

flowchart TD
    A[CopyToGDriver.sh] --> B[platform_loader.sh]
    B --> C[detect_os_type]
    C --> D[Carrega módulos universais]
    C --> E{Plataforma específica?}
    E -->|Windows| F[path_utils.sh]
    E -->|Linux/macOS| G[Somente módulos universais]
    F --> H[Execução do CopyToGDriver]
    G --> H

🧰 Funções Internas

⚙️ Requisitos

• bash ≥ 4.0
• Utilitários padrão (uname, grep, awk, sed, df, du)
• Permissões de leitura nas pastas includes/*

🧩 Histórico de Versões

🧩 Créditos

Autores:

• 👤 Paulo SSPacheco
• 🤖 ChatGPT (GPT-5)

Licença: MIT – Uso livre com atribuição.

💡 “Carregue apenas o que for necessário — e carregue bem.”

— CopyToGDriver Philosophy, 2025

---