220126a

Author: Jose Luis Chiquete

.gitignore

@@ -60,6 +60,7 @@ coverage.xml
 local_settings.py
 db.sqlite3
 db.sqlite3-journal
+db.alumnos.sql
 
 # Flask stuff:
 instance/

apiflaskdemo/app.py

@@ -5,15 +5,27 @@
 from sqlalchemy import engine, inspect
 
 def create_app():
+    '''Función principal de la aplicación'''
+    # Crear el objeto app
     app = APIFlask(__name__)
+    
+    # Obtener la configuración de la aplicación a partir de settings.py
     app.config.from_pyfile("settings.py")
-    db.init_app(app)  
+    
+    # Se incializa la conexión entre SQLALchemy y la base de datos
+    db.init_app(app) 
+    
     @app.before_first_request
     def crea_bases():
+        '''Función encargada de verificar que exista una base de datos  con
+           las tablas de alumnos y de usuarios pobladas correctamente. 
+            En caso de no existir, es creada'''
+         
+        # Verifica que exista la tabla alumno en la base de datos
         inspector = inspect(db.engine)
         if not inspector.has_table('alumno'):
-            db.create_all()
             # Crea y llena la base de alumno.
+            db.create_all()
             with open(app.config['PATH'] + "/../data/alumnos.txt", "rt") as f:
                 alumnos = eval(f.read())
                 for alumno in alumnos:
@@ -22,15 +34,23 @@ def crea_bases():
                     else:
                         db.session.add(Alumno(**alumno))
                 db.session.commit()
+                
+            # Verifica que exista el usuario admin y lo crea si no es así 
             if not User.query.filter_by(username="admin"):
-                user = User(username='admin', email='example@example.com',password='admin', active=True)
+                user = User(username='admin',
+                           email='example@example.com',
+                           password='admin', 
+                           active=True)
                 db.session.add(user)
-                db.session.commit() 
+                db.session.commit()
+                
+    # Registra los blueprints con los endpoints
     app.register_blueprint(abc_alumnos, url_prefix='/api')
     app.register_blueprint(auth_bp, url_prefix='/auth')
+    
+    #Regresa la aplicación
     return app
 
-app = create_app()
-
 if __name__ == '__main__':
+    app = create_app()
     app.run(host='0.0.0.0', port=3000, debug=True)

apiflaskdemo/db.alumnos.sql

@@ -22,11 +22,12 @@ def test_existe_admin(base_conectada):
 
 def test_existe_tabla_alumnos(base_conectada):
     print('Probando que existan alumnos...')
-    assert len(Alumno.query.all())
-
-
+    assert Alumno.query.all()
+    
+    
 def test_datos_correctos_alumnos(base_conectada):
     print('Probando que los datos de los alumnos sean correctos..')
+    
     def object_as_dict(obj):
         return {c.key: getattr(obj, c.key)
             for c in inspect(obj).mapper.column_attrs}