pyhub-droplist-coimbrox

🎯 PyHub DropList

Biblioteca Python moderna para criar menus DropList interativos acionados por atalhos de teclado + scroll do mouse. Acesso instantâneo a suas ações favoritas sem tirar as mãos do teclado! 🚀

🌟 Primeira biblioteca do mundo que combina hotkeys + scroll em uma solução completa de produtividade!

💡 Conceito DropList

O DropList é um padrão de interação inovador que combina:

• Tecla Modificadora (Ctrl, Alt, Shift) + Scroll do Mouse
• Menu contextual aparece instantaneamente na posição do cursor
• Navegação rápida com scroll ou setas
• Execução imediata com Enter ou click

🎮 Exemplo: Ctrl + Scroll → Menu de desenvolvimento aparece → Scroll para navegar → Enter para executar

✨ Features

• 🎯 DropLists personalizáveis com atalhos inteligentes
• 🖱️ Integração teclado + mouse para máxima eficiência
• ⚡ Menus contextuais rápidos que aparecem no cursor
• 🎨 Interface moderna com PyQt5 e temas escuros
• ⚙️ Configuração flexível via JSON ou código
• 🔄 Recarregamento dinâmico sem reiniciar
• 📝 Logging integrado para debugging
• 🛡️ Tratamento robusto de erros

🚀 Por Que PyHub DropList é Revolucionário?

🎯 Conceito Único no Mercado

Primeira biblioteca Python que combina atalhos de teclado + scroll do mouse em uma solução completa. Não é mais uma biblioteca de hotkeys - é um novo paradigma de interação!

💡 Problema Resolvido

# ❌ ANTES: Memorizar dezenas de atalhos
hotkey('ctrl+shift+1', action1)
hotkey('ctrl+shift+2', action2) 
hotkey('ctrl+shift+3', action3)
# ... memorizar 50+ combinações!

# ✅ AGORA: Um atalho, navegação visual
manager.register_droplist('ctrl', [action1, action2, action3])
# Ctrl + Scroll = menu visual, sem memorização!

🌟 Vantagens Competitivas

Aspecto	Bibliotecas Tradicionais	PyHub DropList
Navegação	Memorizar atalhos	🎯 Visual com scroll
Interface	Só teclado	🖱️ Teclado + Mouse
Ergonomia	Memorização forçada	🧠 Intuição natural
Flexibilidade	Atalhos fixos	🔄 Menus dinâmicos
Curva de Aprendizado	Alta (decorar)	📈 Baixa (visual)
Produtividade	Limitada por memória	⚡ Ilimitada

🎮 Casos de Uso Poderosos

Para Desenvolvedores:

dev_actions = [
    DropListAction("🔨 Build Project", "npm run build"),
    DropListAction("🧪 Run Tests", "npm test"),
    DropListAction("🚀 Deploy", "npm run deploy"),
    DropListAction("📦 Install Deps", "npm install")
]
manager.register_droplist('ctrl+d', dev_actions)
# Ctrl+D + Scroll = workflow completo!

Para Designers:

design_actions = [
    DropListAction("🎨 Photoshop", "photoshop.exe"),
    DropListAction("✏️ Illustrator", "illustrator.exe"),
    DropListAction("🎬 After Effects", "aftereffects.exe")
]
# Alt + Scroll = suite criativa na ponta dos dedos!

Para Gamers/Streamers:

stream_actions = [
    DropListAction("📹 Start Recording", toggle_recording),
    DropListAction("🎤 Mute Mic", toggle_mic),
    DropListAction("💬 Toggle Chat", toggle_chat)
]
# Shift + Scroll = controles de stream instantâneos!

🏗️ Arquitetura de Biblioteca Profissional

• API Limpa: DropListManager, DropListAction - simples e poderosa
• Modular: Cada componente tem responsabilidade específica
• Extensível: Fácil de customizar e expandir
• Threading: Não trava o sistema, roda em background
• Cross-platform: Windows, Linux, macOS (PyQt5)

🎯 Por Que Desenvolvedores Vão Amar

• ⚡ Produtividade Instantânea: 5 linhas = sistema completo
• 🧠 Zero Curva de Aprendizado: API intuitiva e bem documentada
• 🛡️ Robusto: Threading, tratamento de erros, logging integrado
• 🎨 Customizável: Temas, ícones, ações personalizadas
• 📦 Pronto para Produção: Já no PyPI, executável standalone

