greenmining 1.1.3__py3-none-any.whl → 1.1.5__py3-none-any.whl

greenmining/__init__.py

@@ -9,7 +9,7 @@ from greenmining.gsf_patterns import (
     is_green_aware,
 )
 
-__version__ = "1.1.3"
+__version__ = "1.1.5"
 
 
 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/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

{greenmining-1.1.3.dist-info → greenmining-1.1.5.dist-info}/METADATA

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: greenmining
-Version: 1.1.3
+Version: 1.1.5
 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
 Project-URL: Homepage, https://github.com/adam-bouafia/greenmining
 Project-URL: Documentation, https://github.com/adam-bouafia/greenmining#readme
+Project-URL: Linkedin, https://www.linkedin.com/in/adam-bouafia/
 Project-URL: Repository, https://github.com/adam-bouafia/greenmining
 Project-URL: Issues, https://github.com/adam-bouafia/greenmining/issues
 Project-URL: Changelog, https://github.com/adam-bouafia/greenmining/blob/main/CHANGELOG.md
@@ -26,34 +27,34 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: PyGithub>=2.1.1
-Requires-Dist: PyDriller>=2.5
-Requires-Dist: pandas>=2.2.0
-Requires-Dist: colorama>=0.4.6
-Requires-Dist: tabulate>=0.9.0
-Requires-Dist: tqdm>=4.66.0
-Requires-Dist: matplotlib>=3.8.0
-Requires-Dist: plotly>=5.18.0
-Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: requests>=2.31.0
+Requires-Dist: PyGithub
+Requires-Dist: PyDriller
+Requires-Dist: pandas
+Requires-Dist: colorama
+Requires-Dist: tabulate
+Requires-Dist: tqdm
+Requires-Dist: matplotlib
+Requires-Dist: plotly
+Requires-Dist: python-dotenv
+Requires-Dist: requests
 Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
-Requires-Dist: black>=23.12.0; extra == "dev"
-Requires-Dist: ruff>=0.1.9; extra == "dev"
-Requires-Dist: mypy>=1.8.0; extra == "dev"
-Requires-Dist: build>=1.0.5; extra == "dev"
-Requires-Dist: twine>=4.0.2; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
 Provides-Extra: energy
-Requires-Dist: psutil>=5.9.0; extra == "energy"
-Requires-Dist: codecarbon>=2.3.0; extra == "energy"
+Requires-Dist: psutil; extra == "energy"
+Requires-Dist: codecarbon; extra == "energy"
 Provides-Extra: dashboard
-Requires-Dist: flask>=3.0.0; extra == "dashboard"
+Requires-Dist: flask; extra == "dashboard"
 Provides-Extra: docs
-Requires-Dist: sphinx>=7.2.0; extra == "docs"
-Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
-Requires-Dist: myst-parser>=2.0.0; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Requires-Dist: myst-parser; extra == "docs"
 Dynamic: license-file
 
 # greenmining
@@ -72,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
@@ -684,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
@@ -694,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]`)
@@ -848,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.3.dist-info → greenmining-1.1.5.dist-info}/RECORD

@@ -1,4 +1,4 @@
-greenmining/__init__.py,sha256=1dMcag7j4YJ2-7U8R0rKPDYw9aPiOEcZN2HE0UUoD-8,2909
+greenmining/__init__.py,sha256=1TrBIx5HvQhay8_08G-PggpKeGe3zM061Y27Jy_fEcI,3390
 greenmining/__main__.py,sha256=NYOVS7D4w2XDLn6SyXHXPKE5GrNGOeoWSTb_KazgK5c,590
 greenmining/__version__.py,sha256=xZc02a8bS3vUJlzh8k9RoxemB1irQmq_SpVVj6Cg5M0,62
 greenmining/config.py,sha256=M4a7AwM1ErCmOY0n5Vmyoo9HPblSkTZ-HD3k2YHzs4A,8340
@@ -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=N3QT7qLKT7ddvOhygJfUG5eMGcHIGeVevuleHB0oCN8,24918
 greenmining/services/reports.py,sha256=Vrw_pBNmVw2mTAf1dpcAqjBe6gXv-O4w_XweoVTt7L8,23392
-greenmining-1.1.3.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
-greenmining-1.1.3.dist-info/METADATA,sha256=sOT7LZIKKr1GtCg9BmFfoahQKeqzuNQ5ysgaYBKxc1U,30913
-greenmining-1.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-greenmining-1.1.3.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
-greenmining-1.1.3.dist-info/RECORD,,
+greenmining-1.1.5.dist-info/licenses/LICENSE,sha256=M7ma3JHGeiIZIs3ea0HTcFl_wLFPX2NZElUliYs4bCA,1083
+greenmining-1.1.5.dist-info/METADATA,sha256=MMoin-BR4dQGdzPploVH2GIpCQY9NGnDT-I6X_C1mfw,30811
+greenmining-1.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+greenmining-1.1.5.dist-info/top_level.txt,sha256=nreXgXxZIWI-42yQknQ0HXtUrFnzZ8N1ra4Mdy2KcsI,12
+greenmining-1.1.5.dist-info/RECORD,,