From 48482f8c31ce4b6e89311d9e3f4546ab31cc6db7 Mon Sep 17 00:00:00 2001
From: Fred Pauchet <fred@grimbox.be>
Date: Sun, 27 Sep 2020 20:22:20 +0200
Subject: [PATCH] Some ideas added to models.py.

---
 src/planning/models.py | 36 ++++++++++++++++++++++++++----------
 1 file changed, 26 insertions(+), 10 deletions(-)

diff --git a/src/planning/models.py b/src/planning/models.py
index e94419b..858a08d 100644
--- a/src/planning/models.py
+++ b/src/planning/models.py
@@ -1,18 +1,22 @@
-# coding=UTF-8
 
-from django.db import models
+from datetime import datetime, date, time, timedelta
+
 from django.contrib.auth.models import User
-from datetime import datetime, date, time
-from base.models import Markdownizable
+from django.db import models
 from django.utils import timezone
-from people.models import Gymnast
-from location.models import Club
-from datetime import datetime, timedelta
 import pendulum
 
+from base.models import Markdownizable
+from location.models import Club
+from people.models import Gymnast
+
 
 def get_week(a_date):
     """
+
+    Remarks:
+        Je ne comprends pas trop cette fonction...
+        Tu pars d'une date, et tu récupères le lundi et le samedi de la semaine correspondant ?
     """
     the_date = pendulum.parse(a_date)
     day = the_date.weekday()
@@ -33,6 +37,18 @@ def get_number_of_weeks_between(start, stop):
     :param stop: date de fin de la période
     :type stop: datetime.date
     :return: Le nombre de semaines entre les deux dates.
+
+    Remarks:
+        Proposition d'utiliser isocalendar() sur une date.
+        L'indice 1 de la valeur de retour donne la semaine correspondant.
+
+        Eg.
+            >>> from datetime import date
+            >>> d = date(2020, 9, 27)
+            >>> d.isocalendar()
+            (2020, 39, 7)
+
+        -> Est-ce qu'il ne suffirait pas de faire la différence ?
     """
 
     tmp = stop - start
@@ -87,9 +103,9 @@ class TemporizableQuerySet(models.QuerySet):
 
 
 class Temporizable(models.Model):
-    """
-    Classe abstraite définissant deux dates (une da te de début, une date de
-    fin) et des méthodes de calculs sur base de ces dates.
+    """Classe abstraite définissant une période comprise entre deux dates.
+
+    Des méthodes de calculs sur base de ces dates.
     """
 
     class Meta: