feat overlapping time frames

Author: danielorlando97

src/persistence/models.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass
 
 class Model:
-    """Root of class """
+    """Root of class hierarchy"""
 
 @dataclass
 class StudentModel(Model):

src/use_cases/scholar_time_by_students.py

@@ -3,10 +3,10 @@
 
 class PersistenceScholarTimeProtocol(Protocol):
     def student_names(self) -> Iterable[str]:
-        """"""
+        """It should return an iterable with the names of students in the system"""
 
     def student_presence_group_by_day(self, student_name) -> Dict[int, List]:
-        """It should check when the segments intercept between them"""
+        """It should return each student's presence group by the presence days"""
 
 def run(
     repo: PersistenceScholarTimeProtocol
@@ -17,10 +17,31 @@ def run(
         days, delta = 0, 0
         for presences in group_by_day.values():
             days += 1
-            delta += sum([item.delta_time for item in presences])
+
+            # In the database, there may be errors and overlapping presence instances,
+            # so that the total number of minutes cannot be calculated with a simple sum. 
+            presences.sort(key=lambda x:x.start_min)
+            # Each key in the dict meads a day where the student went to the school
+            # So, there are minimaly a presente instance 
+            pivot = presences[0] 
+            delta += pivot.delta_time
+            for item in presences[1:]:
+                if pivot.end_min <= item.start_min:
+                    # The student went out and then came back in. Example by symbols ()[]
+                    delta += item.delta_time
+                elif pivot.end_min < item.end_min:
+                    # entered twice and then exited twice more. Example by symbols ([)]
+                    print("Warning: The information might be incomplete")
+                    delta += item.end_min - pivot.end_min
+                else:
+                    # One presence is a subprocense of the other Example by symbols ([])
+                    print("Warning: The information might be incomplete")
+                    continue
+
+                pivot = item
+                    
 
         if days == 0:
-            print(f'{student}: 0 minutes')
+            yield f'{student}: 0 minutes'
         else:
-            print(
-                f'{student}: {delta} minutes in {days} day{"" if days == 1 else "s"}')
+            yield f'{student}: {delta} minutes in {days} day{"" if days == 1 else "s"}'