greenmining 1.1.4__py3-none-any.whl → 1.1.6__py3-none-any.whl

greenmining/__init__.py

@@ -9,7 +9,7 @@ from greenmining.gsf_patterns import (
     is_green_aware,
 )
 
-__version__ = "1.1.4"
+__version__ = "1.1.6"
 
 
 def fetch_repositories(
@@ -51,6 +51,8 @@ def analyze_repositories(
     include_source_code: bool = False,
     ssh_key_path: str = None,
     github_token: str = None,
+    since_date: str = None,
+    to_date: str = None,
 ):
     # Analyze multiple repositories from URLs.
     # Args:
@@ -64,8 +66,20 @@ def analyze_repositories(
     #   include_source_code: Include source code before/after in results
     #   ssh_key_path: SSH key path for private repositories
     #   github_token: GitHub token for private HTTPS repositories
+    #   since_date: Analyze commits from this date (YYYY-MM-DD string)
+    #   to_date: Analyze commits up to this date (YYYY-MM-DD string)
     from greenmining.services.local_repo_analyzer import LocalRepoAnalyzer
 
+    kwargs = {}
+    if since_date:
+        from datetime import datetime
+
+        kwargs["since_date"] = datetime.strptime(since_date, "%Y-%m-%d")
+    if to_date:
+        from datetime import datetime
+
+        kwargs["to_date"] = datetime.strptime(to_date, "%Y-%m-%d")
+
     analyzer = LocalRepoAnalyzer(
         max_commits=max_commits,
         energy_tracking=energy_tracking,
@@ -74,6 +88,7 @@ def analyze_repositories(
         include_source_code=include_source_code,
         ssh_key_path=ssh_key_path,
         github_token=github_token,
+        **kwargs,
     )
 
     return analyzer.analyze_repositories(

greenmining/analyzers/statistical_analyzer.py

@@ -50,7 +50,8 @@ class StatisticalAnalyzer:
     def temporal_trend_analysis(self, commits_df: pd.DataFrame) -> Dict[str, Any]:
         # Analyze temporal trends in green awareness.
         # Prepare time series data
-        commits_df["date"] = pd.to_datetime(commits_df["date"])
+        commits_df["date"] = pd.to_datetime(commits_df["date"], utc=True, errors="coerce")
+        commits_df["date"] = commits_df["date"].dt.tz_localize(None)
         commits_df = commits_df.sort_values("date")
 
         # Monthly aggregation

greenmining/energy/base.py

@@ -42,6 +42,14 @@ class EnergyMetrics:
     start_time: Optional[datetime] = None
     end_time: Optional[datetime] = None
 
+    @property
+    def energy_joules(self) -> float:
+        return self.joules
+
+    @property
+    def average_power_watts(self) -> float:
+        return self.watts_avg
+
     def to_dict(self) -> Dict[str, Any]:
         # Convert to dictionary.
         return {

greenmining/services/local_repo_analyzer.py

@@ -204,6 +204,8 @@ class LocalRepoAnalyzer:
         method_level_analysis: bool = False,
         include_source_code: bool = False,
         process_metrics: str = "standard",
+        since_date: Optional[datetime] = None,
+        to_date: Optional[datetime] = None,
     ):
         # Initialize the local repository analyzer.
         # Args:
@@ -224,6 +226,8 @@ class LocalRepoAnalyzer:
         self.clone_path.mkdir(parents=True, exist_ok=True)
         self.max_commits = max_commits
         self.days_back = days_back
+        self.since_date = since_date
+        self.to_date = to_date
         self.skip_merges = skip_merges
         self.compute_process_metrics = compute_process_metrics
         self.cleanup_after = cleanup_after
@@ -446,7 +450,7 @@ class LocalRepoAnalyzer:
         auth_url = self._prepare_auth_url(url)
 
         # Calculate date range
-        since_date = datetime.now() - timedelta(days=self.days_back)
+        since_date = self.since_date or (datetime.now() - timedelta(days=self.days_back))
 
         # Configure PyDriller Repository
         repo_config = {
@@ -454,6 +458,8 @@ class LocalRepoAnalyzer:
             "since": since_date,
             "only_no_merge": self.skip_merges,
         }
+        if self.to_date:
+            repo_config["to"] = self.to_date
 
         # Clone to specific path if needed
         local_path = self.clone_path / repo_name
@@ -464,13 +470,16 @@ class LocalRepoAnalyzer:
 
         colored_print(f"   Cloning to: {local_path}", "cyan")
 
-        # Phase 2.2: Start energy measurement if enabled
+        # Phase 2.2: Start energy measurement if enabled (fresh meter per repo)
         energy_result = None
-        if self.energy_tracking and self._energy_meter:
+        energy_meter = None
+        if self.energy_tracking:
             try:
-                self._energy_meter.start()
-            except Exception as e:
-                colored_print(f"   Warning: Energy measurement start failed: {e}", "yellow")
+                from greenmining.energy.base import get_energy_meter
+                energy_meter = get_energy_meter(self.energy_backend)
+                energy_meter.start()
+            except Exception:
+                energy_meter = None
 
         commits_analyzed = []
         commit_count = 0
@@ -497,11 +506,11 @@ class LocalRepoAnalyzer:
             colored_print(f"    Analyzed {len(commits_analyzed)} commits", "green")
 
             # Phase 2.2: Stop energy measurement
-            if self.energy_tracking and self._energy_meter:
+            if energy_meter:
                 try:
-                    energy_result = self._energy_meter.stop()
-                except Exception as e:
-                    colored_print(f"   Warning: Energy measurement stop failed: {e}", "yellow")
+                    energy_result = energy_meter.stop()
+                except Exception:
+                    pass
 
             # Compute process metrics if enabled
             process_metrics = {}

{greenmining-1.1.4.dist-info → greenmining-1.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenmining
-Version: 1.1.4
+Version: 1.1.6
 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
@@ -73,7 +73,7 @@ An empirical Python library for Mining Software Repositories (MSR) in Green IT r
 - **Mine repositories at scale** - Fetch and analyze GitHub repositories via GraphQL API with configurable filters
 - **Batch analysis with parallelism** - Analyze multiple repositories concurrently with configurable worker pools
 - **Classify green commits** - Detect 122 sustainability patterns from the Green Software Foundation (GSF) catalog
-- **Analyze any repository by URL** - Direct PyDriller-based analysis with support for private repositories
+- **Analyze any repository by URL** - Direct Git-based analysis with support for private repositories
 - **Measure energy consumption** - RAPL, CodeCarbon, and CPU Energy Meter backends for power profiling
 - **Carbon footprint reporting** - CO2 emissions calculation with 20+ country profiles and cloud region support
 - **Power regression detection** - Identify commits that increased energy consumption
@@ -685,7 +685,7 @@ config = Config(
 - **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)
+- **URL-Based Analysis**: Direct Git-based 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
@@ -695,7 +695,7 @@ config = Config(
 - **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)
+- **Full Process Metrics**: All 8 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]`)
@@ -849,7 +849,8 @@ ruff check greenmining/ tests/
 
 - Python 3.9+
 - PyGithub >= 2.1.1
-- PyDriller >= 2.5
+- gitpython >= 3.1.0
+- lizard >= 1.17.0
 - pandas >= 2.2.0
 
 **Optional dependencies:**

{greenmining-1.1.4.dist-info → greenmining-1.1.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-greenmining/__init__.py,sha256=f8971n5AONb3am4c0v2yuJ8kUTp4rVtIe-uawjENwEI,2909
+greenmining/__init__.py,sha256=jkQOxpAJmEyUIt6LgwuGESxdSsDWGd0qv1Vrsa26YzM,3390
 greenmining/__main__.py,sha256=NYOVS7D4w2XDLn6SyXHXPKE5GrNGOeoWSTb_KazgK5c,590
 greenmining/__version__.py,sha256=xZc02a8bS3vUJlzh8k9RoxemB1irQmq_SpVVj6Cg5M0,62
 greenmining/config.py,sha256=M4a7AwM1ErCmOY0n5Vmyoo9HPblSkTZ-HD3k2YHzs4A,8340
@@ -9,7 +9,7 @@ greenmining/analyzers/code_diff_analyzer.py,sha256=1dk68R3O0RZG8gx1cm9B_UlZ1Uwyb
 greenmining/analyzers/metrics_power_correlator.py,sha256=qMKr4hSTzT0Un3vsGZNkPCp9TxyzdFwrhjw5M1IKOgk,5964
 greenmining/analyzers/power_regression.py,sha256=5pxs7IoTtGcwwX5KzGeM5hOm2I9Axr-0X4N_4007iMw,7387
 greenmining/analyzers/qualitative_analyzer.py,sha256=RcjOMLj_DPH869ey9J0uI7JK_krCefMhNkPLOJUDFF8,15391
-greenmining/analyzers/statistical_analyzer.py,sha256=DzWAcCyw42Ig3FIxTwPPBikgt2uzMdktxklonOYfnOk,7166
+greenmining/analyzers/statistical_analyzer.py,sha256=rqLsRGuOHhxEMQAFx5dmWMHDgdb6ktL7CY3dAebQvpA,7262
 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
@@ -17,7 +17,7 @@ greenmining/controllers/repository_controller.py,sha256=DM9BabUAwZJARGngCk_4wEYP
 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
-greenmining/energy/base.py,sha256=mVdp-E04KWu3UnHFL61pzrI-OP-KsUshAmXHwgsJkRU,5749
+greenmining/energy/base.py,sha256=3hIPgc4B0Nz9V7DTh2Xd6trDRtmozUBBpa5UWRuWzcw,5918
 greenmining/energy/carbon_reporter.py,sha256=bKIFlLhHfYzI4DBu_ff4GW1Psz4oSCAF4NmzQb-EShA,8298
 greenmining/energy/codecarbon_meter.py,sha256=HyQptyEaS1ZMu_qdxg0Tyuly1PCmmbbNwwYX8qYsTs4,4927
 greenmining/energy/cpu_meter.py,sha256=mhEG3Y7fjz3wV5lojcYeFXvCXXgmelGQaBfN2q7yTNc,5007
@@ -35,10 +35,10 @@ greenmining/services/data_aggregator.py,sha256=TsFT0oGOnnHk0QGZ1tT6ZhKGc5X1H1D1u
 greenmining/services/data_analyzer.py,sha256=f0nlJkPAclHHCzzTyQW5bjhYrgE0XXiR1x7_o3fJaDs,9732
 greenmining/services/github_fetcher.py,sha256=sdkS-LhHmX7mgMdlClCwEUVnZrItc0Pt6FVtlWk5iLU,106
 greenmining/services/github_graphql_fetcher.py,sha256=ZklXdEAc60KeFL83zRYMwW_-2OwMKpfPY7Wrifl0D50,11539
-greenmining/services/local_repo_analyzer.py,sha256=5DMN9RIyGXNdsOlIDV4Mp0fPavbB69oBA9us17P5cNo,24668
+greenmining/services/local_repo_analyzer.py,sha256=pnH_Hf3GjCFovurEl2uZgOgD3qjqcsP2K1QnKHddkSY,24903
 greenmining/services/reports.py,sha256=Vrw_pBNmVw2mTAf1dpcAqjBe6gXv-O4w_XweoVTt7L8,23392
-greenmining-1.1.4.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
-greenmining-1.1.4.dist-info/METADATA,sha256=YaFtuN9JviTEk3q6vAswjLeW6nYLRrGuFglQhbsGP68,30806
-greenmining-1.1.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-greenmining-1.1.4.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
-greenmining-1.1.4.dist-info/RECORD,,
+greenmining-1.1.6.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
+greenmining-1.1.6.dist-info/METADATA,sha256=ADh-CwQLjdVv3P3BdMI8Ao50u1dPngilhoCTcX-Hr7M,30811
+greenmining-1.1.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+greenmining-1.1.6.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
+greenmining-1.1.6.dist-info/RECORD,,