Skip to content

alvIndieDevelop/python-scripts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 Python Scripts & Utilities Collection

Una colección completa de scripts, utilidades y herramientas para diferentes plataformas y lenguajes, diseñados para simplificar tareas comunes y mejorar la productividad del desarrollador.

🌟 Características del Repositorio

  • 🐍 Scripts Python - Utilidades y automatizaciones
  • 🐧 Herramientas Linux - Específicamente optimizadas para Arch Linux
  • 🪟 Utilidades Windows - Scripts y herramientas para Windows
  • 🔧 Automatización - Tareas repetitivas simplificadas
  • 📚 Documentación completa - Cada script incluye instrucciones detalladas
  • 🎯 Casos de uso reales - Soluciones prácticas para problemas comunes

📋 Tabla de Contenidos

🚀 Scripts Disponibles

🐧 Arch Linux Scripts

Arch Linux Maintenance Script

Un script profesional de mantenimiento para Arch Linux con funcionalidades avanzadas de gestión del sistema.

Características principales:

  • 🔧 Mantenimiento completo del sistema (pacman + AUR)
  • 🧹 Limpieza automática de caché y logs
  • 🏥 Verificación de salud del sistema
  • ⏰ Recordatorios automáticos configurables
  • 🎨 Interfaz interactiva y comandos de línea

Archivos:

  • arch_linux/arch_maintenance.py - Script principal
  • arch_linux/README.md - Documentación completa

Uso rápido:

# Instalar
python3 arch_maintenance.py --install

# Mantenimiento completo
archm --full

# Ver estado del sistema
archm --status

Más información: Ver documentación completa


🛠️ Instalación y Uso

Requisitos Previos

  • Python: 3.7 o superior
  • Sistema: Linux, Windows, o macOS
  • Permisos: sudo (para scripts de sistema en Linux)

Instalación General

1. Clonar el Repositorio

git clone https://github.com/alvIndieDevelop/python-scripts.git
cd python-scripts

2. Navegar al Script Deseado

# Para scripts de Arch Linux
cd arch_linux

# Para futuros scripts de Windows
cd windows

# Para futuros scripts de Python general
cd python

3. Seguir las Instrucciones Específicas

Cada script incluye su propio README con instrucciones detalladas de instalación y uso.

Uso Rápido por Plataforma

🐧 Arch Linux

cd arch_linux
python3 arch_maintenance.py --install
archm --help

🪟 Windows (Próximamente)

cd windows
# Instrucciones específicas para Windows

🐍 Python General

cd python

# Developer Environment Setup Script
sudo python3 developer_enviroment.py --help

# Instalación interactiva
sudo python3 developer_enviroment.py

# Instalar todas las herramientas
sudo python3 developer_enviroment.py --all

📚 Documentación

Estructura del Repositorio

python-scripts/
├── arch_linux/                 # Scripts específicos para Arch Linux
│   ├── arch_maintenance.py     # Script principal de mantenimiento
│   └── README.md              # Documentación del script
├── windows/                    # Scripts para Windows (próximamente)
├── python/                     # Scripts Python generales (próximamente)
├── .gitignore                 # Archivos ignorados por Git
└── README.md                  # Este archivo principal

Documentación por Script

Cada script incluye:

  • Instrucciones de instalación paso a paso
  • Ejemplos de uso prácticos
  • Casos de uso específicos
  • Troubleshooting para problemas comunes
  • Configuración avanzada y personalización

Enlaces de Documentación

🔧 Contribuciones

¡Las contribuciones son bienvenidas! Este repositorio está diseñado para crecer con la comunidad.

Cómo Contribuir

1. Fork del Repositorio

# Hacer fork en GitHub
# Clonar tu fork
git clone https://github.com/tu-usuario/python-scripts.git
cd python-scripts

2. Crear una Rama

git checkout -b feature/nueva-funcionalidad
# o
git checkout -b fix/correccion-bug

