greenmining 1.1.3__tar.gz → 1.1.5__tar.gz

{greenmining-1.1.3 → greenmining-1.1.5}/CHANGELOG.md

@@ -80,7 +80,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial project structure with MCP architecture
 - GSF patterns database (76 patterns, 190 keywords)
 - GitHub repository fetching and analysis
-- PyDriller integration for commit mining
+- Git-based commit mining integration
 - Pattern matching engine
 - Green awareness detection
 - Data analysis and reporting

{greenmining-1.1.3/greenmining.egg-info → greenmining-1.1.5}/PKG-INFO

@@ -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 → greenmining-1.1.5}/README.md

@@ -14,7 +14,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
@@ -626,7 +626,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
@@ -636,7 +636,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]`)
@@ -790,7 +790,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 → greenmining-1.1.5}/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-1.1.3 → greenmining-1.1.5}/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 → greenmining-1.1.5/greenmining.egg-info}/PKG-INFO

@@ -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.5/greenmining.egg-info/requires.txt

@@ -0,0 +1,32 @@
+PyGithub
+PyDriller
+pandas
+colorama
+tabulate
+tqdm
+matplotlib
+plotly
+python-dotenv
+requests
+
+[dashboard]
+flask
+
+[dev]
+pytest
+pytest-cov
+pytest-mock
+black
+ruff
+mypy
+build
+twine
+
+[docs]
+sphinx
+sphinx-rtd-theme
+myst-parser
+
+[energy]
+psutil
+codecarbon

{greenmining-1.1.3 → greenmining-1.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "greenmining"
-version = "1.1.3"
+version = "1.1.5"
 description = "An empirical Python library for Mining Software Repositories (MSR) in Green IT research"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -43,48 +43,49 @@ classifiers = [
 ]
 
 dependencies = [
-    "PyGithub>=2.1.1",
-    "PyDriller>=2.5",
-    "pandas>=2.2.0",
-    "colorama>=0.4.6",
-    "tabulate>=0.9.0",
-    "tqdm>=4.66.0",
-    "matplotlib>=3.8.0",
-    "plotly>=5.18.0",
-    "python-dotenv>=1.0.0",
-    "requests>=2.31.0"
+    "PyGithub",
+    "PyDriller",
+    "pandas",
+    "colorama",
+    "tabulate",
+    "tqdm",
+    "matplotlib",
+    "plotly",
+    "python-dotenv",
+    "requests"
 ]
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.4.0",
-    "pytest-cov>=4.1.0",
-    "pytest-mock>=3.12.0",
-    "black>=23.12.0",
-    "ruff>=0.1.9",
-    "mypy>=1.8.0",
-    "build>=1.0.5",
-    "twine>=4.0.2"
+    "pytest",
+    "pytest-cov",
+    "pytest-mock",
+    "black",
+    "ruff",
+    "mypy",
+    "build",
+    "twine"
 ]
 
 energy = [
-    "psutil>=5.9.0",
-    "codecarbon>=2.3.0"
+    "psutil",
+    "codecarbon"
 ]
 
 dashboard = [
-    "flask>=3.0.0"
+    "flask"
 ]
 
 docs = [
-    "sphinx>=7.2.0",
-    "sphinx-rtd-theme>=2.0.0",
-    "myst-parser>=2.0.0"
+    "sphinx",
+    "sphinx-rtd-theme",
+    "myst-parser"
 ]
 
 [project.urls]
 Homepage = "https://github.com/adam-bouafia/greenmining"
 Documentation = "https://github.com/adam-bouafia/greenmining#readme"
+Linkedin = "https://www.linkedin.com/in/adam-bouafia/"
 Repository = "https://github.com/adam-bouafia/greenmining"
 Issues = "https://github.com/adam-bouafia/greenmining/issues"
 Changelog = "https://github.com/adam-bouafia/greenmining/blob/main/CHANGELOG.md"

greenmining-1.1.3/greenmining.egg-info/requires.txt

@@ -1,32 +0,0 @@
-PyGithub>=2.1.1
-PyDriller>=2.5
-pandas>=2.2.0
-colorama>=0.4.6
-tabulate>=0.9.0
-tqdm>=4.66.0
-matplotlib>=3.8.0
-plotly>=5.18.0
-python-dotenv>=1.0.0
-requests>=2.31.0
-
-[dashboard]
-flask>=3.0.0
-
-[dev]
-pytest>=7.4.0
-pytest-cov>=4.1.0
-pytest-mock>=3.12.0
-black>=23.12.0
-ruff>=0.1.9
-mypy>=1.8.0
-build>=1.0.5
-twine>=4.0.2
-
-[docs]
-sphinx>=7.2.0
-sphinx-rtd-theme>=2.0.0
-myst-parser>=2.0.0
-
-[energy]
-psutil>=5.9.0
-codecarbon>=2.3.0