Merge pull request #80 from moevm/76-create-interface-for-wrapper-over-pygithub

Создание интерфейса для обёртки

Author: thehighestmath

interface_wrapper.py

@@ -0,0 +1,125 @@
+from abc import ABC, abstractmethod
+from datetime import datetime
+from dataclasses import dataclass
+import logging
+
+# Настройка логирования
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(levelname)s - %(message)s"
+)
+
+# Модельные классы
+@dataclass
+class Repository:
+    _id: str
+    name: str
+    url: str
+
+@dataclass
+class Contributor:
+    username: str
+    email: str
+
+@dataclass
+class Commit:
+    _id: str
+    message: str
+    author: Contributor
+    date: datetime
+
+@dataclass
+class Issue:
+    _id: str
+    title: str
+    author: Contributor
+    state: str
+
+@dataclass
+class PullRequest:
+    _id: str
+    title: str
+    author: Contributor
+    state: str
+
+@dataclass
+class WikiPage:
+    title: str
+    content: str
+
+@dataclass
+class Branch:
+    name: str
+    last_commit: Commit | None
+
+# Интерфейс API
+class IRepositoryAPI(ABC):
+    @abstractmethod
+    def get_repository(self, id: str) -> Repository | None:
+        """Получить репозиторий по его идентификатору."""
+        pass
+
+    @abstractmethod
+    def get_commits(self, repo: Repository) -> list[Commit]:
+        """Получить список коммитов для репозитория."""
+        pass
+
+    @abstractmethod
+    def get_contributors(self, repo: Repository) -> list[Contributor]:
+        """Получить список контрибьюторов для репозитория."""
+        pass
+
+    @abstractmethod
+    def get_issues(self, repo: Repository) -> list[Issue]:
+        """Получить список issues для репозитория."""
+        pass
+
+    @abstractmethod
+    def get_pull_requests(self, repo: Repository) -> list[PullRequest]:
+        """Получить список pull requests для репозитория."""
+        pass
+
+    @abstractmethod
+    def get_branches(self, repo: Repository) -> list[Branch]:
+        """Получить список веток для репозитория."""
+        pass
+    
+    @abstractmethod
+    def get_wiki_pages(self, repo: Repository) -> list[WikiPage]:
+        """Получить список wiki-страниц для репозитория."""
+        pass
+   
+
+# Фабрика для создания API
+class RepositoryFactory:
+    @staticmethod
+    def create_api(source: str, client) -> IRepositoryAPI:
+        if client is None:
+            raise ValueError("Client cannot be None")
+        if source == 'github':
+            return GitHubRepoAPI(client)
+        elif source == 'forgejo':
+            return ForgejoRepoAPI(client)
+        else:
+            raise ValueError(f"Unsupported source: {source}")
+
+# Сервис для расчёта метрик
+class CommitmentCalculator:
+    def __init__(self, api: IRepositoryAPI):
+        self.api = api
+
+    def calculate(self, repo: Repository) -> dict[str, int]:
+        if not repo:
+            return {}
+        try:
+            commits = self.api.get_commits(repo)
+            if not commits:
+                return {}
+            result = {}
+            for commit in commits:
+                author = commit.author.username
+                result[author] = result.get(author, 0) + 1
+            return result
+        except Exception as e:
+            logging.error(f"Failed to calculate commitment for repo {repo.name}: {e}")
+            return {}