Merge pull request #16 from n0rfas/release-0_1_14

Release 0.1.14

Author: n0rfas

git_analytics/analyzers/__init__.py

@@ -1,4 +1,5 @@
 from .authors_statistics import AuthorsStatisticsAnalyzer
+from .bus_factor_post import bus_factor_post
 from .commit_type import CommitTypeAnalyzer
 from .commits_summary import CommitsSummaryAnalyzer
 from .historical_statistics import HistoricalStatisticsAnalyzer
@@ -7,6 +8,7 @@
 
 __all__ = [
     "AuthorsStatisticsAnalyzer",
+    "bus_factor_post",
     "CommitTypeAnalyzer",
     "CommitsSummaryAnalyzer",
     "HistoricalStatisticsAnalyzer",

git_analytics/analyzers/bus_factor_post.py

@@ -0,0 +1,27 @@
+from typing import Any, Dict
+
+
+def _bus_factor(contributions: Dict[str, int], threshold: float = 0.5) -> int:
+    total = sum(contributions.values())
+    acc = 0
+    for _, lines in sorted(contributions.items(), key=lambda x: x[1], reverse=True):
+        acc += lines
+        if acc / total >= threshold:
+            return len([a for a in contributions if contributions[a] >= lines])
+    return 1
+
+
+def bus_factor_post(data: Dict[str, Any]) -> int:
+    author_lines = dict(data.get("authors_statistics", {})).get("authors")
+
+    if author_lines:
+        author_data = {}
+        for author, item in author_lines.items():
+            author_data[author] = item.get("insertions", 0) + item.get("deletions", 0)
+
+        if len(author_data) < 2:
+            return 1
+
+        return _bus_factor(author_data)
+
+    return 1

git_analytics/engine.py

@@ -1,10 +1,58 @@
+import os
 from datetime import date, timezone
-from typing import Any, Dict, Optional
+from pathlib import Path
+from typing import Any, Dict, Optional, Tuple
 
+from git_analytics.analyzers import bus_factor_post
 from git_analytics.entities import AnalyticsResult
 from git_analytics.interfaces import CommitSource
 
 
+class FileAnalyticsEngine:
+    def __init__(self, repo_path: str = "."):
+        self.repo_path = repo_path
+
+    def run(self) -> Dict[str, Tuple[int, int]]:
+        stats: Dict[str, Tuple[int, int]] = {}
+
+        repo_path = Path(self.repo_path).resolve()
+
+        ignore_dirs = {
+            ".git",
+            "__pycache__",
+            "node_modules",
+            ".venv",
+            "venv",
+            "htmlcov",
+            ".pytest_cache",
+            ".mypy_cache",
+            "dist",
+            "build",
+        }
+
+        for root, dirs, files in os.walk(repo_path):
+            dirs[:] = [d for d in dirs if d not in ignore_dirs]
+
+            for file in files:
+                file_path = Path(root) / file
+
+                extension = file_path.suffix if file_path.suffix else "(no extension)"
+
+                try:
+                    with open(file_path, "r", encoding="utf-8") as f:
+                        line_count = sum(1 for _ in f)
+                except (UnicodeDecodeError, PermissionError, OSError):
+                    line_count = 0
+
+                if extension in stats:
+                    file_count, total_lines = stats[extension]
+                    stats[extension] = (file_count + 1, total_lines + line_count)
+                else:
+                    stats[extension] = (1, line_count)
+
+        return dict(sorted(stats.items()))
+
+
 class CommitAnalyticsEngine:
     def __init__(
         self,
@@ -39,6 +87,11 @@ def run(
                 analyzer.process(commit)
 
         result = {analyzer.name: analyzer.result() for analyzer in analyzers}
+
+        # post-process
+        result["post_data"] = {}
+        result["post_data"]["bus_factor"] = bus_factor_post(result)
+
         if self._additional_data:
             result["additional_data"] = self._additional_data
         return result

git_analytics/main.py

@@ -11,7 +11,7 @@
     LanguageAnalyzer,
     LinesAnalyzer,
 )
-from git_analytics.engine import CommitAnalyticsEngine
+from git_analytics.engine import CommitAnalyticsEngine, FileAnalyticsEngine
 from git_analytics.sources import GitCommitSource
 from git_analytics.web_app import create_web_app
 
@@ -36,10 +36,12 @@ def run():
         print("Error: Current directory is not a git repository.")
         return
 
+    extension_stats = FileAnalyticsEngine().run()
+
     engine = CommitAnalyticsEngine(
         source=GitCommitSource(repo),
         analyzers_factory=make_analyzers,
-        additional_data={"name_branch": name_branch},
+        additional_data={"name_branch": name_branch, "extension_stats": extension_stats},
     )
 
     web_app = create_web_app(engine=engine)

git_analytics/static/index.html

@@ -90,6 +90,21 @@ <h2>Overview</h2>
                                 </div>
                             </div>
                         </div>
+                        <div class="col-md-2">
+                            <div class="card h-100 w-100">
+                                <div class="card-header">
+                                    <span>Bus Factor</span>
+                                    <i class="bi bi-info-circle"
+                                        data-bs-toggle="tooltip"
+                                        data-bs-placement="right"
+                                        title="The bus factor is a measurement of the risk resulting from information and capabilities not being shared among team members. It indicates the minimum number of developers that have to leave a project before the project becomes incapacitated.">
+                                    </i>
+                                </div>
+                                <div class="card-body">
+                                    <span id="busFactor"></span>
+                                </div>
+                            </div>
+                        </div>
                     </div>
                     <div class="row mt-4">
                         <div class="col-md-12">
@@ -320,7 +335,7 @@ <h2>Commits</h2>
     <!-- footer -->
     <footer class="bg-dark text-white py-3 mt-auto">
         <div class="container">
-            <span>&copy; 2025 ver 0.1.14</span>
+            <span>&copy; 2026 ver 0.1.14</span>
         </div>
     </footer>
 

git_analytics/static/js/git-analytics.js

@@ -64,6 +64,7 @@ async function loadAndRender(type, value, timeIntervalLabel) {
 
     // render stats
     renderGeneralStatistics(stats, timeIntervalLabel);
+    renderBusFactor(stats);
     renderWeeklyCommitTypes(stats.commit_type.commit_type_by_week);
 
     renderInsDelLinesByAuthors(stats.authors_statistics.authors);
@@ -158,6 +159,24 @@ function renderGeneralStatistics(stats, rangeLabel) {
   `;
 }
 
+function renderBusFactor(stats) {
+  const busFactorEl = document.getElementById("busFactor");
+  busFactorVal= stats.post_data.bus_factor;
+  
+  let colorClass = "text-success";
+  if (busFactorVal === 1) {
+    colorClass = "text-danger";
+  } else if (busFactorVal === 2) {
+    colorClass = "text-warning";
+  }
+  
+  busFactorEl.innerHTML = `
+    <div class="d-flex align-items-center justify-content-center h-100">
+      <strong class="h1 ${colorClass}">${busFactorVal}</strong> 
+    </div>
+  `;
+}
+
 function renderChart(id, config) {
   if (CHARTS[id]) {
     CHARTS[id].destroy();