Commentaires

main.py

@@ -45,8 +45,10 @@ def ftpwalk(directory, ftp):
 
 def visit_folder(domain, api, rules, tok):
     """
-    Visite un dossier sur un serveur,
-    et ajoute les fichiers trouvés à l'API
+    Visite un dossier sur un serveur, spécifié par <domain>,
+    et ajoute les fichiers qui vérifient les règles <rules>,
+    à l'API par l'interface <api>, tout en filtrant les tokens
+    trouvés dans le nom des fichiers avec l'interface <tok>
     """
     # Connection au serveur
     print('connect to:', domain['server'])
@@ -100,6 +102,10 @@ def visit_folder(domain, api, rules, tok):
     print('visit finished ',domain['server']+domain['path'])
 
 def handle_films(Lfilm_loc, Lfilm_api, domain, api, rules, tok):
+    """
+    Utilise les listes des fichiers locaux Lfilm_loc et des fichiers de l'API Lfilm_api
+    pour mettre à jour la liste des films de l'api sur le domaine <domain>
+    """
     Lloc = Lfilm_loc
     Lapi = Lfilm_api
 
@@ -277,6 +283,10 @@ def handle_films(Lfilm_loc, Lfilm_api, domain, api, rules, tok):
     # TODO: traiter les films non postés (Lcannot_post)
 
 def handle_episodes(Lepisode_loc, Lepisode_api, domain, api, rules, tok):
+    """
+    Utilise les listes des fichiers locaux Lepisode_loc et des fichiers de l'API Lepisode_api
+    pour mettre à jour la liste des episodes et des series de l'api sur le domaine <domain>
+    """
     Lloc = Lepisode_loc
     Lapi = Lepisode_api
 
@@ -383,20 +393,30 @@ def handle_episodes(Lepisode_loc, Lepisode_api, domain, api, rules, tok):
 
 
 def post_markers(api, file_, fileid):
+    """
+    Poste sur l'api par l'interface <api> tout les marqueurs
+    du fichier <file_>, indexé à l'ID <fileid>
+    """
     for lang in file_.markers['lang']:
         api.post_file_language(fileid, lang)
-        time.sleep(0.5)
+        time.sleep(1)
     for qual in file_.markers['quality']:
         api.post_file_qualities(fileid, qual)
-        time.sleep(0.5)
+        time.sleep(1)
     for sub in file_.markers['subtitle']:
         api.post_file_subtitle(fileid, sub)
-        time.sleep(0.5)
+        time.sleep(1)
 
 def main():
+    """
+    Fonction principale du programme, réalise toute les opérations
+    de chargement des configurations, d'initialisation des interfaces,
+    et parcours tout les dossiers cherchables.
+    """
     conf = config.Config()
     api = piexel.Piexel(conf.server, conf.app, conf.token)
     tokens = tokenizer.Tokenizer(conf, api)
+    
     folders = api.get_folders()
     rules = api.get_paths()