3. Desarrollar y Probar

  • Escribe código limpio y bien documentado
  • Incluye documentación para nuevos scripts
  • Prueba en diferentes plataformas si es aplicable

4. Commit y Push

git add .
git commit -m "feat: Añadir nueva funcionalidad"
git push origin feature/nueva-funcionalidad

5. Crear Pull Request

  • Describe claramente los cambios
  • Incluye ejemplos de uso
  • Referencia issues relacionados si los hay

Tipos de Contribuciones Aceptadas

  • 🆕 Nuevos scripts para diferentes plataformas
  • 🔧 Mejoras a scripts existentes
  • 🐛 Correcciones de bugs y problemas
  • 📚 Mejoras en documentación
  • 🧪 Tests y validaciones
  • 🌍 Traducciones a otros idiomas

Estándares de Código

  • Python: PEP 8, docstrings claros, type hints cuando sea posible
  • Bash: Shebang apropiado, comentarios explicativos
  • PowerShell: Comentarios y nombres descriptivos
  • Documentación: Markdown claro, ejemplos prácticos

📞 Soporte

Antes de Pedir Ayuda

  1. Revisa la documentación del script específico
  2. Prueba los comandos de troubleshooting
  3. Verifica requisitos del sistema
  4. Revisa issues existentes en GitHub

Canales de Soporte

  • 📧 Issues de GitHub: Para bugs, problemas y solicitudes de características
  • 📖 Documentación: Cada script incluye su propia documentación
  • 🔍 Wiki: Para guías avanzadas y casos de uso (próximamente)

Información Útil para Reportar Problemas

  • Script afectado: Nombre y versión
  • Sistema operativo: Versión y distribución
  • Versión de Python: Si es aplicable
  • Comando exacto: Que causó el problema
  • Error completo: Mensaje de error y stack trace
  • Logs relevantes: Si están disponibles

🎯 Roadmap del Proyecto

🚀 Próximas Funcionalidades

  • Scripts de Windows: Utilidades para PowerShell y CMD
  • Scripts Python Generales: Herramientas multiplataforma ✅
  • Automatización de DevOps: Scripts para CI/CD
  • Herramientas de Desarrollo: Scripts para programadores ✅
  • Utilidades de Sistema: Herramientas para administradores

📅 Cronograma

  • Q4 2024: Scripts de Windows y Python generales
  • Q1 2025: Herramientas de DevOps y desarrollo
  • Q2 2025: Utilidades de sistema avanzadas
  • Q3 2025: Integración y automatización completa

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

Permisos de la Licencia MIT

  • Usar el código para cualquier propósito
  • Modificar y adaptar según necesidades
  • Distribuir en proyectos comerciales
  • Sublicenciar bajo otras licencias
  • Responsabilidad del autor por daños

🌟 Agradecimientos

  • Comunidad de Arch Linux - Por la inspiración y feedback
  • Contribuidores - Por mejorar este proyecto
  • Usuarios - Por reportar bugs y sugerir mejoras

📊 Estadísticas del Repositorio

  • Scripts disponibles: 2 (Arch Linux Maintenance + Developer Environment)
  • Plataformas soportadas: Linux (Arch)
  • Lenguajes: Python, Bash
  • Documentación: 100% cubierta
  • Tests: En desarrollo

🎉 ¡Únete a la Comunidad!

¿Te gustó este proyecto? ⭐ Dale una estrella al repositorio y compártelo con otros desarrolladores!

¿Tienes ideas? 💡 Abre un issue o crea un pull request para contribuir.

¿Necesitas ayuda? 🤝 Revisa la documentación o abre un issue de soporte.


Autor: alvIndieDevelop
Última actualización: $(date +%Y-%m-%d)
Versión: 1.0.0

¡Gracias por usar Python Scripts & Utilities Collection! 🚀

About

my general pythons script for automatization, workflow on my arch-linux

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages