🦅 Aetos – Wrapper de pip con índice de paquetes personalizado

Aetos es un wrapper ligero y poderoso de pip que ejecuta todos los comandos con un servidor de paquetes (index) predefinido sin consumo de datos, ideal para entornos con acceso restringido a PyPI, redes corporativas, CI/CD o usuarios que necesitan usar mirrors locales.

🚀 Usa aetos como si fuera pip, pero sin tener que recordar --index-url cada vez.

---

🌟 ¿Por qué Aetos?

En muchos entornos (como empresas, universidades o regiones con censura), el acceso a https://pypi.org es lento o bloqueado. Usar mirrors como Tsinghua, Aliyun, Nexus o Artifactory es común, pero obliga a escribir:

pip install requests --index-url https://pypi.tuna.tsinghua.edu.cn/simple/

¡Una y otra vez!

Aetos soluciona esto: configura el índice una vez en el código y olvídate de él.

---

🔧 Características

• ✅ Ejecuta cualquier comando de pip: install, uninstall, list, show, etc.
• ✅ Usa un índice de paquetes personalizado definido en el código
• ✅ No requiere configuraciones manuales ni .pypirc
• ✅ 100% compatible con pip
• ✅ Fácil de instalar, personalizar y distribuir
• ✅ Ideal para:
  • Equipos de desarrollo
  • CI/CD
  • Entornos offline o con proxy
  • Usuarios en China, Latinoamérica, redes corporativas, etc.

---

🚀 Instalación y configuración en tu PC

Opción 1: Instalar desde PyPI (recomendado)

pip install aetos

Opción 2: Instalar desde el repositorio (modo desarrollo)

git clone https://github.com/JohnyYen/aetos
cd aetos
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate   # Windows
pip install -e .

Opción 3: Instalar en modo usuario (sin permisos de admin)

pip install --user aetos

---

🏁 Primeros pasos

1. Instala aetos usando una de las opciones anteriores.
2. Abre una terminal y ejecuta comandos como si fuera pip:

aetos install requests
aetos list

3. ¡Listo! Todos los comandos usarán el índice preconfigurado.

---

---

🛠️ Uso

Una vez instalado, usa aetos como si fuera pip:

aetos install requests
aetos install django flask
aetos uninstall paquete
aetos list
aetos show numpy

Todos los comandos se ejecutarán automáticamente con el índice configurado.

---

🔐 Índice de paquetes predeterminado

Actualmente, aetos está configurado para usar:

http://nexus.uclv.edu.cu/repository/npm/

Este es un mirror rápido y confiable de PyPI mantenido por la Universidad de las Villas (Cuba).

---

🧩 ¿Quieres cambiar el índice?

Edita el archivo aetos.py y modifica la línea:

INDEX_URL = "http://nexus.uclv.edu.cu/repository/npm/"

Luego reinstala el paquete:

pip install -e .

---

🧪 Comandos soportados

Todos los comandos de pip son compatibles:

Comando	Ejemplo
install	aetos install requests
uninstall	aetos uninstall requests
list	aetos list
show	aetos show django
freeze	aetos freeze
download	aetos download pillow

---

🛠️ Desarrollo local

Si quieres contribuir o probar cambios en tu PC:

git clone https://github.com/JohnyYen/aetos
cd aetos
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate   # Windows
pip install -e .

Luego prueba el wrapper:

aetos install rich

---

📦 Publicación (para mantenedores)

python -m build
twine upload dist/*