gitflow-analytics 3.9.2__py3-none-any.whl → 3.10.4__py3-none-any.whl

gitflow_analytics/_version.py

@@ -1,4 +1,4 @@
 """Version information for gitflow-analytics."""
 
-__version__ = "3.9.2"
+__version__ = "3.10.4"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

gitflow_analytics/cli_wizards/install_wizard.py

@@ -7,6 +7,8 @@ and comprehensive configuration generation.
 import getpass
 import logging
 import os
+import re
+import shutil
 import stat
 import subprocess
 import sys
@@ -18,6 +20,8 @@ from typing import Optional
 import click
 import requests
 import yaml
+from git import GitCommandError, Repo
+from git.exc import InvalidGitRepositoryError
 from github import Github
 from github.GithubException import GithubException
 
@@ -490,6 +494,203 @@ class InstallWizard:
             logger.debug(f"Path validation error: {type(e).__name__}")
             return None
 
+    def _detect_git_url(self, input_str: str) -> Optional[str]:
+        """Detect if input is a Git URL and normalize it.
+
+        Args:
+            input_str: User input string
+
+        Returns:
+            Normalized Git URL if detected, None if it's a local path
+        """
+        import re
+
+        # HTTPS URL patterns
+        https_pattern = r"^https?://[^/]+/[^/]+/[^/]+(?:\.git)?$"
+        # SSH URL pattern
+        ssh_pattern = r"^git@[^:]+:[^/]+/[^/]+(?:\.git)?$"
+
+        input_str = input_str.strip()
+
+        if re.match(https_pattern, input_str, re.IGNORECASE) or re.match(ssh_pattern, input_str):
+            # Ensure .git extension for consistency
+            if not input_str.endswith(".git"):
+                input_str = input_str + ".git"
+            return input_str
+
+        return None
+
+    def _clone_git_repository(self, git_url: str) -> Optional[tuple[Path, str]]:
+        """Clone a Git repository to the local repos/ directory.
+
+        Args:
+            git_url: Git URL to clone
+
+        Returns:
+            Tuple of (local_path, original_url) if successful, None if failed
+        """
+        try:
+            # Extract repository name from URL
+            # Handle both HTTPS and SSH formats
+            match = re.search(r"/([^/]+?)(?:\.git)?$", git_url)
+            if not match:
+                click.echo("❌ Could not extract repository name from URL")
+                return None
+
+            repo_name = match.group(1)
+            click.echo(f"📦 Repository: {repo_name}")
+
+            # Create repos directory in current working directory
+            repos_dir = Path.cwd() / "repos"
+            repos_dir.mkdir(parents=True, exist_ok=True)
+            click.echo(f"📁 Clone directory: {repos_dir}")
+
+            # Target path for cloned repository
+            target_path = repos_dir / repo_name
+
+            # Check if repository already exists
+            if target_path.exists():
+                click.echo(f"⚠️  Directory already exists: {target_path}")
+
+                # Check if it's a valid git repository
+                try:
+                    existing_repo = Repo(target_path)
+                    if existing_repo.working_dir:
+                        click.echo("✅ Found existing git repository")
+
+                        # Check if remote URL matches
+                        try:
+                            origin_url = existing_repo.remotes.origin.url
+                            if origin_url == git_url or self._normalize_git_url(
+                                origin_url
+                            ) == self._normalize_git_url(git_url):
+                                click.echo(f"✅ Remote URL matches: {origin_url}")
+
+                                # Offer to update
+                                if click.confirm(
+                                    "Update existing repository (git pull)?", default=True
+                                ):
+                                    click.echo("🔄 Updating repository...")
+                                    origin = existing_repo.remotes.origin
+                                    origin.pull()
+                                    click.echo("✅ Repository updated")
+
+                                return (target_path, git_url)
+                            else:
+                                click.echo("⚠️  Remote URL mismatch:")
+                                click.echo(f"   Existing: {origin_url}")
+                                click.echo(f"   Requested: {git_url}")
+                                if not click.confirm(
+                                    "Use existing repository anyway?", default=False
+                                ):
+                                    return None
+                                return (target_path, git_url)
+                        except Exception as e:
+                            click.echo(f"⚠️  Could not check remote URL: {type(e).__name__}")
+                            if click.confirm("Use existing repository anyway?", default=False):
+                                return (target_path, git_url)
+                            return None
+                except InvalidGitRepositoryError:
+                    click.echo("❌ Directory exists but is not a git repository")
+                    if not click.confirm("Remove and re-clone?", default=False):
+                        return None
+
+                    # Remove existing directory
+                    shutil.rmtree(target_path)
+                    click.echo("🗑️  Removed existing directory")
+
+            # Clone the repository
+            click.echo(f"🔄 Cloning {git_url}...")
+            click.echo("   This may take a moment depending on repository size...")
+
+            # Clone with progress
+            Repo.clone_from(git_url, target_path, progress=self._get_git_progress())
+
+            # Verify clone succeeded
+            if not (target_path / ".git").exists():
+                click.echo("❌ Clone appeared to succeed but .git directory not found")
+                return None
+
+            click.echo(f"✅ Successfully cloned to: {target_path}")
+            return (target_path, git_url)
+
+        except GitCommandError as e:
+            click.echo("❌ Git clone failed")
+
+            # Parse error message for common issues
+            error_str = str(e).lower()
+            if "authentication failed" in error_str or "permission denied" in error_str:
+                click.echo("🔐 Authentication required")
+                click.echo("   For HTTPS: Configure Git credentials or use a personal access token")
+                click.echo("   For SSH: Ensure your SSH key is added to your Git provider")
+            elif "not found" in error_str or "does not exist" in error_str:
+                click.echo("🔍 Repository not found")
+                click.echo("   Check the URL and ensure you have access")
+            elif "network" in error_str or "timeout" in error_str:
+                click.echo("🌐 Network error")
+                click.echo("   Check your internet connection and try again")
+            else:
+                logger.debug(f"Git clone error type: {type(e).__name__}")
+
+            return None
+
+        except OSError as e:
+            error_type = type(e).__name__
+            click.echo(f"❌ File system error: {error_type}")
+            if "space" in str(e).lower():
+                click.echo("💾 Insufficient disk space")
+            logger.debug(f"Clone file system error: {error_type}")
+            return None
+
+        except Exception as e:
+            error_type = type(e).__name__
+            click.echo(f"❌ Unexpected error during clone: {error_type}")
+            logger.error(f"Clone error type: {error_type}")
+            return None
+
+    def _normalize_git_url(self, url: str) -> str:
+        """Normalize Git URL for comparison.
+
+        Args:
+            url: Git URL to normalize
+
+        Returns:
+            Normalized URL (lowercase, with .git extension)
+        """
+        url = url.lower().strip()
+        if not url.endswith(".git"):
+            url = url + ".git"
+        return url
+
+    def _get_git_progress(self):
+        """Get a Git progress handler for clone operations.
+
+        Returns:
+            Progress handler for GitPython or None
+        """
+        try:
+            from git import RemoteProgress
+
+            class CloneProgress(RemoteProgress):
+                """Progress handler for git clone operations."""
+
+                def __init__(self):
+                    super().__init__()
+                    self.last_percent = 0
+
+                def update(self, op_code, cur_count, max_count=None, message=""):
+                    if max_count:
+                        percent = int((cur_count / max_count) * 100)
+                        # Only show updates every 10%
+                        if percent >= self.last_percent + 10:
+                            click.echo(f"   Progress: {percent}%")
+                            self.last_percent = percent
+
+            return CloneProgress()
+        except Exception:
+            # If progress handler fails, return None (clone will work without it)
+            return None
+
     def _setup_manual_repos(self) -> bool:
         """Setup manual repository configuration.
 
@@ -497,44 +698,66 @@ class InstallWizard:
             True if setup successful, False otherwise
         """
         click.echo("\n📦 Manual Repository Mode")
