Добавил строки документации

api/clockify.py

@@ -21,10 +21,11 @@ class ClockifyAPI(ClockifyConfig):
 
     def get_activities(self, **kwargs) -> list[Activity]:
         """
-        start: datetime - Начальная дата (обязательно)
-        end: datetime - Конечная дата (обязательно)
-        page: int - Номер страницы
-        page-size: int - Размер страницы (по умолчанию 50)
+        Получает с сервера Clockify активности за определнный период
+            start: datetime - Начальная дата (обязательно)
+            end: datetime - Конечная дата (обязательно)
+            page: int - Номер страницы
+            page-size: int - Размер страницы (по умолчанию 50)
         """
         time_entries_url = self.time_entries_url
         activities = requests.get(self.base_url + time_entries_url, params=kwargs, headers={"X-API-KEY": self.token}).json()
@@ -67,8 +68,9 @@ class ClockifyAPI(ClockifyConfig):
 
     def get_tags(self, **kwargs) -> list[Tag]:
         """
-        name: str - optional
-        archived: bool - optional
+        Получает с сервера Clockify теги
+            name: str - optional
+            archived: bool - optional
         """
         tags = requests.get(self.base_url + self.tags_url, params=kwargs, headers={"X-API-KEY": self.token}).json()
         return [Tag(
@@ -77,6 +79,9 @@ class ClockifyAPI(ClockifyConfig):
         ) for tag in tags]
     
     def get_vetro_projects(self) -> list[VetroProject]:
+        """
+        Получает с сервера Clockify Проекты (ДО) Ветро
+        """
         projects = requests.get(self.base_url + self.projects_url, headers={"X-API-KEY": self.token}).json()
         for project in projects:
             if not project.get("archived"):
@@ -87,6 +92,9 @@ class ClockifyAPI(ClockifyConfig):
                 ) for vetro_project in vetro_projects]
     
     def mark_tracked(self, activities: list[Activity]):
+        """
+        Помечает активности затреканными (Billable) на сервере Clockify
+        """
         for activity in activities:
             try:
                 resp = requests.put(
@@ -115,6 +123,7 @@ class ClockifyAPI(ClockifyConfig):
                 return
 
     def _check_token(self, token: str) -> str:
+        """Проверяет токен"""
         resp = requests.get(self.base_url + self.user_url, headers={"X-API-KEY": token})
         if not resp.ok:
             logger.error(resp.json())
@@ -124,6 +133,7 @@ class ClockifyAPI(ClockifyConfig):
         return token
 
     def getenvs(self):
+        """Получает нужные USER_ID и WORKSPACE_ID с сервера Clockify"""
         resp = requests.get(self.base_url + self.user_url, headers={"X-API-KEY": self.token})
         if not resp.ok:
             logger.error(resp.json())

api/redmine.py

@@ -22,6 +22,7 @@ class RedmineAPI(RedmineConfig):
         self.token = self._check_token(token) 
 
     def track_activities(self, activities: list[Activity]) -> list[Activity]:
+        """Заносит трудочасы на сервер Redmine"""
         if len(activities) == 0:
             logger.info(Fore.YELLOW + "Нет задач для занесения трудочасов" + Fore.RESET)
             return
@@ -60,6 +61,7 @@ class RedmineAPI(RedmineConfig):
         return tracked
     
     def get_time_entry_activities(self) -> list[ActivityTypes]:
+        """Получает виды Деятельности с сервера Redmine"""
         resp = requests.get(self.base_url + self.time_entry_activities, headers={"X-Redmine-API-KEY": self.token})
         logging.debug(resp.json())
         if resp.ok:
@@ -70,6 +72,7 @@ class RedmineAPI(RedmineConfig):
             ]
 
     def _check_token(self, token):
+        """Проверяет токен"""
         resp = requests.get(self.base_url + self.my_account_url, headers={"X-Redmine-Api-Key": token})
         if not resp.ok:
             logger.error("Invalid Token for RedmineAPI")