"Não criamos apenas mais uma biblioteca de shortcuts - criamos um novo paradigma de interação que pode influenciar como interfaces são pensadas no futuro!" 🌟

🚀 Instalação Rápida

📦 Via PyPI (Recomendado)

# Instala direto do PyPI oficial
pip install pyhub-droplist-coimbrox

🔧 Via Código Fonte

# Clona o repositório
git clone https://github.com/coimbrox/pyhub-shortcut.git
cd pyhub-shortcut

# Instala dependências
pip install keyboard mouse pyqt5

# Instala em modo desenvolvimento
pip install -e .

💾 Executável Standalone

• Download: PyHubDropList.exe (37MB)
• Não requer Python instalado
• Pronto para usar - apenas execute!

🎮 Uso Rápido - DropList

from pyhub_shortcut.droplist_manager import DropListManager, DropListAction

# Cria ações para o menu
dev_actions = [
    DropListAction("🌐 GitHub", "start https://github.com", "🌐"),
    DropListAction("💻 VS Code", "code .", "💻"),
    DropListAction("📁 Explorer", "explorer .", "📁"),
]

# Cria e configura o manager
manager = DropListManager()
manager.register_droplist("ctrl", dev_actions, "development")
manager.start()

# Agora use: Ctrl + Scroll para ver o menu!

📖 Uso Detalhado

Exemplo Completo

# Executa exemplo completo
python examples/droplist_demo.py

Controles disponíveis:

• Ctrl + Scroll → Menu de Desenvolvimento
• Alt + Scroll → Menu de Produtividade
• Shift + Scroll → Menu de Utilitários

🎛️ Configuração

As configurações são salvas em ~/.pyhub_shortcut/config.json:

{
  "actions": [
    {
      "label": "Abrir Google",
      "command": "start https://www.google.com",
      "hotkey": "ctrl+1"
    },
    {
      "label": "VS Code",
      "command": "code .",
      "hotkey": "ctrl+2"
    }
  ]
}

📁 Estrutura do Projeto

pyhub_shortcut/
├── __init__.py          # API principal
├── config.py            # Configurações básicas (legacy)
├── config_manager.py    # Gerenciador moderno de configurações
├── core.py              # Core básico (legacy)
├── core_improved.py     # Core melhorado com logging
├── ui.py                # Interface PyQt
└── cli.py               # Interface de linha de comando

🔧 Exemplos Avançados

# Exemplo básico
python examples/demo.py

# Exemplo avançado com configuração personalizada
python examples/demo_advanced.py --advanced

🛠️ Dependências

• keyboard - Para captura de atalhos globais
• mouse - Para detecção de scroll e posição do cursor
• PyQt5 - Para interface gráfica moderna

🌐 Distribuição

📦 PyPI Oficial

• Pacote: pyhub-droplist-coimbrox
• Instalação: pip install pyhub-droplist-coimbrox
• Versão atual: 0.1.0

🎮 GitHub Release

• Executável: PyHubDropList.exe (37MB)
• Não requer Python - pronto para usar
• Download direto para usuários finais

👨‍💻 Para Desenvolvedores

# Instala da fonte
pip install pyhub-droplist-coimbrox

# Importa e usa
from pyhub_shortcut.droplist_manager import DropListManager

👤 Para Usuários Finais

• Baixe PyHubDropList.exe
• Execute diretamente
• Configure seus DropLists
• Use Ctrl+Scroll para acessar!

📋 To-Do / Roadmap

• ✅ Sistema básico de DropList com atalhos + scroll
• ✅ Interface PyQt5 moderna e responsiva
• ✅ Múltiplos DropLists com teclas diferentes
• 🔄 Sistema de plugins para ações customizadas
• 🎨 Temas personalizáveis (claro/escuro/custom)
• 📱 Interface gráfica para gerenciamento de DropLists
• 🔧 Suporte a scripts Python como ações
• 👥 Profiles de usuário e configurações
• 🌍 Suporte multiplataforma (Linux/macOS)
• 🔗 Integração com bandejas do sistema
• 📊 Analytics de uso e ações mais utilizadas

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

• Fork o projeto
• Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
• Commit suas mudanças (git commit -m 'Add some AmazingFeature')
• Push para a branch (git push origin feature/AmazingFeature)
• Abra um Pull Request

📄 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

👨‍💻 Autor

Gabriel Coimbra

• GitHub: @coimbrox

⭐ Gostou do projeto? Deixe uma estrela!