Se agregan comentarios para generar secciones o capitulos en el código

Author: LuisOlivaresJ

Roadmap/26 - SOLID SRP/python/LuisOlivaresJ.py

@@ -1,8 +1,11 @@
+# ---------------------------------------------
 # Ejemplo de Principio de responsabilidad única
-# """
+# ---------------------------------------------
 
 # El siguiente ejemplo muestra un código que viola el principio de responsabilidad única.
-# La clase ImageManager tiene dos responsabilidades: obtener estadísticas de una imagen y graficarla.
+# La clase ImageManager tiene dos responsabilidades: 
+#   1.- Obtener estadísticas de una imagen
+#   2.- Graficar una imagen
 
 import matplotlib.pyplot as plt
 import numpy as np
@@ -47,10 +50,13 @@ def plot(self):
         plt.show()
 
 
-
-
+# ---------------------------------------------
 # Dificultad extra
 # Sistema de gestion para una bibioteca
+#
+# FORMA INCORRECTA
+#
+# ---------------------------------------------
 
 logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(message)s")
 
@@ -130,6 +136,8 @@ def return_book(self, title: str, name: str):
 
 
 # Testing the class
+print("\n"*3)
+print("### Testing: Dificultad extra (FORMA INCORRECTA)\n")
 my_library = Library()
 my_library.add_user("Alice", 1, "alice@dev")
 my_library.add_user("Bob", 2, "bob@dev")
@@ -152,6 +160,16 @@ def return_book(self, title: str, name: str):
 my_library.print_users()
 
 
+# ---------------------------------------------
+# Dificultad extra
+# Sistema de gestion para una bibioteca
+#
+# Forma CORRECTA
+# 
+# Se crean dos clases diferentes, BooksManager y UsersManager, para manejar los libros y a los usuarios.
+# Se crea una clase que maneja la biblioteca y delega las responsabilidades a las clases BooksManeger y UsersManager.
+# ---------------------------------------------
+
 class BooksManeger:
     def __init__(self):
         self.books = []
@@ -248,9 +266,10 @@ def return_book(self, title: str, name: str):
         self.books_m.return_book(title)
         self.users_m.return_book(title, name)
 
-print("\n"*3)
-print("### Testing: Dificultad extra\n")
+
 # Testing the classes
+print("\n"*3)
+print("### Testing: Dificultad extra (FORMA CORRECTA)\n")
 
 my_library_v2 = Library_v2()
 my_library_v2.add_user("Alice", 1, "alice@dev")