algebra-lineal-sheets 1.0.0__tar.gz

algebra_lineal_sheets-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Francisco Pérez Mogollón
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

algebra_lineal_sheets-1.0.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: algebra-lineal-sheets
+Version: 1.0.0
+Summary: Álgebra lineal simplificada con integración a Google Sheets para estudiantes
+Author-email: Francisco Pérez Mogollón <faperez9@utpl.edu.ec>
+Maintainer-email: Francisco Pérez Mogollón <faperez9@utpl.edu.ec>
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/algebra-lineal-sheets/
+Project-URL: Documentation, https://pypi.org/project/algebra-lineal-sheets/
+Project-URL: Repository, https://github.com/tu-usuario/algebra-lineal-sheets
+Project-URL: Bug Tracker, https://github.com/tu-usuario/algebra-lineal-sheets/issues
+Keywords: algebra,lineal,matrices,google-sheets,educacion,estudiantes,matematicas
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: Jupyter
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: gspread>=5.0.0
+Requires-Dist: google-auth>=2.0.0
+Requires-Dist: google-auth-oauthlib>=0.5.0
+Requires-Dist: google-auth-httplib2>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: build>=0.7.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# 📚 Álgebra Lineal con Google Sheets
+**Álgebra lineal simplificada para estudiantes con integración perfecta a Google Sheets.**
+
+Permite a estudiantes y profesores trabajar con matrices almacenadas en Google Sheets usando Python de forma intuitiva y sencilla. Perfecto para cursos de álgebra lineal, análisis numérico y ciencias de datos.
+
+## 🚀 Instalación
+
+```bash
+pip install algebra-lineal-sheets
+```
+
+¡Y listo! No necesitas configurar nada más.
+
+## 📋 Uso Básico
+
+### 1. Preparar Google Sheet
+- Crear Google Sheet llamado `matrices`
+- Añadir pestañas con nombres: `A`, `B`, `v`, etc.
+- Llenar con datos numéricos (sin texto ni fórmulas)
+
+### 2. Usar en Python
+
+```python
+# Importar y configurar (una vez por sesión)
+from algebra_lineal import *
+configurar()
+
+# Ver qué matrices tienes disponibles
+workspace()
+
+# Importar matrices específicas
+importar('A', 'B', 'v')
+
+# Realizar operaciones de álgebra lineal
+C = A @ B                      # Multiplicación matricial
+suma = A + B                   # Suma de matrices
+Ainv = np.linalg.inv(A)       # Matriz inversa
+det_A = np.linalg.det(A)      # Determinante
+
+# Exportar resultados de vuelta a Google Sheets
+exportar('C', 'suma', 'Ainv')
+```
+
+## 📊 Ejemplo Completo
+
+```python
+from algebra_lineal import *
+import numpy as np
+
+# Configurar conexión con Google Sheets
+configurar()
+
+# Ver workspace
+workspace()
+# 🏢 WORKSPACE: 'matrices'
+# ===========================================================================
+# #   NOMBRE               DIMENSIONES  TIPO           
+# ---------------------------------------------------------------------------
+# 1   A                    3×3          📋 Matriz      
+# 2   B                    3×3          📋 Matriz      
+# 3   v                    3×1          📉 Vector columna
+
+# Importar matrices necesarias
+importar('A', 'B', 'v')
+
+# Resolver sistema de ecuaciones Ax = b
+b = v  # Usar vector v como término independiente
+x = np.linalg.solve(A, b)
+
+# Verificar solución
+verificacion = A @ x - b
+error = np.linalg.norm(verificacion)
+
+print(f"Solución: x = {x}")
+print(f"Error: {error:.2e}")
+
+# Exportar resultados
+exportar('x', 'verificacion')
+```
+
+## 🔧 Funciones Disponibles
+
+| Función | Descripción | Ejemplo |
+|---------|-------------|---------|
+| `configurar()` | Configuración inicial | `configurar()` |
+| `workspace()` | Ver matrices en Sheets | `workspace()` |
+| `importar()` | Importar matrices | `importar('A', 'B')` |
+| `exportar()` | Exportar resultados | `exportar('C')` |
+| `cambiar_sheet()` | Cambiar archivo | `cambiar_sheet('proyecto2')` |
+| `ayuda()` | Ayuda completa | `ayuda()` |
+
+## 📚 Para Estudiantes
+
+### Google Colab (Recomendado)
+
+```python
+# 1. Instalar paquete
+!pip install algebra-lineal-sheets
+
+# 2. Importar y configurar
+from algebra_lineal import *
+configurar()
+
+# 3. ¡Empezar a trabajar!
+workspace()
+importar('A', 'B')
+resultado = A @ B
+exportar('resultado')
+```
+
+### Operaciones Comunes
+
+```python
+# Después de importar matrices A, B, v
+C = A @ B                          # Multiplicación matricial
+suma = A + B                       # Suma
+transpuesta = A.T                  # Transpuesta
+inversa = np.linalg.inv(A)         # Inversa (si existe)
+determinante = np.linalg.det(A)    # Determinante
+autovalores = np.linalg.eigvals(A) # Autovalores
+rango = np.linalg.matrix_rank(A)   # Rango
+norma = np.linalg.norm(v)          # Norma de vector
+```
+
+## 👨‍🏫 Para Profesores
+
+### Ventajas Pedagógicas
+
+- **Enfoque en matemáticas**: Los estudiantes se concentran en álgebra lineal, no en programación
+- **Datos modificables**: Cambiar valores en Google Sheets sin tocar código
+- **Colaborativo**: Fácil compartir matrices entre estudiantes
+- **Visual**: Ver resultados inmediatamente en Google Sheets
+- **Escalable**: Funciona igual para 10 o 1000 estudiantes
+
+### Configuración de Clase
+
+1. **Crear plantilla**: Google Sheet con matrices ejemplo
+2. **Compartir plantilla**: Estudiantes hacen copia
+3. **Dar instrucciones simples**:
+   ```python
+   !pip install algebra-lineal-sheets
+   from algebra_lineal import *
+   configurar()
+   ```
+
+### Ejemplo de Ejercicio
+
+```python
+# Ejercicio: Transformaciones lineales
+importar('T', 'v1', 'v2', 'v3')  # Matriz T y vectores
+
+# Aplicar transformación
+w1 = T @ v1
+w2 = T @ v2  
+w3 = T @ v3
+
+# Analizar propiedades
+det_T = np.linalg.det(T)
+es_invertible = abs(det_T) > 1e-10
+
+# Exportar análisis
+exportar('w1', 'w2', 'w3', 'det_T')
+```
+
+## 🛠️ Configuración Avanzada
+
+### Múltiples Archivos
+
+```python
+# Cambiar archivo de trabajo
+cambiar_sheet('proyecto_final')
+workspace()
+importar('datos_experimentales')
+```
+
+### Verificar Variables
+
+```python
+# Ver qué variables están disponibles para exportar
+listar_variables_exportables()
+```
+
+## ❓ Solución de Problemas
+
+### Error: "No se pudo abrir 'matrices'"
+- ✅ Verificar que el Google Sheet existe
+- ✅ Verificar que se llama exactamente 'matrices'
+- ✅ Verificar permisos de acceso
+
+### Error: "Variable no encontrada"
+- ✅ Ejecutar `importar()` antes de usar variables
+- ✅ Verificar nombres exactos con `workspace()`
+
+### Error de autenticación
+- ✅ Ejecutar `configurar()` nuevamente
+- ✅ En Colab: Runtime → Restart and run all
+
+## 🔄 Actualización
+
+```bash
+pip install --upgrade algebra-lineal-sheets
+```
+
+## 📦 Requisitos
+
+- Python 3.8+
+- numpy >= 1.20.0
+- gspread >= 5.0.0
+- google-auth >= 2.0.0
+
+Se instalan automáticamente con el paquete.
+
+## 📄 Licencia
+
+MIT License - Ver [LICENSE](https://github.com/tu-usuario/algebra-lineal-sheets/blob/main/LICENSE) para más detalles.
+
+## 🤝 Contribuir
+
+¡Las contribuciones son bienvenidas! 
+
+## 📧 Contacto
+
+- **Autor:** Francisco Pérez Mogollón
+- **Email:** faperez9@utpl.edu.ec
+- **PyPI:** https://pypi.org/project/algebra-lineal-sheets/
+
+## 🔗 Enlaces Útiles
+
+- [Google Colab](https://colab.research.google.com/)
+- [Google Sheets](https://sheets.google.com/)
+- [NumPy Documentation](https://numpy.org/doc/)
+
+---
+
+⭐ **¡Si te resulta útil, compártelo con otros profesores!** ⭐

algebra_lineal_sheets-1.0.0/README.md

@@ -0,0 +1,235 @@
+# 📚 Álgebra Lineal con Google Sheets
+**Álgebra lineal simplificada para estudiantes con integración perfecta a Google Sheets.**
+
+Permite a estudiantes y profesores trabajar con matrices almacenadas en Google Sheets usando Python de forma intuitiva y sencilla. Perfecto para cursos de álgebra lineal, análisis numérico y ciencias de datos.
+
+## 🚀 Instalación
+
+```bash
+pip install algebra-lineal-sheets
+```
+
+¡Y listo! No necesitas configurar nada más.
+
+## 📋 Uso Básico
+
+### 1. Preparar Google Sheet
+- Crear Google Sheet llamado `matrices`
+- Añadir pestañas con nombres: `A`, `B`, `v`, etc.
+- Llenar con datos numéricos (sin texto ni fórmulas)
+
+### 2. Usar en Python
+
+```python
+# Importar y configurar (una vez por sesión)
+from algebra_lineal import *
+configurar()
+
+# Ver qué matrices tienes disponibles
+workspace()
+
+# Importar matrices específicas
+importar('A', 'B', 'v')
+
+# Realizar operaciones de álgebra lineal
+C = A @ B                      # Multiplicación matricial
+suma = A + B                   # Suma de matrices
+Ainv = np.linalg.inv(A)       # Matriz inversa
+det_A = np.linalg.det(A)      # Determinante
+
+# Exportar resultados de vuelta a Google Sheets
+exportar('C', 'suma', 'Ainv')
+```
+
+## 📊 Ejemplo Completo
+
+```python
+from algebra_lineal import *
+import numpy as np
+
+# Configurar conexión con Google Sheets
+configurar()
+
+# Ver workspace
+workspace()
+# 🏢 WORKSPACE: 'matrices'
+# ===========================================================================
+# #   NOMBRE               DIMENSIONES  TIPO           
+# ---------------------------------------------------------------------------
+# 1   A                    3×3          📋 Matriz      
+# 2   B                    3×3          📋 Matriz      
+# 3   v                    3×1          📉 Vector columna
+
+# Importar matrices necesarias
+importar('A', 'B', 'v')
+
+# Resolver sistema de ecuaciones Ax = b
+b = v  # Usar vector v como término independiente
+x = np.linalg.solve(A, b)
+
+# Verificar solución
+verificacion = A @ x - b
+error = np.linalg.norm(verificacion)
+
+print(f"Solución: x = {x}")
+print(f"Error: {error:.2e}")
+
+# Exportar resultados
+exportar('x', 'verificacion')
+```
+
+## 🔧 Funciones Disponibles
+
+| Función | Descripción | Ejemplo |
+|---------|-------------|---------|
+| `configurar()` | Configuración inicial | `configurar()` |
+| `workspace()` | Ver matrices en Sheets | `workspace()` |
+| `importar()` | Importar matrices | `importar('A', 'B')` |
+| `exportar()` | Exportar resultados | `exportar('C')` |
+| `cambiar_sheet()` | Cambiar archivo | `cambiar_sheet('proyecto2')` |
+| `ayuda()` | Ayuda completa | `ayuda()` |
+
+## 📚 Para Estudiantes
+
+### Google Colab (Recomendado)
+
+```python
+# 1. Instalar paquete
+!pip install algebra-lineal-sheets
+
+# 2. Importar y configurar
+from algebra_lineal import *
+configurar()
+
+# 3. ¡Empezar a trabajar!
+workspace()
+importar('A', 'B')
+resultado = A @ B
+exportar('resultado')
+```
+
+### Operaciones Comunes
+
+```python
+# Después de importar matrices A, B, v
+C = A @ B                          # Multiplicación matricial
+suma = A + B                       # Suma
+transpuesta = A.T                  # Transpuesta
+inversa = np.linalg.inv(A)         # Inversa (si existe)
+determinante = np.linalg.det(A)    # Determinante
+autovalores = np.linalg.eigvals(A) # Autovalores
+rango = np.linalg.matrix_rank(A)   # Rango
+norma = np.linalg.norm(v)          # Norma de vector
+```
+
+## 👨‍🏫 Para Profesores
+
+### Ventajas Pedagógicas
+
+- **Enfoque en matemáticas**: Los estudiantes se concentran en álgebra lineal, no en programación
+- **Datos modificables**: Cambiar valores en Google Sheets sin tocar código
+- **Colaborativo**: Fácil compartir matrices entre estudiantes
+- **Visual**: Ver resultados inmediatamente en Google Sheets
+- **Escalable**: Funciona igual para 10 o 1000 estudiantes
+
+### Configuración de Clase
+
+1. **Crear plantilla**: Google Sheet con matrices ejemplo
+2. **Compartir plantilla**: Estudiantes hacen copia
+3. **Dar instrucciones simples**:
+   ```python
+   !pip install algebra-lineal-sheets
+   from algebra_lineal import *
+   configurar()
+   ```
+
+### Ejemplo de Ejercicio
+
+```python
+# Ejercicio: Transformaciones lineales
+importar('T', 'v1', 'v2', 'v3')  # Matriz T y vectores
+
+# Aplicar transformación
+w1 = T @ v1
+w2 = T @ v2  
+w3 = T @ v3
+
+# Analizar propiedades
+det_T = np.linalg.det(T)
+es_invertible = abs(det_T) > 1e-10
+
+# Exportar análisis
+exportar('w1', 'w2', 'w3', 'det_T')
+```
+
+## 🛠️ Configuración Avanzada
+
+### Múltiples Archivos
+
+```python
+# Cambiar archivo de trabajo
+cambiar_sheet('proyecto_final')
+workspace()
+importar('datos_experimentales')
+```
+
+### Verificar Variables
+
+```python
+# Ver qué variables están disponibles para exportar
+listar_variables_exportables()
+```
+
+## ❓ Solución de Problemas
+
+### Error: "No se pudo abrir 'matrices'"
+- ✅ Verificar que el Google Sheet existe
+- ✅ Verificar que se llama exactamente 'matrices'
+- ✅ Verificar permisos de acceso
+
+### Error: "Variable no encontrada"
+- ✅ Ejecutar `importar()` antes de usar variables
+- ✅ Verificar nombres exactos con `workspace()`
+
+### Error de autenticación
+- ✅ Ejecutar `configurar()` nuevamente
+- ✅ En Colab: Runtime → Restart and run all
+
+## 🔄 Actualización
+
+```bash
+pip install --upgrade algebra-lineal-sheets
+```
+
+## 📦 Requisitos
+
+- Python 3.8+
+- numpy >= 1.20.0
+- gspread >= 5.0.0
+- google-auth >= 2.0.0
+
+Se instalan automáticamente con el paquete.
+
+## 📄 Licencia
+
+MIT License - Ver [LICENSE](https://github.com/tu-usuario/algebra-lineal-sheets/blob/main/LICENSE) para más detalles.
+
+## 🤝 Contribuir
+
+¡Las contribuciones son bienvenidas! 
+
+## 📧 Contacto
+
+- **Autor:** Francisco Pérez Mogollón
+- **Email:** faperez9@utpl.edu.ec
+- **PyPI:** https://pypi.org/project/algebra-lineal-sheets/
+
+## 🔗 Enlaces Útiles
+
+- [Google Colab](https://colab.research.google.com/)
+- [Google Sheets](https://sheets.google.com/)
+- [NumPy Documentation](https://numpy.org/doc/)
+
+---
+
+⭐ **¡Si te resulta útil, compártelo con otros profesores!** ⭐

algebra_lineal_sheets-1.0.0/algebra_lineal/__init__.py

@@ -0,0 +1,78 @@
+"""
+📚 ALGEBRA LINEAL - Paquete para Google Sheets
+==============================================
+
+Álgebra lineal simplificada con Google Sheets integration.
+Perfecto para estudiantes y profesores.
+
+Instalación:
+    pip install algebra-lineal-sheets
+
+Uso básico:
+    from algebra_lineal import *
+    configurar()
+    importar('A', 'B')
+    C = A @ B
+    exportar('C')
+
+Autor: Francisco Pérez Mogollón
+Email: fperez9@utpl.edu.ec
+Versión: 1.0.0
+"""
+
+# Importar todas las funciones principales del módulo core
+from .core import (
+    configurar,
+    workspace,
+    importar,
+    exportar,
+    cambiar_sheet,
+    ayuda,
+    version,
+    listar_variables_exportables
+)
+
+# Definir qué se importa cuando alguien hace "from algebra_lineal import *"
+__all__ = [
+    'configurar',
+    'workspace',
+    'importar',
+    'exportar',
+    'cambiar_sheet',
+    'ayuda',
+    'version',
+    'listar_variables_exportables'
+]
+
+# Metadatos del paquete (IMPORTANTE: mantener sincronizado con pyproject.toml)
+__version__ = "1.0.0"
+__author__ = "Francisco Pérez Mogollón"
+__email__ = "fperez9@utpl.edu.ec"
+__description__ = "Álgebra lineal simplificada con integración a Google Sheets"
+__url__ = "https://pypi.org/project/algebra-lineal-sheets/"
+
+# Mensaje de bienvenida al importar (más profesional para PyPI)
+print("📚 ALGEBRA LINEAL v1.0.0")
+print("🎓 Para estudiantes de álgebra lineal")
+print("🔧 Ejecuta: configurar() para empezar")
+print("📖 Ayuda completa: ayuda()")
+print("🔗 PyPI: https://pypi.org/project/algebra-lineal-sheets/")
+
+# Función de conveniencia para verificar instalación
+
+
+def verificar_instalacion():
+    """
+    Verifica que el paquete esté instalado correctamente.
+    """
+    try:
+        import numpy
+        import gspread
+        from google.auth import default
+        print("✅ Todas las dependencias están instaladas correctamente")
+        print("🚀 ¡Listo para usar algebra_lineal!")
+        return True
+    except ImportError as e:
+        print(f"❌ Error: Dependencia faltante - {e}")
+        print("💡 Ejecuta: pip install --upgrade algebra-lineal-sheets")
+        return False