gitpulse-tui 1.2.0__tar.gz → 1.2.2__tar.gz

{gitpulse_tui-1.2.0/gitpulse_tui.egg-info → gitpulse_tui-1.2.2}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: gitpulse-tui
-Version: 1.2.0
+Version: 1.2.2
 Summary: Git Repo Dashboard TUI — live status, commits, diffs, and branches in your terminal
 Requires-Python: >=3.10
 License-File: LICENSE
 Requires-Dist: textual>=0.50.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: gitpython>=3.1.0
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
 Dynamic: license-file

{gitpulse_tui-1.2.0 → gitpulse_tui-1.2.2}/README.md

@@ -14,15 +14,26 @@ Built with **Python**, **Textual**, **Rich**, and **GitPython**.
 
 ![Commits tab](ss/commits.png)
 
-## Install (one command)
+## Installation
+
+The easiest way to install GitPulse is via PyPI using `pip` or `pipx`:
+
+```bash
+pip install gitpulse-tui
+```
+*(We recommend using `pipx install gitpulse-tui` to install it in an isolated environment)*
+
+### Install from source
+
+If you prefer to install from source or want to contribute to the project:
 
 ```bash
-git clone https://github.com/yourname/git-tui.git
+git clone https://github.com/lebiraja/git-tui.git
 cd git-tui
 ./install.sh
 ```
 
-That's it. The installer:
+The installer:
 - Checks your Python version (3.10+ required)
 - Creates a virtual environment automatically
 - Installs all dependencies

gitpulse_tui-1.2.2/gitpulse/config.py

@@ -0,0 +1,169 @@
+"""
+config.py — TOML configuration loader for GitPulse.
+
+Reads ~/.config/gitpulse/config.toml (or a path supplied via --config).
+Uses tomllib (stdlib, Python 3.11+) or tomli (backport, 3.10).
+Missing file → silent fallback to built-in defaults.
+CLI flags always take precedence over config values.
+"""
+
+from __future__ import annotations
+
+import sys
+from dataclasses import dataclass, field
+from pathlib import Path
+
+# tomllib is stdlib on 3.11+; tomli is the backport for 3.10
+if sys.version_info >= (3, 11):
+    import tomllib
+else:
+    try:
+        import tomli as tomllib  # type: ignore[no-redef]
+    except ImportError:
+        tomllib = None  # type: ignore[assignment]
+
+DEFAULT_CONFIG_PATH = Path("~/.config/gitpulse/config.toml")
+EXAMPLE_CONFIG_PATH = Path("~/.config/gitpulse/config.toml.example")
+
+_EXAMPLE_CONTENT = """\
+# GitPulse configuration — copy to config.toml and edit as needed.
+
+[scan]
+# roots = ["~/projects", "~/work"]   # override --root; list of directories to scan
+
+[author]
+# emails = ["you@example.com"]       # used by digest mode; defaults to git config user.email
+
+[watch]
+enabled = true
+interval_seconds = 5
+
+[stale]
+weeks = 8
+default_branches = ["main", "master", "develop", "trunk"]
+
+[bulk]
+max_workers = 8
+
+[digest]
+default_window = "1d"
+"""
+
+
+@dataclass
+class ScanConfig:
+    roots: list[str] = field(default_factory=list)
+
+
+@dataclass
+class AuthorConfig:
+    emails: list[str] = field(default_factory=list)
+
+
+@dataclass
+class WatchConfig:
+    enabled: bool = True
+    interval_seconds: int = 5
+
+
+@dataclass
+class StaleConfig:
+    weeks: int = 8
+    default_branches: list[str] = field(
+        default_factory=lambda: ["main", "master", "develop", "trunk"]
+    )
+
+
+@dataclass
+class BulkConfig:
+    max_workers: int = 8
+
+
+@dataclass
+class DigestConfig:
+    default_window: str = "1d"
+
+
+@dataclass
+class GitPulseConfig:
+    scan: ScanConfig = field(default_factory=ScanConfig)
+    author: AuthorConfig = field(default_factory=AuthorConfig)
+    watch: WatchConfig = field(default_factory=WatchConfig)
+    stale: StaleConfig = field(default_factory=StaleConfig)
+    bulk: BulkConfig = field(default_factory=BulkConfig)
+    digest: DigestConfig = field(default_factory=DigestConfig)
+
+
+def _write_example_if_missing() -> None:
+    example = EXAMPLE_CONFIG_PATH.expanduser()
+    if not example.exists():
+        try:
+            example.parent.mkdir(parents=True, exist_ok=True)
+            example.write_text(_EXAMPLE_CONTENT)
+        except Exception:
+            pass
+
+
+def load(path: Path | None = None) -> GitPulseConfig:
+    """Load and return the GitPulse configuration.
+
+    Falls back to defaults silently if the file is absent or tomli is
+    unavailable. Writes a .example file on first run.
+    """
+    cfg = GitPulseConfig()
+    _write_example_if_missing()
+
+    config_path = (path or DEFAULT_CONFIG_PATH).expanduser()
+    if not config_path.exists():
+        return cfg
+
+    if tomllib is None:
+        # Python 3.10 without tomli installed — use defaults
+        return cfg
+
+    try:
+        with open(config_path, "rb") as fh:
+            raw = tomllib.load(fh)
+    except Exception:
+        return cfg
+
+    if "scan" in raw:
+        s = raw["scan"]
+        cfg.scan.roots = s.get("roots", [])
+
+    if "author" in raw:
+        a = raw["author"]
+        cfg.author.emails = a.get("emails", [])
+
+    if "watch" in raw:
+        w = raw["watch"]
+        cfg.watch.enabled = bool(w.get("enabled", True))
+        cfg.watch.interval_seconds = int(w.get("interval_seconds", 5))
+
+    if "stale" in raw:
+        st = raw["stale"]
+        cfg.stale.weeks = int(st.get("weeks", 8))
+        cfg.stale.default_branches = list(
+            st.get("default_branches", ["main", "master", "develop", "trunk"])
+        )
+
+    if "bulk" in raw:
+        cfg.bulk.max_workers = int(raw["bulk"].get("max_workers", 8))
+
+    if "digest" in raw:
+        cfg.digest.default_window = str(raw["digest"].get("default_window", "1d"))
+
+    return cfg
+
+
+# Module-level singleton — loaded once, reused everywhere.
+# Call load() explicitly if you need a custom path.
+_default: GitPulseConfig | None = None
+
+
+def get() -> GitPulseConfig:
+    """Return the cached default config (loaded once on first call)."""
+    global _default
+    if _default is None:
+        _default = load()
+    return _default

