🔍 Package Detective
**Tu asistente personal para la gestión de dependencias en Python.**
Detecta automáticamente importaciones de Python faltantes leyendo los diagnósticos en tiempo real de Pylance, consulta PyPI y la documentación oficial para sugerirte el nombre correcto del paquete, y lo instala directamente en tu entorno virtual integrado con un solo clic.
✨ Características Principales
- Detección Automática: Lee las alertas de Pylance cuando escribes un
import que no tienes instalado.
- Mapeo Inteligente: Traduce el nombre del
import al nombre real del paquete en pip (ej: import cv2 → opencv-python).
- Librería Estándar: Detecta si el módulo es nativo de Python y te proporciona un enlace directo a la documentación oficial en lugar de intentar instalarlo.
- Niveles de Confianza: Evalúa la popularidad del paquete consultando
pypistats (descargas mensuales) para protegerte de paquetes maliciosos o typosquatting.
- Instalación Segura (Terminal Nativa): Ejecuta la instalación inyectando comandos de forma segura directamente en tu terminal integrada de VS Code, respetando tu
venv o entorno activo.
- Caché Inteligente: Almacena los resultados de PyPI de forma local para ser ultrarrápido y no consumir ancho de banda innecesario.
🚀 Uso
El Botón Mágico
Cuando tienes un archivo .py abierto y te falta un paquete, aparecerá el ícono $(package) 📦 en la barra superior de tu editor (junto al botón de ejecutar ▶). Al hacer clic:
- Se abrirá automáticamente el panel lateral de Package Detective.
- Se escanearán los diagnósticos de Pylance en tiempo real.
- Se generarán las tarjetas para que instales lo que te falta.
Panel Lateral de Resultados
Para cada paquete sugerido, podrás ver:
- Nombre del import → Nombre del paquete en pip
- Nivel de Confianza: ✔ Confiable / ◐ Poco Confiable / ▽ No Confiable
- Estadísticas: Descargas mensuales y versión actual.
- Botones de acción rápidos:
PyPI ↗: Para abrir la página oficial del paquete.↗: Para saltar directamente a la línea de código donde hiciste el import.⚡ pip install: Instala el paquete usando la terminal nativa de VS Code.
🛡️ Niveles de Confianza
Para protegerte, Package Detective clasifica los paquetes basándose en su uso y popularidad global:
| Etiqueta |
Criterio |
| ✔ Confiable |
El paquete tiene más de 100,000 descargas mensuales o está validado internamente. |
| ◐ Poco Confiable |
El paquete tiene más de 10,000 pero menos de 100,000 descargas mensuales. Se recomienda precaución. |
| ▽ No Confiable |
El paquete tiene muy pocas descargas o no pudo ser verificado. Verifica antes de instalar. |
⚙️ Configuración (Settings)
Puedes personalizar el comportamiento de la extensión desde las preferencias de VS Code:
{
"packageDetective.minDownloadsForHighConfidence": 100000,
"packageDetective.minDownloadsForMediumConfidence": 10000,
"packageDetective.cacheExpirationHours": 168
}
🧹 Limpiar la Caché
Los resultados de PyPI se guardan localmente para mayor velocidad. Si necesitas forzar una actualización:
Abre la paleta de comandos (Ctrl+Shift+P) y ejecuta:
> Package Detective: Limpiar caché PyPI
