git-contrib-tree 0.1.0__tar.gz → 0.2.1__tar.gz

git_contrib_tree-0.2.1/.gitlab-ci.yml

@@ -0,0 +1,15 @@
+stages:
+  - publish
+
+publish:
+  stage: publish
+  image:
+    name: ghcr.io/astral-sh/uv:debian
+    entrypoint: [""]
+#  rules:
+#    - if: $CI_COMMIT_TAG
+  environment:
+    name: publish
+  script:
+    - uv build
+    - uv publish

{git_contrib_tree-0.1.0 → git_contrib_tree-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-contrib-tree
-Version: 0.1.0
+Version: 0.2.1
 Summary: Analyze and visualize git repository contributions with a file tree showing top contributors.
 Project-URL: Repository, https://gitlab.com/wykwit/git-contrib-tree
 Project-URL: Issues, https://gitlab.com/wykwit/git-contrib-tree/issues
@@ -36,11 +36,30 @@ A Python tool to analyze and visualize git repository contributions by displayin
 - Display repository file tree with top contributors per file
 - Show top 3 contributors for directories (aggregated from all files within)
 - Show commit counts alongside contributor names
-- Filter by date range (--since/--until)
+- Default time filter: analyzes last 3 months of contributions
+- Filter by custom date range (--since/--until) or use `-1` for all history
 - Filter by contributor email(s)
 - List all contributor emails
 - Control tree depth (useful for large repositories)
-- Analyze specific subtrees within a repository
+- Simple path argument: accepts absolute repo paths or relative paths within repo
+
+## Quick Start
+
+```bash
+# Analyze current directory (defaults to last 3 months)
+git contrib-tree
+
+# Show project-level overview
+git contrib-tree --depth 0
+
+# See who worked on what in the last 6 months
+git contrib-tree --since "6 months ago"
+
+# List all contributors
+git contrib-tree --list-emails
+```
+
+See [Usage](#usage) section for more detailed examples and options.
 
 ## Requirements
 
@@ -54,6 +73,17 @@ No external dependencies required - uses only Python standard library and git.
 
 ### Using uv (Recommended)
 
+**Run without installing:**
+```bash
+uvx git-contrib-tree
+```
+
+**Install as a tool:**
+```bash
+uv tool install git-contrib-tree
+```
+
+**Install in a virtual environment:**
 ```bash
 uv pip install git-contrib-tree
 ```
@@ -64,7 +94,7 @@ uv pip install git-contrib-tree
 pip install git-contrib-tree
 ```
 
-### Arch Linux (AUR)
+### From AUR (Recommended on Arch Linux)
 
 ```bash
 # Using an AUR helper
@@ -75,30 +105,17 @@ This installs the `git-contrib-tree` command, making it available as both:
 - A standalone command: `git-contrib-tree`
 - A git subcommand: `git contrib-tree`
 
-### Development Installation
-
-For development, clone the repository and install in editable mode:
-
-```bash
-git clone https://gitlab.com/wykwit/git-contrib-tree.git
-cd git-contrib-tree
-uv pip install -e .
-```
-
 ### Standalone Script
 
 The `git-contrib-tree` script is a self-contained Python file with no external dependencies. You can use it directly without installing the package:
 
 ```bash
 # Download the script
-curl -O https://gitlab.com/wykwit/git-contrib-tree/-/raw/main/git-contrib-tree
+curl -o git-contrib-tree https://gitlab.com/wykwit/git-contrib-tree/-/raw/main/git-contrib-tree.py
 chmod +x git-contrib-tree
 
 # Run it directly
 ./git-contrib-tree --help
-
-# Or with Python
-python3 git-contrib-tree --help
 ```
 
 This is useful for:
@@ -106,20 +123,14 @@ This is useful for:
 - Including in other projects or scripts
 - Running on systems where you can't install packages
 
-## Quick Start
-
-```bash
-# Analyze current directory
-git contrib-tree
-
-# Show project-level overview
-git contrib-tree --depth 0
+### Development Installation
 
-# See who worked on what in the last quarter
-git contrib-tree --since "3 months ago"
+For development, clone the repository and install in editable mode:
 
-# List all contributors
-git contrib-tree --list-emails
+```bash
+git clone https://gitlab.com/wykwit/git-contrib-tree.git
+cd git-contrib-tree
+uv pip install -e .
 ```
 
 ## Usage
@@ -127,11 +138,17 @@ git contrib-tree --list-emails
 ### Basic Usage
 
 ```bash
-# Analyze current directory
+# Analyze current directory (default: last 3 months)
 git contrib-tree
 
-# Analyze specific repository
-git contrib-tree --repo /path/to/repo
+# Analyze specific directory (relative to current location)
+git contrib-tree src
+
+# Analyze different repository (absolute path)
+git contrib-tree /path/to/repo
+
+# Analyze specific file
+git contrib-tree README.md
 ```
 
 ### Depth Control
@@ -152,26 +169,35 @@ git contrib-tree --depth -1
 
 **Note:** Depth controls what is *displayed*, not what is analyzed. Directory summaries always include all files within them, even if those files are not shown due to depth limits.
 
-### Analyze Specific Path
+### Analyze Specific Paths
 
 ```bash
-# Analyze only the src directory
-git contrib-tree --path src
+# Analyze the src directory (relative to current location)
+git contrib-tree src
 
-# Analyze only src/models with depth 1
-git contrib-tree --path src/models --depth 1
+# Analyze src/models with depth 1
+git contrib-tree src/models --depth 1
 
-# Analyze specific file
-git contrib-tree --path README.md --depth 0
+# Analyze specific file with project-level view
+git contrib-tree README.md --depth 0
+
+# Analyze different repository
+git contrib-tree /absolute/path/to/other/repo
+
+# Combine with date filter
+git contrib-tree src --since "6 months ago"
 ```
 
 ### Date Filtering
 
 ```bash
+# Analyze all history
+git contrib-tree --since -1
+
 # Analyze contributions from specific date
 git contrib-tree --since "2024-01-01"
 
-# Analyze last 6 months
+# Analyze last 6 months (default is 3 months)
 git contrib-tree --since "6 months ago"
 
 # Analyze until specific date
@@ -208,14 +234,14 @@ git contrib-tree --email user@example.com --since "6 months ago" --depth 2
 # Analyze last year with depth 2
 git contrib-tree --since "1 year ago" --depth 2
 
-# Analyze specific repo and time period
-git contrib-tree --repo ~/projects/myapp --since "2024-01-01" --depth 3
+# Analyze different repository and time period
+git contrib-tree ~/projects/myapp --since "2024-01-01" --depth 3
 
 # Analyze src directory from last 6 months
-git contrib-tree --path src --since "6 months ago" --depth 2
+git contrib-tree src --since "6 months ago" --depth 2
 
 # See specific author's contributions in a directory
-git contrib-tree --path src --email user@example.com
+git contrib-tree src --email user@example.com
 ```
 
 ## Output Examples
@@ -266,10 +292,9 @@ Contributors:
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `--repo PATH` | `.` | Path to git repository |
+| `path` | `.` | Path to analyze (absolute repo path or relative path within repo) |
 | `--depth N` | `-1` | Maximum tree depth to display (0=project only, -1=unlimited) |
-| `--path PATH` | None | Analyze only this path within the repository |
-| `--since DATE` | None | Show commits after this date |
+| `--since DATE` | `3 months ago` | Show commits after this date (use `-1` for all history) |
 | `--until DATE` | None | Show commits before this date |
 | `--email EMAILS` | None | Filter by author email(s), comma-separated |
 | `--list-emails` | False | List all contributor emails and exit |
@@ -298,13 +323,14 @@ The tool analyzes git history efficiently using batch operations:
 ## Troubleshooting
 
 **"Not a git repository" error:**
-- Ensure you're in a git repository or use `--repo` to specify the path
+- Ensure the path you specified is inside a git repository
 - Run `git status` to verify the directory is a git repository
+- If using a relative path, make sure you're starting from a location within the git repo
 
 **No commits shown:**
-- Check your date filters (`--since`, `--until`) - they might be excluding all commits
+- Check your date filters (`--since`, `--until`) - by default, only the last 3 months are shown
 - Verify files exist in git: `git ls-files`
-- Ensure the specified `--path` exists in the repository
+- Ensure the specified path exists in the repository
 - Check that the `--email` filter matches actual contributor emails (use `--list-emails`)
 
 **Unexpected contributor names:**

{git_contrib_tree-0.1.0 → git_contrib_tree-0.2.1}/README.md

@@ -9,11 +9,30 @@ A Python tool to analyze and visualize git repository contributions by displayin
 - Display repository file tree with top contributors per file
 - Show top 3 contributors for directories (aggregated from all files within)
 - Show commit counts alongside contributor names
-- Filter by date range (--since/--until)
+- Default time filter: analyzes last 3 months of contributions
+- Filter by custom date range (--since/--until) or use `-1` for all history
 - Filter by contributor email(s)
 - List all contributor emails
 - Control tree depth (useful for large repositories)
-- Analyze specific subtrees within a repository
+- Simple path argument: accepts absolute repo paths or relative paths within repo
+
+## Quick Start
+
+```bash
+# Analyze current directory (defaults to last 3 months)
+git contrib-tree
+
+# Show project-level overview
+git contrib-tree --depth 0
+
+# See who worked on what in the last 6 months
+git contrib-tree --since "6 months ago"
+
+# List all contributors
+git contrib-tree --list-emails
+```
+
+See [Usage](#usage) section for more detailed examples and options.
 
 ## Requirements
 
@@ -27,6 +46,17 @@ No external dependencies required - uses only Python standard library and git.
 
 ### Using uv (Recommended)
 
+**Run without installing:**
+```bash
+uvx git-contrib-tree
+```
+
+**Install as a tool:**
+```bash
+uv tool install git-contrib-tree
+```
+
+**Install in a virtual environment:**
 ```bash
 uv pip install git-contrib-tree
 ```
@@ -37,7 +67,7 @@ uv pip install git-contrib-tree
 pip install git-contrib-tree
 ```
 
-### Arch Linux (AUR)
+### From AUR (Recommended on Arch Linux)
 
 ```bash
 # Using an AUR helper
@@ -48,30 +78,17 @@ This installs the `git-contrib-tree` command, making it available as both:
 - A standalone command: `git-contrib-tree`
 - A git subcommand: `git contrib-tree`
 
-### Development Installation
-
-For development, clone the repository and install in editable mode:
-
-```bash
-git clone https://gitlab.com/wykwit/git-contrib-tree.git
-cd git-contrib-tree
-uv pip install -e .
-```
-
 ### Standalone Script
 
 The `git-contrib-tree` script is a self-contained Python file with no external dependencies. You can use it directly without installing the package:
 
 ```bash
 # Download the script
-curl -O https://gitlab.com/wykwit/git-contrib-tree/-/raw/main/git-contrib-tree
+curl -o git-contrib-tree https://gitlab.com/wykwit/git-contrib-tree/-/raw/main/git-contrib-tree.py
 chmod +x git-contrib-tree
 
 # Run it directly
 ./git-contrib-tree --help
-
-# Or with Python
-python3 git-contrib-tree --help
 ```
 
 This is useful for:
@@ -79,20 +96,14 @@ This is useful for:
 - Including in other projects or scripts
 - Running on systems where you can't install packages
 
-## Quick Start
-
-```bash
-# Analyze current directory
-git contrib-tree
-
-# Show project-level overview
-git contrib-tree --depth 0
+### Development Installation
 
-# See who worked on what in the last quarter
-git contrib-tree --since "3 months ago"
+For development, clone the repository and install in editable mode:
 
-# List all contributors
-git contrib-tree --list-emails
+```bash
+git clone https://gitlab.com/wykwit/git-contrib-tree.git
+cd git-contrib-tree
+uv pip install -e .
 ```
 
 ## Usage
@@ -100,11 +111,17 @@ git contrib-tree --list-emails
 ### Basic Usage
 
 ```bash
-# Analyze current directory
+# Analyze current directory (default: last 3 months)
 git contrib-tree
 
-# Analyze specific repository
-git contrib-tree --repo /path/to/repo
+# Analyze specific directory (relative to current location)
+git contrib-tree src
+
+# Analyze different repository (absolute path)
+git contrib-tree /path/to/repo
+
+# Analyze specific file
+git contrib-tree README.md
 ```
 
 ### Depth Control
@@ -125,26 +142,35 @@ git contrib-tree --depth -1
 
 **Note:** Depth controls what is *displayed*, not what is analyzed. Directory summaries always include all files within them, even if those files are not shown due to depth limits.
 
-### Analyze Specific Path
+### Analyze Specific Paths
 
 ```bash
-# Analyze only the src directory
-git contrib-tree --path src
+# Analyze the src directory (relative to current location)
+git contrib-tree src
 
-# Analyze only src/models with depth 1
-git contrib-tree --path src/models --depth 1
+# Analyze src/models with depth 1
+git contrib-tree src/models --depth 1
 
-# Analyze specific file
-git contrib-tree --path README.md --depth 0
+# Analyze specific file with project-level view
+git contrib-tree README.md --depth 0
+
+# Analyze different repository
+git contrib-tree /absolute/path/to/other/repo
+
+# Combine with date filter
+git contrib-tree src --since "6 months ago"
 ```
 
 ### Date Filtering
 
 ```bash
+# Analyze all history
+git contrib-tree --since -1
+
 # Analyze contributions from specific date
 git contrib-tree --since "2024-01-01"
 
-# Analyze last 6 months
+# Analyze last 6 months (default is 3 months)
 git contrib-tree --since "6 months ago"
 
 # Analyze until specific date
@@ -181,14 +207,14 @@ git contrib-tree --email user@example.com --since "6 months ago" --depth 2
 # Analyze last year with depth 2
 git contrib-tree --since "1 year ago" --depth 2
 
-# Analyze specific repo and time period
-git contrib-tree --repo ~/projects/myapp --since "2024-01-01" --depth 3
+# Analyze different repository and time period
+git contrib-tree ~/projects/myapp --since "2024-01-01" --depth 3
 
 # Analyze src directory from last 6 months
-git contrib-tree --path src --since "6 months ago" --depth 2
+git contrib-tree src --since "6 months ago" --depth 2
 
 # See specific author's contributions in a directory
-git contrib-tree --path src --email user@example.com
+git contrib-tree src --email user@example.com
 ```
 
 ## Output Examples
@@ -239,10 +265,9 @@ Contributors:
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `--repo PATH` | `.` | Path to git repository |
+| `path` | `.` | Path to analyze (absolute repo path or relative path within repo) |
 | `--depth N` | `-1` | Maximum tree depth to display (0=project only, -1=unlimited) |
-| `--path PATH` | None | Analyze only this path within the repository |
-| `--since DATE` | None | Show commits after this date |
+| `--since DATE` | `3 months ago` | Show commits after this date (use `-1` for all history) |
 | `--until DATE` | None | Show commits before this date |
 | `--email EMAILS` | None | Filter by author email(s), comma-separated |
 | `--list-emails` | False | List all contributor emails and exit |
@@ -271,13 +296,14 @@ The tool analyzes git history efficiently using batch operations:
 ## Troubleshooting
 
 **"Not a git repository" error:**
-- Ensure you're in a git repository or use `--repo` to specify the path
+- Ensure the path you specified is inside a git repository
 - Run `git status` to verify the directory is a git repository
+- If using a relative path, make sure you're starting from a location within the git repo
 
 **No commits shown:**
-- Check your date filters (`--since`, `--until`) - they might be excluding all commits
+- Check your date filters (`--since`, `--until`) - by default, only the last 3 months are shown
 - Verify files exist in git: `git ls-files`
-- Ensure the specified `--path` exists in the repository
+- Ensure the specified path exists in the repository
 - Check that the `--email` filter matches actual contributor emails (use `--list-emails`)
 
 **Unexpected contributor names:**

git_contrib_tree-0.1.0/git-contrib-tree → git_contrib_tree-0.2.1/git-contrib-tree.py

@@ -16,6 +16,7 @@ from typing import Dict, List, Optional, Set, Tuple
 
 TOP_CONTRIBUTORS_LIMIT = 3
 NULL_SEPARATOR = "\x00"
+PROJECT_CACHE_KEY = "__PROJECT__"
 
 
 class GitContributionAnalyzer:
@@ -137,7 +138,7 @@ class GitContributionAnalyzer:
         Returns:
             List of tuples (author_name, commit_count) for top 3 contributors
         """
-        cache_key = file_path or "__PROJECT__"
+        cache_key = file_path or PROJECT_CACHE_KEY
 
         if cache_key in self._file_contributors_cache:
             return self._file_contributors_cache[cache_key]
@@ -509,6 +510,26 @@ class GitContributionAnalyzer:
                     print(f"{prefix}{connector}{name} - {contrib_str}")
 
 
+def find_git_repo_root(path: Path) -> Optional[Path]:
+    """Find the git repository root by traversing up the directory tree."""
+    if not path.exists():
+        return None
+
+    current = path.resolve()
+    while current != current.parent:
+        if (current / ".git").exists():
+            return current
+        current = current.parent
+    return None
+
+
+def parse_email_list(emails_string: Optional[str]) -> Optional[Set[str]]:
+    """Parse a comma-separated string of emails into a set."""
+    if not emails_string:
+        return None
+    return {email.strip() for email in emails_string.split(",") if email.strip()}
+
+
 def parse_args():
     """Parse command line arguments."""
     parser = argparse.ArgumentParser(
@@ -516,24 +537,25 @@ def parse_args():
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
-  %(prog)s                              # Analyze entire repository
-  %(prog)s --depth 0                    # Show only project-level contributors
+  %(prog)s                              # Analyze current directory in repo (last 3 months)
+  %(prog)s --since -1                   # Analyze entire history
+  %(prog)s src                          # Analyze src directory (relative to current dir)
+  %(prog)s /absolute/path/to/repo       # Analyze different repository
+  %(prog)s --depth 0                    # Show only top-level contributors
   %(prog)s --depth 2                    # Show files up to depth 2
-  %(prog)s --path src                   # Analyze only src directory
-  %(prog)s --path src/models --depth 1  # Analyze src/models up to depth 1
   %(prog)s --since "2024-01-01"         # Analyze from specific date
   %(prog)s --since "6 months ago"       # Analyze last 6 months
   %(prog)s --until "2024-12-31"         # Analyze until specific date
-  %(prog)s --repo /path/to/repo         # Analyze different repository
   %(prog)s --email user@example.com     # Show only contributions by specific author
   %(prog)s --email user1@ex.com,user2@ex.com  # Show contributions by multiple authors
         """,
     )
 
     parser.add_argument(
-        "--repo",
+        "path",
+        nargs="?",
         default=".",
-        help="Path to git repository (default: current directory)",
+        help="Path to analyze (default: current directory). Can be absolute path to a repo, or relative path within repo.",
     )
 
     parser.add_argument(
@@ -543,13 +565,10 @@ Examples:
         help="Maximum tree depth (0 = project only, -1 = unlimited, default: -1)",
     )
 
-    parser.add_argument(
-        "--path", help="Path within repository to analyze (e.g., 'src', 'src/models')"
-    )
-
     parser.add_argument(
         "--since",
-        help="Show commits after this date (git date format, e.g., '2024-01-01', '6 months ago')",
+        default="3 months ago",
+        help="Show commits after this date (git date format, default: '3 months ago'). Use '-1' for all history.",
     )
 
     parser.add_argument(
@@ -575,17 +594,29 @@ def main():
     args = parse_args()
 
     try:
-        author_emails = None
-        if args.email:
-            author_emails = set(
-                email.strip() for email in args.email.split(",") if email.strip()
-            )
+        target_path = Path(args.path)
+
+        repo_root = find_git_repo_root(target_path)
+        if not repo_root:
+            raise ValueError(f"No git repository found for path: {target_path}")
+
+        subtree_path = None
+        try:
+            relative = target_path.resolve().relative_to(repo_root)
+            if str(relative) != ".":
+                subtree_path = str(relative)
+        except ValueError:
+            pass
+
+        author_emails = parse_email_list(args.email)
+
+        since = None if args.since == "-1" else args.since
 
         analyzer = GitContributionAnalyzer(
-            repo_path=args.repo,
-            since=args.since,
+            repo_path=str(repo_root),
+            since=since,
             until=args.until,
-            subtree_path=args.path,
+            subtree_path=subtree_path,
             author_emails=author_emails,
         )
 

{git_contrib_tree-0.1.0 → git_contrib_tree-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "git-contrib-tree"
-version = "0.1.0"
+version = "0.2.1"
 description = "Analyze and visualize git repository contributions with a file tree showing top contributors."
 readme = "README.md"
 requires-python = ">=3.6"
@@ -28,7 +28,7 @@ classifiers = [
 ]
 
 [project.scripts]
-git-contrib-tree = "wrapper:main"
+git-contrib-tree = "git_contrib_tree:main"
 
 [project.urls]
 Repository = "https://gitlab.com/wykwit/git-contrib-tree"
@@ -38,5 +38,5 @@ Issues = "https://gitlab.com/wykwit/git-contrib-tree/issues"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.hatch.build.targets.wheel]
-packages = ["wrapper.py", "git-contrib-tree"]
+[tool.hatch.build.targets.wheel.force-include]
+"git-contrib-tree.py" = "git_contrib_tree/__init__.py"

git_contrib_tree-0.1.0/wrapper.py

@@ -1,40 +0,0 @@
-"""
-Wrapper module for git-contrib-tree.
-
-This wrapper allows us to keep the git-contrib-tree filename (with dash)
-while providing a valid Python module for package entry points.
-"""
-
-import importlib.util
-import sys
-from pathlib import Path
-
-
-def main():
-    """Entry point that loads and executes git-contrib-tree."""
-    # Find the script in the same directory as this wrapper
-    script_path = Path(__file__).parent / "git-contrib-tree"
-    
-    if not script_path.exists():
-        print(f"Error: Could not find git-contrib-tree at {script_path}", file=sys.stderr)
-        sys.exit(1)
-    
-    # Use spec_from_loader with SourceFileLoader to load files without .py extension
-    from importlib.machinery import SourceFileLoader
-    loader = SourceFileLoader("git_contrib_tree_mod", str(script_path))
-    spec = importlib.util.spec_from_loader("git_contrib_tree_mod", loader)
-    
-    if spec is None or spec.loader is None:
-        print(f"Error: Could not create loader for git-contrib-tree from {script_path}", file=sys.stderr)
-        sys.exit(1)
-    
-    module = importlib.util.module_from_spec(spec)
-    sys.modules["git_contrib_tree_mod"] = module
-    spec.loader.exec_module(module)
-    
-    # Execute the main function from the loaded module
-    return module.main()
-
-
-if __name__ == "__main__":
-    sys.exit(main())