merge: merge pull request #17 from n0rfas/dev - 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/favicon-16x16.png

@@ -2,11 +2,22 @@
 <html lang="en">
 <head>
     <meta charset="utf-8" />
-    <title>Git Analytics</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
     <meta name="viewport" content="width=device-width, initial-scale=1" />
+
+    <title>Git-Analytics</title>
+    <meta name="description" content="Advanced analytics for Git repositories — commits, authors, code churn, lines of code, trends, and visual dashboards.">
+    
+    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
+    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
     <link rel="icon" href="/favicon.svg" type="image/svg+xml">
+
     <link href="css/bootstrap.min.css" rel="stylesheet">
     <link href="css/bootstrap-icons.min.css" rel="stylesheet">
+
+    <script src="js/bootstrap.bundle.min.js" defer></script>
+    <script src="js/chart.umd.min.js" defer></script>
+    <script src="js/git-analytics.js" defer></script>
 </head>
 <body class="d-flex flex-column min-vh-100">
     <!-- top menu -->
@@ -79,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">
@@ -263,7 +289,7 @@ <h2>Commits</h2>
                                     </i>
                                 </div>
                                 <div class="card-body">
-                                    <canvas id="chartDay"></canvas>
+                                    <canvas id="chartCommitsByHour"></canvas>
                                 </div>
                             </div>
                         </div>
@@ -280,7 +306,7 @@ <h2>Commits</h2>
                                     </i>
                                 </div>
                                 <div class="card-body">
-                                    <canvas id="chartWeek"></canvas>
+                                    <canvas id="chartCommitsByWeekday"></canvas>
                                 </div>
                             </div>
                         </div>
@@ -297,7 +323,7 @@ <h2>Commits</h2>
                                     </i>
                                 </div>
                                 <div class="card-body">
-                                    <canvas id="chartMonth"></canvas>
+                                    <canvas id="chartCommitsByDayOfMonth"></canvas>
                                 </div>
                             </div>
                         </div>
@@ -309,12 +335,10 @@ <h2>Commits</h2>
     <!-- footer -->
     <footer class="bg-dark text-white py-3 mt-auto">
         <div class="container">
-            <span>&copy; 2025 ver 0.1.13</span>
+            <span>&copy; 2026 ver 0.1.14</span>
         </div>
     </footer>
-    <script src="js/bootstrap.bundle.min.js"></script>
-    <script src="js/chart.umd.min.js"></script>
-    <script src="js/git-analytics.js"></script>
+
     <script>
         const views = document.querySelectorAll('.view');
         const nav = document.getElementById('sidebarNav');

git_analytics/static/favicon-32x32.png

@@ -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();
@@ -284,7 +303,7 @@ function buildHourByAuthorChart(hourOfDayData) {
       return Object.values(byAuthor).reduce((s, v) => s + v, 0);
     });
 
-    renderChart("chartDay", {
+    renderChart("chartCommitsByHour", {
       type: "bar",
       data: { labels: HOUR_LABELS, datasets: [{
         label: "Total",
@@ -315,7 +334,7 @@ function buildHourByAuthorChart(hourOfDayData) {
     backgroundColor: getAuthorColor(author),
   }));
 
-  renderChart("chartDay", {
+  renderChart("chartCommitsByHour", {
     type: "bar",
     data: { labels: HOUR_LABELS, datasets },
     options: {
@@ -378,7 +397,7 @@ function buildWeekByAuthorChart(dayOfWeekData) {
       Object.values(dayOfWeekData[d] || {}).reduce((s, v) => s + v, 0)
     );
 
-    renderChart("chartWeek", {
+    renderChart("chartCommitsByWeekday", {
       type: "bar",
       data: {
         labels: WEEK_LABELS,
@@ -412,7 +431,7 @@ function buildWeekByAuthorChart(dayOfWeekData) {
     backgroundColor: getAuthorColor(author),
   }));
 
-  renderChart("chartWeek", {
+  renderChart("chartCommitsByWeekday", {
     type: "bar",
     data: { labels: WEEK_LABELS, datasets },
     options: {
@@ -446,7 +465,7 @@ function buildDayOfMonthByAuthorChart(dayOfMonthData) {
       Object.values(dayOfMonthData[d] || {}).reduce((s, v) => s + v, 0)
     );
 
-    renderChart("chartMonth", {
+    renderChart("chartCommitsByDayOfMonth", {
       type: "bar",
       data: {
         labels: DAY_LABELS,
@@ -480,7 +499,7 @@ function buildDayOfMonthByAuthorChart(dayOfMonthData) {
     backgroundColor: getAuthorColor(author),
   }));
 
-  renderChart("chartMonth", {
+  renderChart("chartCommitsByDayOfMonth", {
     type: "bar",
     data: { labels: DAY_LABELS, datasets },
     options: {

git_analytics/static/index.html

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "git-analytics"
-version = "0.1.13"
+version = "0.1.14"
 description = "Advanced analytics for Git repositories — commits, authors, code churn, lines of code, trends, and visual dashboards."
 authors = ["n0rfas <n0rfas@protonmail.com>"]
 license = "MIT"