-        click.echo("You can specify one or more local repository paths.")
+        click.echo("You can specify one or more local repository paths or Git URLs.")
+        click.echo("Supported formats:")
+        click.echo("  • Local path: /path/to/repo or ~/repos/myproject")
+        click.echo("  • HTTPS URL: https://github.com/owner/repo.git")
+        click.echo("  • SSH URL: git@github.com:owner/repo.git")
         click.echo()
 
         repositories = []
         while True:
-            repo_path_str = click.prompt(
-                "Enter repository path (or press Enter to finish)",
+            repo_input = click.prompt(
+                "Enter repository path or Git URL (or press Enter to finish)",
                 type=str,
                 default="",
                 show_default=False,
             ).strip()
 
-            if not repo_path_str:
+            if not repo_input:
                 if not repositories:
                     click.echo("❌ At least one repository is required")
                     continue
                 break
 
-            # Validate path is safe
-            path_obj = self._validate_directory_path(repo_path_str, "Repository path")
-            if path_obj is None:
-                continue  # Re-prompt
-
-            if not path_obj.exists():
-                click.echo(f"⚠️  Path does not exist: {path_obj}")
-                if not click.confirm("Add anyway?", default=False):
+            # Check if input is a Git URL
+            git_url = self._detect_git_url(repo_input)
+            if git_url:
+                # Handle Git URL cloning
+                result = self._clone_git_repository(git_url)
+                if result is None:
+                    # Clone failed, ask user if they want to retry or skip
+                    if not click.confirm("Try a different repository?", default=True):
+                        if repositories:
+                            break  # User has other repos, can finish
+                        continue  # User has no repos yet, must add at least one
                     continue
 
-            # Check if it's a git repository
-            if (path_obj / ".git").exists():
-                click.echo(f"✅ Valid git repository: {path_obj}")
+                # Clone successful
+                local_path, original_url = result
+                repositories.append({"path": str(local_path), "git_url": original_url})
+                click.echo(f"Added repository #{len(repositories)}")
             else:
-                click.echo(f"⚠️  Not a git repository: {path_obj}")
-                if not click.confirm("Add anyway?", default=False):
-                    continue
+                # Handle local path
+                path_obj = self._validate_directory_path(repo_input, "Repository path")
+                if path_obj is None:
+                    continue  # Re-prompt
+
+                if not path_obj.exists():
+                    click.echo(f"⚠️  Path does not exist: {path_obj}")
+                    if not click.confirm("Add anyway?", default=False):
+                        continue
+
+                # Check if it's a git repository
+                if (path_obj / ".git").exists():
+                    click.echo(f"✅ Valid git repository: {path_obj}")
+                else:
+                    click.echo(f"⚠️  Not a git repository: {path_obj}")
+                    if not click.confirm("Add anyway?", default=False):
+                        continue
 
-            repositories.append({"path": str(path_obj)})
-            click.echo(f"Added repository #{len(repositories)}")
+                repositories.append({"path": str(path_obj)})
+                click.echo(f"Added repository #{len(repositories)}")
 
             if not click.confirm("Add another repository?", default=False):
                 break

gitflow_analytics/metrics/activity_scoring.py

@@ -82,11 +82,15 @@ class ActivityScorer:
             + complexity_score * self.WEIGHTS["complexity"]
         )
 
