greenmining 1.2.2__tar.gz → 1.2.4__tar.gz

{greenmining-1.2.2 → greenmining-1.2.4}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [1.2.4] - 2026-02-01
+
+### Added
+- `skip_merges` parameter exposed in `analyze_repositories()` API (default: True)
+- `commit_order` parameter to control commit traversal order: "newest_first" (default) or "oldest_first"
+
+### Changed
+- Commit analysis now configurable between newest-first (recent trends) and oldest-first (evolution studies)
+
+## [1.2.3] - 2026-02-01
+
+### Fixed
+- `cleanup_after` parameter not exposed in top-level `analyze_repositories()` API
+- Repositories with empty commit histories no longer included in analysis results
+
+### Changed
+- Experiment notebook updated with full Android-domain pipeline run and results
+
 ## [1.2.1] - 2026-02-01
 
 ### Fixed
@@ -98,6 +116,8 @@
 - Green awareness analysis
 - Docker containerization
 
+[1.2.4]: https://github.com/adam-bouafia/greenmining/compare/v1.2.3...v1.2.4
+[1.2.3]: https://github.com/adam-bouafia/greenmining/compare/v1.2.1...v1.2.3
 [1.2.1]: https://github.com/adam-bouafia/greenmining/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/adam-bouafia/greenmining/compare/v1.1.9...v1.2.0
 [1.1.9]: https://github.com/adam-bouafia/greenmining/compare/v1.1.6...v1.1.9

{greenmining-1.2.2/greenmining.egg-info → greenmining-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenmining
-Version: 1.2.2
+Version: 1.2.4
 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

{greenmining-1.2.2 → greenmining-1.2.4}/greenmining/__init__.py

@@ -8,7 +8,7 @@ from greenmining.gsf_patterns import (
     is_green_aware,
 )
 
-__version__ = "1.2.2"
+__version__ = "1.2.4"
 
 
 def fetch_repositories(
@@ -73,6 +73,8 @@ def analyze_repositories(
     since_date: str = None,
     to_date: str = None,
     cleanup_after: bool = True,
+    skip_merges: bool = True,
+    commit_order: str = "newest_first",
 ):
     # Analyze multiple repositories from URLs.
     # Args:
@@ -88,6 +90,9 @@ def analyze_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)
+    #   cleanup_after: Remove cloned repos after analysis (default True)
+    #   skip_merges: Skip merge commits (default True)
+    #   commit_order: "newest_first" (default) or "oldest_first"
     from greenmining.services.local_repo_analyzer import LocalRepoAnalyzer
 
     kwargs = {}
@@ -109,6 +114,8 @@ def analyze_repositories(
         ssh_key_path=ssh_key_path,
         github_token=github_token,
         cleanup_after=cleanup_after,
+        skip_merges=skip_merges,
+        commit_order=commit_order,
         **kwargs,
     )
 

{greenmining-1.2.2 → greenmining-1.2.4}/greenmining/services/local_repo_analyzer.py

@@ -205,6 +205,7 @@ class LocalRepoAnalyzer:
         process_metrics: str = "standard",
         since_date: Optional[datetime] = None,
         to_date: Optional[datetime] = None,
+        commit_order: str = "newest_first",
     ):
         # Initialize the local repository analyzer.
         # Args:
@@ -221,6 +222,7 @@ class LocalRepoAnalyzer:
         #   method_level_analysis: Extract per-method metrics via Lizard
         #   include_source_code: Include source code before/after in results
         #   process_metrics: "standard" or "full" PyDriller process metrics
+        #   commit_order: "newest_first" (default) or "oldest_first"
         self.clone_path = clone_path or Path.cwd() / "greenmining_repos"
         self.clone_path.mkdir(parents=True, exist_ok=True)
         self.max_commits = max_commits
@@ -230,6 +232,7 @@ class LocalRepoAnalyzer:
         self.skip_merges = skip_merges
         self.compute_process_metrics = compute_process_metrics
         self.cleanup_after = cleanup_after
+        self.commit_order = commit_order
         self.gsf_patterns = GSF_PATTERNS
 
         # Phase 1.3: Private repository support
@@ -459,6 +462,8 @@ class LocalRepoAnalyzer:
         }
         if self.to_date:
             repo_config["to"] = self.to_date
+        if self.commit_order == "oldest_first":
+            repo_config["order"] = "reverse"
 
         # Use owner_repo format for unique directory names (avoids collisions
         # when multiple repos share the same name, e.g. open-android/Android
@@ -639,6 +644,9 @@ class LocalRepoAnalyzer:
             colored_print(f"\n[{i}/{len(urls)}] Processing repository...", "cyan")
             try:
                 result = self.analyze_repository(url)
+                if result.total_commits == 0:
+                    colored_print(f"   Skipping {result.name}: no commits in date range", "yellow")
+                    continue
                 results.append(result)
             except Exception as e:
                 colored_print(f"   Error analyzing {url}: {e}", "red")
@@ -656,6 +664,9 @@ class LocalRepoAnalyzer:
                 url = future_to_url[future]
                 try:
                     result = future.result()
+                    if result.total_commits == 0:
+                        colored_print(f"   Skipping {result.name}: no commits in date range", "yellow")
+                        continue
                     results.append(result)
                     colored_print(f"   Completed: {result.name}", "green")
                 except Exception as e:

{greenmining-1.2.2 → greenmining-1.2.4/greenmining.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenmining
-Version: 1.2.2
+Version: 1.2.4
 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

{greenmining-1.2.2 → greenmining-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "greenmining"
-version = "1.2.2"
+version = "1.2.4"
 description = "An empirical Python library for Mining Software Repositories (MSR) in Green IT research"
 readme = "README.md"
 requires-python = ">=3.9"