gitpulse_tui-1.2.2/gitpulse/digest.py

@@ -0,0 +1,165 @@
+"""
+digest.py — Activity digest aggregation for GitPulse.
+
+Collects commits authored by a set of email patterns across all scanned repos
+within a time window, groups them by repo, and produces a Digest object.
+Renders as markdown for stdout/clipboard use.
+"""
+
+from __future__ import annotations
+
+import time
+from dataclasses import dataclass, field
+from pathlib import Path
+
+try:
+    from gitpulse.git_ops import RepoInfo, AuthorCommit, get_author_commits, get_author_email
+    from gitpulse.parallel import run_parallel
+    from gitpulse.utils import relative_time
+except ImportError:
+    from git_ops import RepoInfo, AuthorCommit, get_author_commits, get_author_email  # type: ignore
+    from parallel import run_parallel  # type: ignore
+    from utils import relative_time  # type: ignore
+
+
+@dataclass
+class RepoDigest:
+    repo: RepoInfo
+    commits: list[AuthorCommit]
+
+    @property
+    def insertions(self) -> int:
+        return sum(c.insertions for c in self.commits)
+
+    @property
+    def deletions(self) -> int:
+        return sum(c.deletions for c in self.commits)
+
+    @property
+    def files_changed(self) -> int:
+        return sum(c.files_changed for c in self.commits)
+
+
+@dataclass
+class Digest:
+    since_ts: float
+    until_ts: float
+    author_patterns: list[str]
+    by_repo: list[RepoDigest] = field(default_factory=list)
+
+    @property
+    def total_commits(self) -> int:
+        return sum(len(rd.commits) for rd in self.by_repo)
+
+    @property
+    def total_insertions(self) -> int:
+        return sum(rd.insertions for rd in self.by_repo)
+
+    @property
+    def total_deletions(self) -> int:
+        return sum(rd.deletions for rd in self.by_repo)
+
+    @property
+    def repos_active(self) -> int:
+        return len(self.by_repo)
+
+
+def _collect_for_repo(
+    args: tuple[RepoInfo, float, list[str]],
+) -> RepoDigest | None:
+    """Worker target: fetch commits for one repo. Returns None if no commits."""
+    repo, since_ts, author_patterns = args
+    all_commits: list[AuthorCommit] = []
+    for pattern in author_patterns:
+        commits = get_author_commits(repo.path, since_ts, pattern)
+        all_commits.extend(commits)
+
+    if not all_commits:
+        return None
+
+    # De-duplicate by hash in case multiple patterns matched same commit
+    seen: set[str] = set()
+    unique: list[AuthorCommit] = []
+    for c in all_commits:
+        if c.short_hash not in seen:
+            seen.add(c.short_hash)
+            unique.append(c)
+
+    unique.sort(key=lambda c: c.ts, reverse=True)
+    return RepoDigest(repo=repo, commits=unique)
+
+
+def _resolve_author_patterns(
+    repos: list[RepoInfo],
+    explicit_patterns: list[str],
+) -> list[str]:
+    """If no explicit patterns given, try to read user.email from the first N repos."""
+    if explicit_patterns:
+        return explicit_patterns
+    emails: set[str] = set()
+    for repo in repos[:5]:
+        email = get_author_email(repo.path)
+        if email:
+            emails.add(email)
+    return list(emails) if emails else []
+
+
+def build_digest(
+    repos: list[RepoInfo],
+    since_ts: float,
+    author_patterns: list[str] | None = None,
+    max_workers: int = 8,
+) -> Digest:
+    """Build a Digest aggregating all matching commits across *repos*."""
+    patterns = _resolve_author_patterns(repos, author_patterns or [])
+    until_ts = time.time()
+
+    if not patterns:
+        return Digest(since_ts=since_ts, until_ts=until_ts, author_patterns=[])
+
+    args_list = [(repo, since_ts, patterns) for repo in repos]
+    results = run_parallel(_collect_for_repo, args_list, max_workers=max_workers)
+
+    by_repo = [
+        result
+        for _, result in results
+        if result is not None and not isinstance(result, Exception)
+    ]
+    by_repo.sort(key=lambda rd: len(rd.commits), reverse=True)
+
+    return Digest(
+        since_ts=since_ts,
+        until_ts=until_ts,
+        author_patterns=patterns,
+        by_repo=by_repo,
+    )
+
+
+def render_markdown(d: Digest) -> str:
+    """Render a Digest as a markdown standup summary."""
+    from datetime import datetime, timezone
+
+    lines: list[str] = []
+    since_str = datetime.fromtimestamp(d.since_ts, tz=timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
+    until_str = datetime.fromtimestamp(d.until_ts, tz=timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
+    authors_str = ", ".join(d.author_patterns) if d.author_patterns else "all authors"
+
+    lines.append(f"# Activity digest — {since_str} → {until_str}")
+    lines.append(f"**Author(s):** {authors_str}  ")
+    lines.append(
+        f"**Summary:** {d.total_commits} commit{'s' if d.total_commits != 1 else ''} "
+        f"across {d.repos_active} repo{'s' if d.repos_active != 1 else ''} "
+        f"· +{d.total_insertions} -{d.total_deletions} lines"
+    )
+    lines.append("")
+
+    for rd in d.by_repo:
+        lines.append(f"## {rd.repo.name} ({len(rd.commits)} commits · +{rd.insertions} -{rd.deletions})")
+        for c in rd.commits:
+            rel = relative_time(c.ts)
+            stats = f"+{c.insertions}/-{c.deletions}" if c.insertions or c.deletions else ""
+            stats_str = f" `{stats}`" if stats else ""
+            lines.append(f"- `{c.short_hash}` {c.message}{stats_str} _{rel}_")
+        lines.append("")
+
+    return "\n".join(lines)