feature: added bus factor

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

@@ -3,6 +3,7 @@
 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
 
@@ -86,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/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();