+        # Determine if PR data is available for proper normalization
+        has_pr_data = prs > 0
+
         return {
             "raw_score": raw_score,
-            "normalized_score": self._normalize_score(raw_score),
+            "normalized_score": self._normalize_score(raw_score, has_pr_data),
             "components": components,
-            "activity_level": self._get_activity_level(raw_score),
+            "activity_level": self._get_activity_level(raw_score, has_pr_data),
+            "has_pr_data": has_pr_data,
         }
 
     def _calculate_commit_score(self, commits: int) -> float:
@@ -169,8 +173,13 @@ class ActivityScorer:
 
         return max(0, file_score + complexity_bonus)
 
-    def _normalize_score(self, raw_score: float) -> float:
-        """Normalize score to 0-100 range."""
+    def _normalize_score(self, raw_score: float, has_pr_data: bool = True) -> float:
+        """Normalize score to 0-100 range.
+
+        Args:
+            raw_score: The calculated raw activity score
+            has_pr_data: Whether PR data was available (affects normalization divisor)
+        """
         # Based on research, a highly productive week might have:
         # - 15 commits (150 points after scaling)
         # - 3 PRs of optimal size (180 points)
@@ -178,12 +187,17 @@ class ActivityScorer:
         # - 20 files changed (50 points)
         # Total: ~500 points = 100 normalized
 
