greenmining 1.0.6__py3-none-any.whl → 1.0.8__py3-none-any.whl

greenmining/__init__.py

@@ -9,7 +9,7 @@ from greenmining.gsf_patterns import (
     is_green_aware,
 )
 
-__version__ = "1.0.6"
+__version__ = "1.0.8"
 
 
 def fetch_repositories(
@@ -18,6 +18,10 @@ def fetch_repositories(
     min_stars: int = None,
     languages: list = None,
     keywords: str = None,
+    created_after: str = None,
+    created_before: str = None,
+    pushed_after: str = None,
+    pushed_before: str = None,
 ):
     # Fetch repositories from GitHub with custom search keywords.
     config = Config()
@@ -29,6 +33,10 @@ def fetch_repositories(
         min_stars=min_stars,
         languages=languages,
         keywords=keywords,
+        created_after=created_after,
+        created_before=created_before,
+        pushed_after=pushed_after,
+        pushed_before=pushed_before,
     )
 
 

greenmining/controllers/repository_controller.py

@@ -1,26 +1,5 @@
 # Repository Controller - Handles repository fetching operations.
 
-# ============================================================================
-# OLD REST API IMPLEMENTATION (DEADCODE - REPLACED WITH GRAPHQL)
-# ============================================================================
-# from github import Github, GithubException
-# from tqdm import tqdm
-#
-# from greenmining.config import Config
-# from greenmining.models.repository import Repository
-# from greenmining.utils import colored_print, load_json_file, save_json_file
-#
-#
-# class RepositoryController:
-#     # Controller for GitHub repository operations.
-#
-#     def __init__(self, config: Config):
-#         # Initialize controller with configuration.
-#         self.config = config
-#         self.github = Github(config.GITHUB_TOKEN)
-# ============================================================================
-
-# NEW GRAPHQL IMPLEMENTATION (5-10x faster)
 from tqdm import tqdm
 
 from greenmining.config import Config
@@ -37,80 +16,6 @@ class RepositoryController:
         self.config = config
         self.graphql_fetcher = GitHubGraphQLFetcher(config.GITHUB_TOKEN)
 
-    # ============================================================================
-    # OLD REST API METHOD (DEADCODE - 10x slower, high rate limit cost)
-    # ============================================================================
-    # def fetch_repositories(
-    #     self,
-    #     max_repos: int = None,
-    #     min_stars: int = None,
-    #     languages: list[str] = None,
-    #     keywords: str = None,
-    #     created_after: str = None,
-    #     created_before: str = None,
-    #     pushed_after: str = None,
-    #     pushed_before: str = None,
-    # ) -> list[Repository]:
-    #     # Fetch repositories from GitHub using REST API (slow).
-    #     max_repos = max_repos or self.config.MAX_REPOS
-    #     min_stars = min_stars or self.config.MIN_STARS
-    #     languages = languages or self.config.SUPPORTED_LANGUAGES
-    #     keywords = keywords or "microservices"
-    #
-    #     colored_print(f" Fetching up to {max_repos} repositories...", "cyan")
-    #     colored_print(f"   Keywords: {keywords}", "cyan")
-    #     colored_print(f"   Filters: min_stars={min_stars}", "cyan")
-    #
-    #     if created_after or created_before:
-    #         colored_print(
-    #             f"   Created: {created_after or 'any'} to {created_before or 'any'}", "cyan"
-    #         )
-    #     if pushed_after or pushed_before:
-    #         colored_print(f"   Pushed: {pushed_after or 'any'} to {pushed_before or 'any'}", "cyan")
-    #
-    #     # Build search query with temporal filters
-    #     query = self._build_temporal_query(
-    #         keywords, min_stars, created_after, created_before, pushed_after, pushed_before
-    #     )
-    #
-    #     try:
-    #         # Execute search (REST API - many requests)
-    #         search_results = self.github.search_repositories(
-    #             query=query, sort="stars", order="desc"
-    #         )
-    #
-    #         total_found = search_results.totalCount
-    #         colored_print(f"   Found {total_found} repositories", "green")
-    #
-    #         # Fetch repositories (1 request per repo = slow)
-    #         repositories = []
-    #         with tqdm(total=min(max_repos, total_found), desc="Fetching", unit="repo") as pbar:
-    #             for idx, repo in enumerate(search_results):
-    #                 if idx >= max_repos:
-    #                     break
-    #
-    #                 try:
-    #                     repo_model = Repository.from_github_repo(repo, idx + 1)
-    #                     repositories.append(repo_model)
-    #                     pbar.update(1)
-    #                 except GithubException as e:
-    #                     colored_print(f"   Error: {repo.full_name}: {e}", "yellow")
-    #                     continue
-    #
-    #         # Save to file
-    #         repo_dicts = [r.to_dict() for r in repositories]
-    #         save_json_file(repo_dicts, self.config.REPOS_FILE)
-    #
-    #         colored_print(f" Fetched {len(repositories)} repositories", "green")
-    #         colored_print(f"   Saved to: {self.config.REPOS_FILE}", "cyan")
-    #
-    #         return repositories
-    #
-    #     except Exception as e:
-    #         colored_print(f" Error fetching repositories: {e}", "red")
-    #         raise
-    # ============================================================================
-
     def fetch_repositories(
         self,
         max_repos: int = None,
@@ -122,13 +27,13 @@ class RepositoryController:
         pushed_after: str = None,
         pushed_before: str = None,
     ) -> list[Repository]:
-        # Fetch repositories from GitHub using GraphQL API (5-10x faster).
+        # Fetch repositories from GitHub using GraphQL API.
         max_repos = max_repos or self.config.MAX_REPOS
         min_stars = min_stars or self.config.MIN_STARS
         languages = languages or self.config.SUPPORTED_LANGUAGES
         keywords = keywords or "microservices"
 
-        colored_print(f"🚀 Fetching up to {max_repos} repositories (GraphQL API)...", "cyan")
+        colored_print(f"Fetching up to {max_repos} repositories...", "cyan")
         colored_print(f"   Keywords: {keywords}", "cyan")
         colored_print(f"   Filters: min_stars={min_stars}", "cyan")
 
@@ -140,7 +45,7 @@ class RepositoryController:
             colored_print(f"   Pushed: {pushed_after or 'any'} to {pushed_before or 'any'}", "cyan")
 
         try:
-            # Use GraphQL API (much faster!)
+            # Execute GraphQL search
             repositories = self.graphql_fetcher.search_repositories(
                 keywords=keywords,
                 max_repos=max_repos,
@@ -156,51 +61,15 @@ class RepositoryController:
             repo_dicts = [r.to_dict() for r in repositories]
             save_json_file(repo_dicts, self.config.REPOS_FILE)
 
-            colored_print(f"✓ Fetched {len(repositories)} repositories", "green")
+            colored_print(f"Fetched {len(repositories)} repositories", "green")
             colored_print(f"   Saved to: {self.config.REPOS_FILE}", "cyan")
-            colored_print(f"   API: GraphQL (5-10x faster than REST)", "green")
 
             return repositories
 
         except Exception as e:
-            colored_print(f"✗ Error fetching repositories: {e}", "red")
+            colored_print(f"Error fetching repositories: {e}", "red")
             raise
 
-    # ============================================================================
-    # OLD REST API HELPER (DEADCODE - handled by GraphQL fetcher now)
-    # ============================================================================
-    # def _build_temporal_query(
-    #     self,
-    #     keywords: str,
-    #     min_stars: int,
-    #     created_after: str = None,
-    #     created_before: str = None,
-    #     pushed_after: str = None,
-    #     pushed_before: str = None,
-    # ) -> str:
-    #     # Build GitHub search query with temporal constraints.
-    #     query_parts = [keywords, f"stars:>={min_stars}"]
-    #
-    #     # Temporal filters
-    #     if created_after and created_before:
-    #         query_parts.append(f"created:{created_after}..{created_before}")
-    #     elif created_after:
-    #         query_parts.append(f"created:>={created_after}")
-    #     elif created_before:
-    #         query_parts.append(f"created:<={created_before}")
-    #
-    #     if pushed_after and pushed_before:
-    #         query_parts.append(f"pushed:{pushed_after}..{pushed_before}")
-    #     elif pushed_after:
-    #         query_parts.append(f"pushed:>={pushed_after}")
-    #     elif pushed_before:
-    #         query_parts.append(f"pushed:<={pushed_before}")
-    #
-    #     query = " ".join(query_parts)
-    #     colored_print(f"   Query: {query}", "cyan")
-    #     return query
-    # ============================================================================
-
     def load_repositories(self) -> list[Repository]:
         # Load repositories from file.
         if not self.config.REPOS_FILE.exists():

greenmining/presenters/console_presenter.py

@@ -113,7 +113,7 @@ class ConsolePresenter:
 
         table_data = []
         for phase, info in status.items():
-            status_icon = "" if info.get("completed") else "⏳"
+            status_icon = "done" if info.get("completed") else "pending"
             table_data.append(
                 [status_icon, phase, info.get("file", "N/A"), info.get("size", "N/A")]
             )

greenmining/services/github_fetcher.py

@@ -1,210 +1,2 @@
-# ================================================================================
-# DEADCODE - OLD REST API IMPLEMENTATION
-# ================================================================================
-#
-# This file contains the OLD GitHub REST API implementation.
-# It has been REPLACED by GitHubGraphQLFetcher for better performance.
-#
-# Performance comparison:
-#   REST API:    10+ requests for 100 repos, ~2 minutes
-#   GraphQL API: 1-2 requests for 100 repos, ~15 seconds (10x faster!)
-#
-# USE INSTEAD: greenmining.services.github_graphql_fetcher.GitHubGraphQLFetcher
-#
-# This file is kept for reference only. Do not use in production.
-#
-# ================================================================================
-
-# GitHub repository fetcher for green microservices mining.
-
-# from __future__ import annotations
-#
-# from datetime import datetime
-# from pathlib import Path
-# from typing import Any, Dict, List, Optional
-#
-# from github import Github, GithubException, RateLimitExceededException
-# from tqdm import tqdm
-#
-# from greenmining.config import get_config
-# from greenmining.utils import (
-#     colored_print,
-#     format_timestamp,
-#     print_banner,
-#     save_json_file,
-# )
-#
-#
-# class GitHubFetcher:
-#     # Fetches microservice repositories from GitHub using REST API (SLOW).
-#
-#     def __init__(
-#         self,
-#         token: str,
-#         max_repos: int = 100,
-#         min_stars: int = 100,
-#         languages: Optional[list[str]] = None,
-#         created_after: Optional[str] = None,
-#         created_before: Optional[str] = None,
-#         pushed_after: Optional[str] = None,
-#         pushed_before: Optional[str] = None,
-#     ):
-#         # Initialize GitHub fetcher.
-#         self.github = Github(token)
-#         self.max_repos = max_repos
-#         self.min_stars = min_stars
-#         self.languages = languages or [
-#             "Java",
-#             "Python",
-#             "Go",
-#             "JavaScript",
-#             "TypeScript",
-#             "C#",
-#             "Rust",
-#         ]
-#         self.created_after = created_after
-#         self.created_before = created_before
-#         self.pushed_after = pushed_after
-#         self.pushed_before = pushed_before
-#
-#     def search_repositories(self) -> list[dict[str, Any]]:
-#         # Search for microservice repositories (REST API - many requests).
-#         repositories = []
-#         keywords = ["microservices", "microservice-architecture", "cloud-native"]
-#
-#         colored_print(f"Searching for repositories with keywords: {', '.join(keywords)}", "cyan")
-#         colored_print(
-#             f"Filters: min_stars={self.min_stars}, languages={', '.join(self.languages)}", "cyan"
-#         )
-#
-#         # Build search query with temporal filters
-#         query = self._build_temporal_query(keywords)
-#
-#         try:
-#             # Execute search (1 request)
-#             search_results = self.github.search_repositories(
-#                 query=query, sort="stars", order="desc"
-#             )
-#
-#             total_found = search_results.totalCount
-#             colored_print(f"Found {total_found} repositories matching criteria", "green")
-#
-#             # Fetch repository details with progress bar (1 request per repo = SLOW)
-#             with tqdm(
-#                 total=min(self.max_repos, total_found), desc="Fetching repositories", unit="repo"
-#             ) as pbar:
-#                 for idx, repo in enumerate(search_results):
-#                     if idx >= self.max_repos:
-#                         break
-#
-#                     try:
-#                         repo_data = self._extract_repo_metadata(repo, idx + 1)
-#                         repositories.append(repo_data)
-#                         pbar.update(1)
-#                     except GithubException as e:
-#                         colored_print(f"Error fetching {repo.full_name}: {e}", "yellow")
-#                         continue
-#                     except RateLimitExceededException:
-#                         colored_print("Rate limit exceeded. Waiting...", "red")
-#                         self._handle_rate_limit()
-#                         continue
-#
-#             return repositories
-#
-#         except GithubException as e:
-#             colored_print(f"GitHub API error: {e}", "red")
-#             raise
-#         except Exception as e:
-#             colored_print(f"Unexpected error: {e}", "red")
-#             raise
-#
-#     def _extract_repo_metadata(self, repo, repo_id: int) -> dict[str, Any]:
-#         # Extract metadata from repository object.
-#         return {
-#             "repo_id": repo_id,
-#             "name": repo.name,
-#             "owner": repo.owner.login,
-#             "full_name": repo.full_name,
-#             "url": repo.html_url,
-#             "clone_url": repo.clone_url,
-#             "language": repo.language,
-#             "stars": repo.stargazers_count,
-#             "forks": repo.forks_count,
-#             "watchers": repo.watchers_count,
-#             "open_issues": repo.open_issues_count,
-#             "last_updated": repo.updated_at.isoformat() if repo.updated_at else None,
-#             "created_at": repo.created_at.isoformat() if repo.created_at else None,
-#             "description": repo.description or "",
-#             "main_branch": repo.default_branch,
-#             "topics": repo.get_topics() if hasattr(repo, "get_topics") else [],
-#             "size": repo.size,
-#             "has_issues": repo.has_issues,
-#             "has_wiki": repo.has_wiki,
-#             "archived": repo.archived,
-#             "license": repo.license.name if repo.license else None,
-#         }
-#
-#     def _build_temporal_query(self, keywords: list[str]) -> str:
-#         # Build GitHub search query with temporal constraints.
-#         query_parts = []
-#
-#         # Keywords
-#         keyword_query = " OR ".join(keywords)
-#         query_parts.append(f"({keyword_query})")
-#
-#         # Languages
-#         language_query = " OR ".join([f"language:{lang}" for lang in self.languages])
-#         query_parts.append(f"({language_query})")
-#
-#         # Stars
-#         query_parts.append(f"stars:>={self.min_stars}")
-#
-#         # Archived filter
-#         query_parts.append("archived:false")
-#
-#         # Temporal filters
-#         if self.created_after and self.created_before:
-#             query_parts.append(f"created:{self.created_after}..{self.created_before}")
-#         elif self.created_after:
-#             query_parts.append(f"created:>={self.created_after}")
-#         elif self.created_before:
-#             query_parts.append(f"created:<={self.created_before}")
-#
-#         if self.pushed_after and self.pushed_before:
-#             query_parts.append(f"pushed:{self.pushed_after}..{self.pushed_before}")
-#         elif self.pushed_after:
-#             query_parts.append(f"pushed:>={self.pushed_after}")
-#         elif self.pushed_before:
-#             query_parts.append(f"pushed:<={self.pushed_before}")
-#
-#         query = " ".join(query_parts)
-#         colored_print(f"Query: {query}", "cyan")
-#         return query
-#
-#     def _handle_rate_limit(self):
-#         # Handle GitHub API rate limiting.
-#         rate_limit = self.github.get_rate_limit()
-#         reset_time = rate_limit.core.reset
-#         wait_seconds = (reset_time - datetime.now()).total_seconds()
-#
-#         if wait_seconds > 0:
-#             colored_print(f"Rate limit will reset in {wait_seconds:.0f} seconds", "yellow")
-#             import time
-#
-#             time.sleep(min(wait_seconds + 10, 60))  # Wait with max 60 seconds
-#
-#     def save_results(self, repositories: list[dict[str, Any]], output_file: Path):
-#         # Save fetched repositories to JSON file.
-#         data = {
-#             "metadata": {
-#                 "fetched_at": format_timestamp(),
-#                 "total_repos": len(repositories),
-#                 "min_stars": self.min_stars,
-#                 "languages": self.languages,
-#                 "search_keywords": ["microservices", "microservice-architecture", "cloud-native"],
-#             },
-#             "repositories": repositories,
-#         }
-#
-#         save_json_file(data, output_file)
-#         colored_print(f"Saved {len(repositories)} repositories to {output_file}", "green")
+# Legacy GitHub REST API fetcher (deprecated).
+# Use github_graphql_fetcher.GitHubGraphQLFetcher instead.

greenmining/services/github_graphql_fetcher.py

@@ -1,7 +1,4 @@
-# GitHub GraphQL API fetcher for faster and more efficient repository fetching.
-#
-# GraphQL allows fetching exactly the data you need in a single request,
-# reducing API calls and improving rate limit efficiency.
+# GitHub GraphQL API fetcher for repository search and data retrieval.
 
 import json
 import time
@@ -14,12 +11,6 @@ from greenmining.models.repository import Repository
 
 class GitHubGraphQLFetcher:
     # Fetch GitHub repositories using GraphQL API v4.
-    #
-    # Benefits over REST API:
-    # - Fetch repos + commits in 1 request instead of 100+ REST calls
-    # - Get exactly the fields you need (no over-fetching)
-    # - Better rate limit efficiency (5000 points/hour vs 5000 requests/hour)
-    # - More powerful search capabilities
 
     GRAPHQL_ENDPOINT = "https://api.github.com/graphql"
 
@@ -193,10 +184,10 @@ class GitHubGraphQLFetcher:
         # Star count
         query_parts.append(f"stars:>={min_stars}")
 
-        # Languages
-        if languages:
-            lang_query = " OR ".join([f"language:{lang}" for lang in languages])
-            query_parts.append(f"({lang_query})")
+        # Languages - skip filter if more than 5 to avoid exceeding GitHub query limits
+        if languages and len(languages) <= 5:
+            lang_query = " ".join([f"language:{lang}" for lang in languages])
+            query_parts.append(lang_query)
 
         # Date filters
         if created_after:
@@ -259,9 +250,6 @@ class GitHubGraphQLFetcher:
     ) -> List[Dict[str, Any]]:
         # Fetch commits for a specific repository using GraphQL.
         #
-        # This is much faster than REST API as it gets all commits in 1-2 requests
-        # instead of paginating through 100 individual REST calls.
-        #
         # Args:
         #     owner: Repository owner
         #     name: Repository name

{greenmining-1.0.6.dist-info → greenmining-1.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenmining
-Version: 1.0.6
+Version: 1.0.8
 Summary: An empirical Python library for Mining Software Repositories (MSR) in Green IT research
 Author-email: Adam Bouafia <a.bouafia@student.vu.nl>
 License: MIT
@@ -330,7 +330,137 @@ print(f"Top patterns: {stats['top_patterns'][:5]}")
 aggregator.export_to_csv(results, "output.csv")
 ```
 
-#### Batch Analysis
+#### URL-Based Repository Analysis
+
+```python
+from greenmining.services.local_repo_analyzer import LocalRepoAnalyzer
+
+analyzer = LocalRepoAnalyzer(
+    max_commits=200,
+    cleanup_after=True,
+)
+
+result = analyzer.analyze_repository("https://github.com/pallets/flask")
+
+print(f"Repository: {result.name}")
+print(f"Commits analyzed: {result.total_commits}")
+print(f"Green-aware: {result.green_commits} ({result.green_commit_rate:.1%})")
+
+for commit in result.commits[:5]:
+    if commit.green_aware:
+        print(f"  {commit.message[:60]}...")
+```
+
+#### Batch Analysis with Parallelism
+
+```python
+from greenmining import analyze_repositories
+
+results = analyze_repositories(
+    urls=[
+        "https://github.com/kubernetes/kubernetes",
+        "https://github.com/istio/istio",
+        "https://github.com/envoyproxy/envoy",
+    ],
+    max_commits=100,
+    parallel_workers=3,
+    energy_tracking=True,
+    energy_backend="auto",
+)
+
+for result in results:
+    print(f"{result.name}: {result.green_commit_rate:.1%} green")
+```
+
+#### Private Repository Analysis
+
+```python
+from greenmining.services.local_repo_analyzer import LocalRepoAnalyzer
+
+# HTTPS with token
+analyzer = LocalRepoAnalyzer(github_token="ghp_xxxx")
+result = analyzer.analyze_repository("https://github.com/company/private-repo")
+
+# SSH with key
+analyzer = LocalRepoAnalyzer(ssh_key_path="~/.ssh/id_rsa")
+result = analyzer.analyze_repository("git@github.com:company/private-repo.git")
+```
+
+#### Power Regression Detection
+
+```python
+from greenmining.analyzers import PowerRegressionDetector
+
+detector = PowerRegressionDetector(
+    test_command="pytest tests/ -x",
+    energy_backend="rapl",
+    threshold_percent=5.0,
+    iterations=5,
+)
+
+regressions = detector.detect(
+    repo_path="/path/to/repo",
+    baseline_commit="v1.0.0",
+    target_commit="HEAD",
+)
+
+for regression in regressions:
+    print(f"Commit {regression.sha[:8]}: +{regression.power_increase:.1f}%")
+```
+
+#### Version Power Comparison
+
+```python
+from greenmining.analyzers import VersionPowerAnalyzer
+
+analyzer = VersionPowerAnalyzer(
+    test_command="pytest tests/",
+    energy_backend="rapl",
+    iterations=10,
+    warmup_iterations=2,
+)
+
+report = analyzer.analyze_versions(
+    repo_path="/path/to/repo",
+    versions=["v1.0", "v1.1", "v1.2", "v2.0"],
+)
+
+print(report.summary())
+print(f"Trend: {report.trend}")
+print(f"Most efficient: {report.most_efficient}")
+```
+
+#### Metrics-to-Power Correlation
+
+```python
+from greenmining.analyzers import MetricsPowerCorrelator
+
+correlator = MetricsPowerCorrelator()
+correlator.fit(
+    metrics=["complexity", "nloc", "code_churn"],
+    metrics_values={
+        "complexity": [10, 20, 30, 40],
+        "nloc": [100, 200, 300, 400],
+        "code_churn": [50, 100, 150, 200],
+    },
+    power_measurements=[5.0, 8.0, 12.0, 15.0],
+)
+
+print(f"Pearson: {correlator.pearson}")
+print(f"Spearman: {correlator.spearman}")
+print(f"Feature importance: {correlator.feature_importance}")
+```
+
+#### Web Dashboard
+
+```python
+from greenmining.dashboard import run_dashboard
+
+# Launch interactive dashboard (requires pip install greenmining[dashboard])
+run_dashboard(data_dir="./data", host="127.0.0.1", port=5000)
+```
+
+#### Pipeline Batch Analysis
 
 ```python
 from greenmining.controllers.repository_controller import RepositoryController
@@ -551,17 +681,24 @@ config = Config(
 
 ### Core Capabilities
 
-- **Pattern Detection**: Automatically identifies 122 sustainability patterns across 15 categories
-- **Keyword Analysis**: Scans commit messages using 321 green software keywords
-- **Custom Repository Fetching**: Fetch repositories with custom search keywords (not limited to microservices)
-- **Repository Analysis**: Analyzes repositories from GitHub with flexible filtering
-- **Batch Processing**: Analyze hundreds of repositories and thousands of commits
-- **Multi-format Output**: Generates Markdown reports, CSV exports, and JSON data
-- **Statistical Analysis**: Calculates green-awareness metrics, pattern distribution, and trends
+- **Pattern Detection**: 122 sustainability patterns across 15 categories from the GSF catalog
+- **Keyword Analysis**: 321 green software detection keywords
+- **Repository Fetching**: GraphQL API with date, star, and language filters
+- **URL-Based Analysis**: Direct PyDriller analysis from GitHub URLs (HTTPS and SSH)
+- **Batch Processing**: Parallel analysis of multiple repositories with configurable workers
+- **Private Repository Support**: Authentication via SSH keys or GitHub tokens
+- **Energy Measurement**: RAPL, CodeCarbon, and CPU Energy Meter backends
+- **Carbon Footprint Reporting**: CO2 emissions with 20+ country profiles and cloud region support (AWS, GCP, Azure)
+- **Power Regression Detection**: Identify commits that increased energy consumption
+- **Metrics-to-Power Correlation**: Pearson and Spearman analysis between code metrics and power
+- **Version Power Comparison**: Compare power consumption across software versions with trend detection
+- **Method-Level Analysis**: Per-method complexity metrics via Lizard integration
+- **Source Code Access**: Before/after source code for refactoring detection
+- **Full Process Metrics**: All 8 PyDriller process metrics (ChangeSet, CodeChurn, CommitsCount, ContributorsCount, ContributorsExperience, HistoryComplexity, HunksCount, LinesCount)
+- **Statistical Analysis**: Correlations, effect sizes, and temporal trends
+- **Multi-format Output**: Markdown reports, CSV exports, JSON data
+- **Web Dashboard**: Flask-based interactive visualization (`pip install greenmining[dashboard]`)
 - **Docker Support**: Pre-built images for containerized analysis
-- **Programmatic API**: Full Python API for custom workflows and integrations
-- **Clean Architecture**: Modular design with services layer (Fetcher, Extractor, Analyzer, Aggregator, Reports)
-- **Energy Measurement**: Real-time energy consumption tracking via RAPL (Linux) or CodeCarbon (cross-platform)
 
 ### Energy Measurement
 
@@ -712,8 +849,15 @@ ruff check greenmining/ tests/
 - Python 3.9+
 - PyGithub >= 2.1.1
 - PyDriller >= 2.5
-- pandas >= 2.2.0 
-- codecarbon >= 2.0.0 (optional, for cross-platform energy measurement)
+- pandas >= 2.2.0
+
+**Optional dependencies:**
+
+```bash
+pip install greenmining[energy]      # psutil, codecarbon (energy measurement)
+pip install greenmining[dashboard]   # flask (web dashboard)
+pip install greenmining[dev]         # pytest, black, ruff, mypy (development)
+```
 
 ## License
 

{greenmining-1.0.6.dist-info → greenmining-1.0.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-greenmining/__init__.py,sha256=wbMwJYwC1HKIPn4w5N6Ux8GV5fAohevW7iO_BYuFuA4,2637
+greenmining/__init__.py,sha256=cilA0cKdT3R8t-yFdkkcCvsSGzQ0PLoPMY2OQ4Irytg,2909
 greenmining/__main__.py,sha256=NYOVS7D4w2XDLn6SyXHXPKE5GrNGOeoWSTb_KazgK5c,590
 greenmining/__version__.py,sha256=xZc02a8bS3vUJlzh8k9RoxemB1irQmq_SpVVj6Cg5M0,62
 greenmining/config.py,sha256=M4a7AwM1ErCmOY0n5Vmyoo9HPblSkTZ-HD3k2YHzs4A,8340
@@ -13,7 +13,7 @@ greenmining/analyzers/statistical_analyzer.py,sha256=DzWAcCyw42Ig3FIxTwPPBikgt2u
 greenmining/analyzers/temporal_analyzer.py,sha256=JfTcAoI20oCFMehGrSRnDqhJTXI-RUbdCTMwDOTW9-g,14259
 greenmining/analyzers/version_power_analyzer.py,sha256=2P6zOqBg-ButtIhF-4cutiwD2Q1geMY49VFUghHXXoI,8119
 greenmining/controllers/__init__.py,sha256=UiAT6zBvC1z_9cJWfzq1cLA0I4r9b2vURHipj8oDczI,180
-greenmining/controllers/repository_controller.py,sha256=fyL6Y8xpoixDplP4_rKWiwak42M2DaIihzyKVaBlivA,9680
+greenmining/controllers/repository_controller.py,sha256=DM9BabUAwZJARGngCk_4wEYPw2adn8iESCiFQ7Um4LQ,3880
 greenmining/dashboard/__init__.py,sha256=Ig_291-hLrH9k3rV0whhQ1EkhiaRR8ciHiJ5s5OCBf4,141
 greenmining/dashboard/app.py,sha256=Hk6_i2qmcg6SGW7UzxglEIvUBJiloRA-hMYI-YSORcA,8604
 greenmining/energy/__init__.py,sha256=GoCYh7hitWBoPMtan1HF1yezCHi7o4sa_YUJgGkeJc8,558
@@ -28,17 +28,17 @@ greenmining/models/analysis_result.py,sha256=YICTCEcrJxZ1R8Xaio3AZOjCGwMzC_62BMA
 greenmining/models/commit.py,sha256=mnRDWSiIyGtJeGXI8sav9hukWUyVFpoNe6GixRlZjY4,2439
 greenmining/models/repository.py,sha256=SKjS01onOptpMioumtAPZxKpKheHAeVXnXyvatl7CfM,2856
 greenmining/presenters/__init__.py,sha256=d1CMtqtUAHYHYNzigPyjtGOUtnH1drtUwf7-bFQq2B8,138
-greenmining/presenters/console_presenter.py,sha256=XOahvlcr4qLbUdhk8cGq1ZWagvemEd3Wgriu8T5EI3s,4896
+greenmining/presenters/console_presenter.py,sha256=qagn2c2aOym0WNKV8n175MQ-BTheLjrXzW8c1OafzAQ,4904
 greenmining/services/__init__.py,sha256=ZEMOVut0KRdume_vz58beSNps3YgeoGBXmUjEqNgIhc,690
 greenmining/services/commit_extractor.py,sha256=Fz2WTWjIZ_vQhSfkJKnWpJnBpI2nm0KacA4qYAvCpSE,8451
 greenmining/services/data_aggregator.py,sha256=TsFT0oGOnnHk0QGZ1tT6ZhKGc5X1H1D1u7-7OpiPo7Y,19566
 greenmining/services/data_analyzer.py,sha256=f0nlJkPAclHHCzzTyQW5bjhYrgE0XXiR1x7_o3fJaDs,9732
-greenmining/services/github_fetcher.py,sha256=mUcmQevhdDRYX72O-M7Vi-s3y4ZwNyKewleti838cqU,8285
-greenmining/services/github_graphql_fetcher.py,sha256=p76vp5EgStzkmTcws__jb90za8m61toW0CBrwrm5Ew4,11972
+greenmining/services/github_fetcher.py,sha256=sdkS-LhHmX7mgMdlClCwEUVnZrItc0Pt6FVtlWk5iLU,106
+greenmining/services/github_graphql_fetcher.py,sha256=HvADlXGqrqfzqnsI9xJQifhy8rQ5fQzosdlCBdNxjsU,11467
 greenmining/services/local_repo_analyzer.py,sha256=5DMN9RIyGXNdsOlIDV4Mp0fPavbB69oBA9us17P5cNo,24668
 greenmining/services/reports.py,sha256=Vrw_pBNmVw2mTAf1dpcAqjBe6gXv-O4w_XweoVTt7L8,23392
-greenmining-1.0.6.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
-greenmining-1.0.6.dist-info/METADATA,sha256=cd82RQon4bIBdJT85mcCeZuXL3evl4N9YkcqywDw41k,26920
-greenmining-1.0.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-greenmining-1.0.6.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
-greenmining-1.0.6.dist-info/RECORD,,
+greenmining-1.0.8.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
+greenmining-1.0.8.dist-info/METADATA,sha256=46ygTrzFHVKFOPpF9gb9D_HbTCWs1ZN0VH4v1I7U7Zg,30913
+greenmining-1.0.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+greenmining-1.0.8.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
+greenmining-1.0.8.dist-info/RECORD,,