-        normalized = (raw_score / 500) * 100
+        # When PR data is unavailable (e.g., weekly reports), adjust divisor
+        # since PR component (30% weight) contributes 0
+        # Effective max becomes 70% of 50 = 35
+        divisor = 35 if not has_pr_data else 50
+
+        normalized = (raw_score / divisor) * 100
         return min(100, normalized)  # Cap at 100
 
-    def _get_activity_level(self, raw_score: float) -> str:
+    def _get_activity_level(self, raw_score: float, has_pr_data: bool = True) -> str:
         """Categorize activity level based on score."""
-        normalized = self._normalize_score(raw_score)
+        normalized = self._normalize_score(raw_score, has_pr_data)
 
         if normalized >= 80:
             return "exceptional"

{gitflow_analytics-3.9.2.dist-info → gitflow_analytics-3.10.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitflow-analytics
-Version: 3.9.2
+Version: 3.10.4
 Summary: Analyze Git repositories for developer productivity insights
 Author-email: Bob Matyas <bobmatnyc@gmail.com>
 License: MIT

{gitflow_analytics-3.9.2.dist-info → gitflow_analytics-3.10.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 gitflow_analytics/__init__.py,sha256=W3Jaey5wuT1nBPehVLTIRkVIyBa5jgYOlBKc_UFfh-4,773
-gitflow_analytics/_version.py,sha256=1vJ2cOJm4JBq3ASHO5cRbx3_lFVH3QIh1Caj_cSjWN4,137
+gitflow_analytics/_version.py,sha256=Ern03L7_bWd8JxtBPPk3W30NHPMvxVnsv_nDZU6D_sM,138
 gitflow_analytics/cli.py,sha256=pYW6V0b6SRa3-NyOmXGQhf5emcKHUHgOVL2PFOAS8LQ,273331
 gitflow_analytics/config.py,sha256=XRuxvzLWyn_ML7mDCcuZ9-YFNAEsnt33vIuWxQQ_jxg,1033
 gitflow_analytics/constants.py,sha256=GXEncUJS9ijOI5KWtQCTANwdqxPfXpw-4lNjhaWTKC4,2488
@@ -11,7 +11,7 @@ gitflow_analytics/classification/feature_extractor.py,sha256=W82vztPQO8-MFw9Yt17
 gitflow_analytics/classification/linguist_analyzer.py,sha256=HjLx9mM7hGXtrvMba6osovHJLAacTx9oDmN6CS5w0bE,17687
 gitflow_analytics/classification/model.py,sha256=2KbmFh9MpyvHMcNHbqwUTAAVLHHu3MiTfFIPyZSGa-8,16356
 gitflow_analytics/cli_wizards/__init__.py,sha256=D73D97cS1hZsB_fCQQaAiWtd_w2Lb8TtcGc9Pn2DIyE,343
-gitflow_analytics/cli_wizards/install_wizard.py,sha256=KcmDD2RiqFrPuXdBhmXCYvftlV_V-_7p82Z6Gu8NgO0,60817
+gitflow_analytics/cli_wizards/install_wizard.py,sha256=gz5c1NYeGLCzs-plL6ju7GXn7VldF7VyMw8MO4CzUGk,70345
 gitflow_analytics/cli_wizards/run_launcher.py,sha256=J6G_C7IqxPg7_GhAfbV99D1dIIWwb1s_qmHC7Iv2iGI,15038
 gitflow_analytics/config/__init__.py,sha256=KziRIbBJctB5LOLcKLzELWA1rXwjS6-C2_DeM_hT9rM,1133
 gitflow_analytics/config/aliases.py,sha256=z9F0X6qbbF544Tw7sHlOoBj5mpRSddMkCpoKLzvVzDU,10960
@@ -47,7 +47,7 @@ gitflow_analytics/integrations/github_integration.py,sha256=52lyq5GNJIlTXIv7iwrk
 gitflow_analytics/integrations/jira_integration.py,sha256=3DV1hGNs1HxAOSGt2BfqBrWSigRN5H8BT1-G7E_8hGg,28761
 gitflow_analytics/integrations/orchestrator.py,sha256=u3FKZF2yD5g5HhNFm6nIJe69ZKfU1QLni4S14GDRIrY,13205
 gitflow_analytics/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gitflow_analytics/metrics/activity_scoring.py,sha256=h1uj_6dTKpCwNJfsimfaY0TB3Qaexw7I7IEFutoHwUY,12539
+gitflow_analytics/metrics/activity_scoring.py,sha256=lSrdeH9SVNzeSR80vvzdWBuFcD3BkHsOdSZu97q6Bdg,13171
 gitflow_analytics/metrics/branch_health.py,sha256=MkfyiUc1nHEakKBJ_uTlvxmofX1QX_s4hm4XBTYKVLM,17522
 gitflow_analytics/metrics/dora.py,sha256=U4Xk0tr7kPcpR7r-PevYBUDtZPkDIG-w_yS2DJOlTrk,27549
 gitflow_analytics/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -120,9 +120,9 @@ gitflow_analytics/training/model_loader.py,sha256=xGZLSopGxDhC--2XN6ytRgi2CyjOKY
 gitflow_analytics/training/pipeline.py,sha256=PQegTk_-OsPexVyRDfiy-3Df-7pcs25C4vPASr-HT9E,19951
 gitflow_analytics/ui/__init__.py,sha256=UBhYhZMvwlSrCuGWjkIdoP2zNbiQxOHOli-I8mqIZUE,441
 gitflow_analytics/ui/progress_display.py,sha256=3xJnCOSs1DRVAfS-rTu37EsLfWDFW5-mbv-bPS9NMm4,59182
-gitflow_analytics-3.9.2.dist-info/licenses/LICENSE,sha256=xwvSwY1GYXpRpmbnFvvnbmMwpobnrdN9T821sGvjOY0,1066
-gitflow_analytics-3.9.2.dist-info/METADATA,sha256=zFtrIA8qcqvHtfmDMA9wqTLf2RQbhweU02RzzqqeerY,36830
-gitflow_analytics-3.9.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gitflow_analytics-3.9.2.dist-info/entry_points.txt,sha256=ZOsX0GLsnMysp5FWPOfP_qyoS7WJ8IgcaDFDxWBYl1g,98
-gitflow_analytics-3.9.2.dist-info/top_level.txt,sha256=CQyxZXjKvpSB1kgqqtuE0PCRqfRsXZJL8JrYpJKtkrk,18
-gitflow_analytics-3.9.2.dist-info/RECORD,,
+gitflow_analytics-3.10.4.dist-info/licenses/LICENSE,sha256=xwvSwY1GYXpRpmbnFvvnbmMwpobnrdN9T821sGvjOY0,1066
+gitflow_analytics-3.10.4.dist-info/METADATA,sha256=OASbKCl7rhlw1eGy1I2zkKOUNHkMHgs52przeGpZ4Fc,36831
+gitflow_analytics-3.10.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gitflow_analytics-3.10.4.dist-info/entry_points.txt,sha256=ZOsX0GLsnMysp5FWPOfP_qyoS7WJ8IgcaDFDxWBYl1g,98
+gitflow_analytics-3.10.4.dist-info/top_level.txt,sha256=CQyxZXjKvpSB1kgqqtuE0PCRqfRsXZJL8JrYpJKtkrk,18
+gitflow_analytics-3.10.4.dist-info/RECORD,,