loggit 1.0.0__tar.gz

loggit-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsk-dev-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

loggit-1.0.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: loggit
+Version: 1.0.0
+Summary: A friendly terminal git history explorer. Zero dependencies, works anywhere.
+Author: dsk-dev-ai
+License: MIT
+Project-URL: Homepage, https://github.com/dsk-dev-ai/loggit
+Project-URL: Repository, https://github.com/dsk-dev-ai/loggit
+Project-URL: Funding, https://github.com/sponsors/dsk-dev-ai
+Keywords: git,log,cli,terminal,git-history,developer-tools,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://img.shields.io/badge/dependencies-ZERO-22c55e?style=flat-square" alt="zero deps">
+  <img src="https://img.shields.io/badge/python-3.8+-4B8BBE?style=flat-square&logo=python&logoColor=white" alt="python">
+  <img src="https://img.shields.io/pypi/v/loggit?style=flat-square" alt="pypi version">
+  <a href="https://github.com/dsk-dev-ai/loggit/actions"><img src="https://img.shields.io/github/actions/workflow/status/dsk-dev-ai/loggit/ci.yml?style=flat-square" alt="CI"></a>
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT">
+  <a href="https://github.com/users/dsk-dev-ai/packages/container/package/loggit"><img src="https://img.shields.io/badge/docker-ghcr-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker GHCR"></a>
+</p>
+
+# loggit 🪵
+
+**Your git history, actually readable.** A friendly terminal explorer that turns `git log` into color, graphs, and answers — zero dependencies.
+
+Stop squinting at `git log --oneline`. `loggit` gives you a clear, colored view of **what your repository is really doing** — commits, authors, churn, and pace — in one command. Pure Python stdlib, works on any laptop, installs instantly.
+
+```
+▌ main
+  17 commits
+
+1000a50   Add Docker/GHCR badge + usage section to README
+    dsk-dev-ai  ·  6m ago
+    +14/-0 in 1 file(s)
+```
+
+---
+
+## ✨ Features
+
+| | |
+|---|---|
+| 🎨 **Pretty output** | colored, aligned, compact log view with refs, ages, and authors |
+| 👥 **Author stats** | per-developer commit counts and line churn as a bar chart |
+| 📈 **Pace metrics** | commits/day, authors, and added/removed lines over any window |
+| 🔎 **Powerful filters** | `--grep`, `--author`, `--since`, `--until`, `--branch` |
+| 📦 **Machine-readable** | `loggit json` for one-line-per-commit JSON |
+| 💸 **100% free** | zero dependencies, no AI, no server, no API keys |
+
+## 🔧 Install
+
+```bash
+pip install loggit
+```
+
+No dependencies. No compiled extensions. Works on Python 3.8+ everywhere.
+
+## 🐳 Docker
+
+```bash
+docker pull ghcr.io/dsk-dev-ai/loggit:latest
+docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/dsk-dev-ai/loggit:latest authors
+```
+
+## 🚀 Usage
+
+```bash
+loggit                        # pretty log of recent commits (default: 40)
+loggit -n 100                 # show more
+loggit --stat                 # add per-commit +added/-removed lines
+loggit --grep "docker"        # only commits mentioning "docker"
+loggit --author "ada"         # only commits by a specific developer
+loggit --since "2 weeks ago"  # recent activity only
+loggit authors                # per-developer commit & churn summary
+loggit pace                   # overall stats + velocity
+loggit json                   # JSON, one object per line (great for scripting)
+```
+
+See `loggit --help` for the full list of options.
+
+<details>
+<summary><b>JSON output (for piping into your tools)</b></summary>
+
+```bash
+loggit json -n 5 > commits.ndjson
+```
+
+```json
+{"hash": "1000a50", "author": "dsk-dev-ai", "date": "2026-08-31T02:14:39+05:30", "subject": "Add Docker/GHCR badge", "refs": "HEAD -> main"}
+```
+</details>
+
+## 🧠 How it works
+
+1. **Runs `git log`** with a stable, machine-friendly pretty-format.
+2. **Parses** commits, refs, dates, and message bodies (stdlib only).
+3. **Renders** a clean, terminal-aware view — colors auto-disable when piped.
+4. **Summarizes** per-author and per-window metrics on demand.
+
+## 🤝 Contributing
+
+Have an idea or spotted a quirk? Open an issue or a pull request. Want to add a metric or a new view? It's a focused module in `loggit/`.
+
+## 📄 License
+
+[MIT](LICENSE) — free to use, modify, and distribute.
+
+## ⭐ Support
+
+If `loggit` saved you a minute of `git log` squinting, **give it a star** ⭐.
+
+Want to help keep it free forever? Consider [becoming a sponsor](https://github.com/sponsors/dsk-dev-ai) on GitHub.

loggit-1.0.0/README.md

@@ -0,0 +1,100 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/dependencies-ZERO-22c55e?style=flat-square" alt="zero deps">
+  <img src="https://img.shields.io/badge/python-3.8+-4B8BBE?style=flat-square&logo=python&logoColor=white" alt="python">
+  <img src="https://img.shields.io/pypi/v/loggit?style=flat-square" alt="pypi version">
+  <a href="https://github.com/dsk-dev-ai/loggit/actions"><img src="https://img.shields.io/github/actions/workflow/status/dsk-dev-ai/loggit/ci.yml?style=flat-square" alt="CI"></a>
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT">
+  <a href="https://github.com/users/dsk-dev-ai/packages/container/package/loggit"><img src="https://img.shields.io/badge/docker-ghcr-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker GHCR"></a>
+</p>
+
+# loggit 🪵
+
+**Your git history, actually readable.** A friendly terminal explorer that turns `git log` into color, graphs, and answers — zero dependencies.
+
+Stop squinting at `git log --oneline`. `loggit` gives you a clear, colored view of **what your repository is really doing** — commits, authors, churn, and pace — in one command. Pure Python stdlib, works on any laptop, installs instantly.
+
+```
+▌ main
+  17 commits
+
+1000a50   Add Docker/GHCR badge + usage section to README
+    dsk-dev-ai  ·  6m ago
+    +14/-0 in 1 file(s)
+```
+
+---
+
+## ✨ Features
+
+| | |
+|---|---|
+| 🎨 **Pretty output** | colored, aligned, compact log view with refs, ages, and authors |
+| 👥 **Author stats** | per-developer commit counts and line churn as a bar chart |
+| 📈 **Pace metrics** | commits/day, authors, and added/removed lines over any window |
+| 🔎 **Powerful filters** | `--grep`, `--author`, `--since`, `--until`, `--branch` |
+| 📦 **Machine-readable** | `loggit json` for one-line-per-commit JSON |
+| 💸 **100% free** | zero dependencies, no AI, no server, no API keys |
+
+## 🔧 Install
+
+```bash
+pip install loggit
+```
+
+No dependencies. No compiled extensions. Works on Python 3.8+ everywhere.
+
+## 🐳 Docker
+
+```bash
+docker pull ghcr.io/dsk-dev-ai/loggit:latest
+docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/dsk-dev-ai/loggit:latest authors
+```
+
+## 🚀 Usage
+
+```bash
+loggit                        # pretty log of recent commits (default: 40)
+loggit -n 100                 # show more
+loggit --stat                 # add per-commit +added/-removed lines
+loggit --grep "docker"        # only commits mentioning "docker"
+loggit --author "ada"         # only commits by a specific developer
+loggit --since "2 weeks ago"  # recent activity only
+loggit authors                # per-developer commit & churn summary
+loggit pace                   # overall stats + velocity
+loggit json                   # JSON, one object per line (great for scripting)
+```
+
+See `loggit --help` for the full list of options.
+
+<details>
+<summary><b>JSON output (for piping into your tools)</b></summary>
+
+```bash
+loggit json -n 5 > commits.ndjson
+```
+
+```json
+{"hash": "1000a50", "author": "dsk-dev-ai", "date": "2026-08-31T02:14:39+05:30", "subject": "Add Docker/GHCR badge", "refs": "HEAD -> main"}
+```
+</details>
+
+## 🧠 How it works
+
+1. **Runs `git log`** with a stable, machine-friendly pretty-format.
+2. **Parses** commits, refs, dates, and message bodies (stdlib only).
+3. **Renders** a clean, terminal-aware view — colors auto-disable when piped.
+4. **Summarizes** per-author and per-window metrics on demand.
+
+## 🤝 Contributing
+
+Have an idea or spotted a quirk? Open an issue or a pull request. Want to add a metric or a new view? It's a focused module in `loggit/`.
+
+## 📄 License
+
+[MIT](LICENSE) — free to use, modify, and distribute.
+
+## ⭐ Support
+
+If `loggit` saved you a minute of `git log` squinting, **give it a star** ⭐.
+
+Want to help keep it free forever? Consider [becoming a sponsor](https://github.com/sponsors/dsk-dev-ai) on GitHub.

loggit-1.0.0/loggit/__init__.py

@@ -0,0 +1,7 @@
+"""loggit - a friendly, zero-dependency terminal git history explorer.
+
+Turn `git log` into a readable, colored, interactive report of what your
+repository is really doing: commits, authors, branches, churn, and pace.
+"""
+
+__version__ = "1.0.0"

loggit-1.0.0/loggit/__main__.py

@@ -0,0 +1,5 @@
+"""Run `python -m loggit`."""
+from loggit.cli import main
+
+if __name__ == "__main__":
+    main()

loggit-1.0.0/loggit/cli.py

@@ -0,0 +1,160 @@
+"""loggit CLI - a friendly terminal git history explorer (zero dependencies)."""
+import argparse
+import sys
+from datetime import datetime
+
+from loggit import __version__
+from loggit.gitcore import (
+    GitError,
+    current_branch,
+    git_log,
+    is_repo,
+)
+from loggit.render import (
+    RESET,
+    BOLD,
+    DIM,
+    CYAN,
+    GREEN,
+    RED,
+    YELLOW,
+    authors_summary,
+    pace_summary,
+    render_authors,
+    render_commit,
+)
+
+
+def build_parser():
+    p = argparse.ArgumentParser(
+        prog="loggit",
+        description="Friendly terminal git history explorer. Zero dependencies.",
+    )
+    p.add_argument("-n", "--max-count", type=int, default=40, help="commits to show (default: 40)")
+    p.add_argument("--grep", help="only commits whose message matches")
+    p.add_argument("--author", help="only commits by this author (name or email)")
+    p.add_argument("--since", help="only commits since this date/ref")
+    p.add_argument("--until", help="only commits until this date/ref")
+    p.add_argument("--stat", action="store_true", help="show added/removed lines per commit")
+    p.add_argument("--no-color", action="store_true", help="disable ANSI colors")
+    p.add_argument("--branch", help="limit to a specific branch (default: all)")
+    p.add_argument("--version", action="version", version=f"loggit {__version__}")
+    sub = p.add_subparsers(dest="command")
+
+    authors_p = sub.add_parser("authors", help="per-author commit/churn summary")
+    authors_p.add_argument("-n", "--max-count", type=int, default=40, help="commits to consider")
+    authors_p.add_argument("--branch", help="limit to a specific branch")
+    authors_p.add_argument("--no-color", action="store_true", help="disable ANSI colors")
+
+    pace_p = sub.add_parser("pace", help="overall stats for the captured window")
+    pace_p.add_argument("-n", "--max-count", type=int, default=40, help="commits to consider")
+    pace_p.add_argument("--branch", help="limit to a specific branch")
+    pace_p.add_argument("--no-color", action="store_true", help="disable ANSI colors")
+
+    json_p = sub.add_parser("json", help="machine-readable log (objects, one per line)")
+    json_p.add_argument("-n", "--max-count", type=int, default=40, help="commits to emit")
+    json_p.add_argument("--branch", help="limit to a specific branch")
+    json_p.add_argument("--grep", help="only commits whose message matches")
+    json_p.add_argument("--author", help="only commits by this author")
+    json_p.add_argument("--since", help="only commits since this date/ref")
+    json_p.add_argument("--until", help="only commits until this date/ref")
+    json_p.add_argument("--no-color", action="store_true", help="disable ANSI colors")
+
+    return p
+
+
+def _disable_color():
+    sys.stdout.isatty = lambda: False
+
+
+def cmd_log(args):
+    commits = git_log(
+        cwd=".",
+        max_count=args.max_count,
+        grep=args.grep,
+        author=args.author,
+        since=args.since,
+        until=args.until,
+        stat=args.stat,
+        branches=args.branch,
+    )
+    branch = current_branch(".")
+    title = f" {branch or 'repository'} "
+    print(f"\n{BOLD}{CYAN}▌{title}{RESET}")
+    print(f"{DIM}  {len(commits)} commits{RESET}")
+    for c in commits:
+        print()
+        print(render_commit(c))
+
+
+def cmd_authors(args):
+    commits = git_log(cwd=".", max_count=args.max_count, branches=args.branch, stat=True)
+    rows = authors_summary(commits)
+    print(f"\n{BOLD}{CYAN}▌ Authors{RESET}")
+    print(render_authors(rows))
+
+
+def cmd_pace(args):
+    commits = git_log(cwd=".", max_count=args.max_count, branches=args.branch, stat=True)
+    p = pace_summary(commits)
+    print(f"\n{BOLD}{CYAN}▌ Pace / stats{RESET}")
+    print(f"  commits          {p['commits']}")
+    print(f"  authors          {p['authors']}")
+    print(f"  window           {p['span_days']:.1f} days")
+    print(f"  avg/day          {p['avg_per_day']:.2f}")
+    print(f"  lines added      {GREEN}+{p['added']}{RESET}")
+    print(f"  lines removed    {RED}-{p['removed']}{RESET}")
+
+
+def cmd_json(args):
+    import json as _json
+
+    commits = git_log(
+        cwd=".",
+        max_count=args.max_count,
+        grep=args.grep,
+        author=args.author,
+        since=args.since,
+        until=args.until,
+        stat=False,
+        branches=args.branch,
+    )
+    for c in commits:
+        out = {
+            "hash": c["hash"],
+            "short": c["short"],
+            "author": c["author"],
+            "email": c["email"],
+            "date": c["age"],
+            "subject": c["subject"],
+            "refs": c["refs"].strip(),
+        }
+        print(_json.dumps(out))
+
+
+def main(argv=None):
+    args = build_parser().parse_args(argv)
+    if args.no_color:
+        _disable_color()
+
+    if not is_repo("."):
+        print(f"{RED}✗ not inside a git repository{RESET}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        if args.command == "authors":
+            cmd_authors(args)
+        elif args.command == "pace":
+            cmd_pace(args)
+        elif args.command == "json":
+            cmd_json(args)
+        else:
+            cmd_log(args)
+    except GitError as exc:
+        print(f"{RED}✗ {exc}{RESET}", file=sys.stderr)
+        sys.exit(1)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

loggit-1.0.0/loggit/gitcore.py

@@ -0,0 +1,180 @@
+"""Low-level git interaction and log parsing (stdlib only, no deps)."""
+import datetime as _dt
+import subprocess
+import sys
+
+
+class GitError(RuntimeError):
+    pass
+
+
+def run_git(args, cwd=None):
+    """Run a git command and return its stdout, raising on failure."""
+    try:
+        proc = subprocess.run(
+            ["git", *args],
+            cwd=cwd,
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+    except FileNotFoundError as exc:
+        raise GitError("git is not installed or not on PATH") from exc
+    if proc.returncode != 0:
+        raise GitError((proc.stderr or "git command failed").strip())
+    return proc.stdout
+
+
+def is_repo(cwd=None):
+    try:
+        run_git(["-C", (cwd or "."), "rev-parse", "--is-inside-work-tree"], cwd=cwd)
+        return True
+    except GitError:
+        return False
+
+
+def _parse_ts(iso):
+    try:
+        return _dt.datetime.fromisoformat(iso.replace("Z", "+00:00"))
+    except ValueError:
+        return _dt.datetime.now()
+
+
+def human_age(dt, now=None):
+    """Return a compact relative age like '3h ago' from a datetime."""
+    now = now or _dt.datetime.now(dt.tzinfo) if dt.tzinfo else (_dt.datetime.now())
+    delta = now - dt
+    if dt.tzinfo is None:
+        # naive datetimes: compare against naive now
+        delta = _dt.datetime.now() - dt
+    secs = int(delta.total_seconds())
+    if secs < 0:
+        secs = 0
+    if secs < 90:
+        return f"{secs}s ago"
+    mins = secs // 60
+    if mins < 60:
+        return f"{mins}m ago"
+    hours = mins // 60
+    if hours < 48:
+        return f"{hours}h ago"
+    days = hours // 24
+    if days < 30:
+        return f"{days}d ago"
+    months = days // 30
+    if months < 12:
+        return f"{months}mo ago"
+    years = months // 12
+    return f"{years}y ago"
+
+
+def git_log(cwd=None, max_count=40, grep=None, author=None, since=None, until=None, stat=False, branches=None):
+    """Fetch a parseable git log stream with a stable, machine-friendly format.
+
+    Returns a list of dicts describing each commit.
+    """
+    sep = "\x1e"  # record separator unlikely to appear in messages
+    fieldsep = "\x1f"
+    args = ["-C", (cwd or "."), "log"]
+    if max_count:
+        args += ["--max-count", str(max_count)]
+    if grep:
+        args += ["--grep", grep, "--regexp-ignore-case"]
+    if author:
+        args += ["--author", author]
+    if since:
+        args += ["--since", since]
+    if until:
+        args += ["--until", until]
+    if branches:
+        args += [branches]
+    else:
+        args += ["--all"]
+
+    fmt = "%H%x1f%h%x1f%an%x1f%ae%x1f%aI%x1f%s%x1f%D%x1f%n%b"
+    # Use git's own %x1e hex escape so commits are separated by the real byte.
+    args += [
+        f"--pretty=format:{fmt}%x1e",
+    ]
+    out = run_git(args, cwd=None)
+    commits = []
+    for record in out.split(sep):
+        record = record.strip("\n")
+        if not record:
+            continue
+        lines = record.split("\n")
+        header = lines[0]
+        parts = header.split(fieldsep)
+        if len(parts) < 7:
+            continue
+        full, short, name, email, iso, subject, refs = parts[:7]
+        body = "\n".join(lines[1:]).strip() if len(lines) > 1 else ""
+        commits.append(
+            {
+                "hash": full,
+                "short": short,
+                "author": name,
+                "email": email,
+                "date": _parse_ts(iso),
+                "age": iso,
+                "subject": subject,
+                "refs": refs,
+                "body": body,
+                "added": 0,
+                "removed": 0,
+            }
+        )
+        commits[-1]["age_human"] = human_age(commits[-1]["date"])
+
+    if stat:
+        stats = git_stats(cwd=cwd, max_count=max_count, branches=branches)
+        for c in commits:
+            s = stats.get(c["hash"])
+            if s:
+                c.update(s)
+    return commits
+
+
+def git_stats(cwd=None, max_count=None, branches=None):
+    """Fetch per-commit added/removed/file counts keyed by full hash.
+
+    Uses a separate --numstat stream (clean to parse, unlike --stat output).
+    """
+    args = [
+        "-C",
+        (cwd or "."),
+        "log",
+        "--numstat",
+        "--no-renames",
+        "--pretty=format:%x1e%H",
+    ]
+    if max_count:
+        args += ["--max-count", str(max_count)]
+    if branches:
+        args += [branches]
+    else:
+        args += ["--all"]
+    out = run_git(args, cwd=None)
+    stats = {}
+    for rec in out.split("\x1e"):
+        rec = rec.strip("\n")
+        if not rec:
+            continue
+        lines = rec.split("\n")
+        h = lines[0]
+        added = removed = files = 0
+        for ln in lines[1:]:
+            parts = ln.split("\t")
+            if len(parts) >= 3 and parts[0].isdigit() and parts[1].isdigit():
+                added += int(parts[0])
+                removed += int(parts[1])
+                files += 1
+        stats[h] = {"added": added, "removed": removed, "changed_files": files}
+    return stats
+
+
+def current_branch(cwd=None):
+    try:
+        return run_git(["-C", (cwd or "."), "branch", "--show-current"], cwd=None).strip()
+    except GitError:
+        return None

loggit-1.0.0/loggit/render.py

@@ -0,0 +1,88 @@
+"""Terminal rendering and summary statistics (stdlib only)."""
+import sys
+
+
+# ANSI helpers - no deps, degrade gracefully when not a TTY.
+def _c(code):
+    if not sys.stdout.isatty():
+        return ""
+    return f"\x1b[{code}m"
+
+
+RESET = _c("0")
+BOLD = _c("1")
+DIM = _c("2")
+RED = _c("31")
+GREEN = _c("32")
+YELLOW = _c("33")
+BLUE = _c("34")
+MAGENTA = _c("35")
+CYAN = _c("36")
+
+
+def render_commit(c):
+    """Render a single commit as a compact colored block."""
+    lines = []
+    head = f"{BOLD}{YELLOW}{c['short']}{RESET}"
+    refs = f" {CYAN}{c['refs'].strip()}{RESET}" if c.get("refs", "").strip() else ""
+    author = f"{MAGENTA}{c['author']}{RESET}"
+    age = f"{DIM}{c['age_human']}{RESET}"
+    lines.append(f"{head}{refs}  {c['subject']}")
+    lines.append(f"    {author}  ·  {age}")
+    if c.get("body"):
+        for line in c["body"].split("\n"):
+            lines.append(f"    {DIM}{line}{RESET}")
+    if c.get("changed_files"):
+        lines.append(
+            f"    {GREEN}+{c['added']}{RESET}/{RED}-{c['removed']}{RESET} in "
+            f"{c['changed_files']} file(s)"
+        )
+    return "\n".join(lines)
+
+
+def authors_summary(commits):
+    """Summarize commit counts per author: [(name, count, added, removed), ...]."""
+    agg = {}
+    for c in commits:
+        a = agg.setdefault(
+            c["author"],
+            {"name": c["author"], "count": 0, "added": 0, "removed": 0},
+        )
+        a["count"] += 1
+        a["added"] += c.get("added", 0)
+        a["removed"] += c.get("removed", 0)
+    return sorted(agg.values(), key=lambda a: (-a["count"], -a["added"]))
+
+
+def render_authors(author_rows, width=None):
+    width = width or 24
+    lines = []
+    for a in author_rows:
+        name = f"{BOLD}{a['name']}{RESET}"
+        bar = "█" * min(a["count"], 40)
+        lines.append(
+            f"  {name:<{width}} {a['count']:>4} commits  "
+            f"{GREEN}+{a['added']}{RESET}/{RED}-{a['removed']}{RESET}  {bar}"
+        )
+    return "\n".join(lines)
+
+
+def pace_summary(commits):
+    """Return a dict with overall stats for the captured window."""
+    if not commits:
+        return {"commits": 0}
+    dates = [c["date"] for c in commits]
+    try:
+        span_days = max((max(dates) - min(dates)).total_seconds() / 86400.0, 0.0001)
+    except Exception:
+        span_days = 0.0001
+    total_added = sum(c.get("added", 0) for c in commits)
+    total_removed = sum(c.get("removed", 0) for c in commits)
+    return {
+        "commits": len(commits),
+        "authors": len({c["author"] for c in commits}),
+        "span_days": span_days,
+        "avg_per_day": len(commits) / span_days,
+        "added": total_added,
+        "removed": total_removed,
+    }

loggit-1.0.0/loggit.egg-info/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: loggit
+Version: 1.0.0
+Summary: A friendly terminal git history explorer. Zero dependencies, works anywhere.
+Author: dsk-dev-ai
+License: MIT
+Project-URL: Homepage, https://github.com/dsk-dev-ai/loggit
+Project-URL: Repository, https://github.com/dsk-dev-ai/loggit
+Project-URL: Funding, https://github.com/sponsors/dsk-dev-ai
+Keywords: git,log,cli,terminal,git-history,developer-tools,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://img.shields.io/badge/dependencies-ZERO-22c55e?style=flat-square" alt="zero deps">
+  <img src="https://img.shields.io/badge/python-3.8+-4B8BBE?style=flat-square&logo=python&logoColor=white" alt="python">
+  <img src="https://img.shields.io/pypi/v/loggit?style=flat-square" alt="pypi version">
+  <a href="https://github.com/dsk-dev-ai/loggit/actions"><img src="https://img.shields.io/github/actions/workflow/status/dsk-dev-ai/loggit/ci.yml?style=flat-square" alt="CI"></a>
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT">
+  <a href="https://github.com/users/dsk-dev-ai/packages/container/package/loggit"><img src="https://img.shields.io/badge/docker-ghcr-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker GHCR"></a>
+</p>
+
+# loggit 🪵
+
+**Your git history, actually readable.** A friendly terminal explorer that turns `git log` into color, graphs, and answers — zero dependencies.
+
+Stop squinting at `git log --oneline`. `loggit` gives you a clear, colored view of **what your repository is really doing** — commits, authors, churn, and pace — in one command. Pure Python stdlib, works on any laptop, installs instantly.
+
+```
+▌ main
+  17 commits
+
+1000a50   Add Docker/GHCR badge + usage section to README
+    dsk-dev-ai  ·  6m ago
+    +14/-0 in 1 file(s)
+```
+
+---
+
+## ✨ Features
+
+| | |
+|---|---|
+| 🎨 **Pretty output** | colored, aligned, compact log view with refs, ages, and authors |
+| 👥 **Author stats** | per-developer commit counts and line churn as a bar chart |
+| 📈 **Pace metrics** | commits/day, authors, and added/removed lines over any window |
+| 🔎 **Powerful filters** | `--grep`, `--author`, `--since`, `--until`, `--branch` |
+| 📦 **Machine-readable** | `loggit json` for one-line-per-commit JSON |
+| 💸 **100% free** | zero dependencies, no AI, no server, no API keys |
+
+## 🔧 Install
+
+```bash
+pip install loggit
+```
+
+No dependencies. No compiled extensions. Works on Python 3.8+ everywhere.
+
+## 🐳 Docker
+
+```bash
+docker pull ghcr.io/dsk-dev-ai/loggit:latest
+docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/dsk-dev-ai/loggit:latest authors
+```
+
+## 🚀 Usage
+
+```bash
+loggit                        # pretty log of recent commits (default: 40)
+loggit -n 100                 # show more
+loggit --stat                 # add per-commit +added/-removed lines
+loggit --grep "docker"        # only commits mentioning "docker"
+loggit --author "ada"         # only commits by a specific developer
+loggit --since "2 weeks ago"  # recent activity only
+loggit authors                # per-developer commit & churn summary
+loggit pace                   # overall stats + velocity
+loggit json                   # JSON, one object per line (great for scripting)
+```
+
+See `loggit --help` for the full list of options.
+
+<details>
+<summary><b>JSON output (for piping into your tools)</b></summary>
+
+```bash
+loggit json -n 5 > commits.ndjson
+```
+
+```json
+{"hash": "1000a50", "author": "dsk-dev-ai", "date": "2026-08-31T02:14:39+05:30", "subject": "Add Docker/GHCR badge", "refs": "HEAD -> main"}
+```
+</details>
+
+## 🧠 How it works
+
+1. **Runs `git log`** with a stable, machine-friendly pretty-format.
+2. **Parses** commits, refs, dates, and message bodies (stdlib only).
+3. **Renders** a clean, terminal-aware view — colors auto-disable when piped.
+4. **Summarizes** per-author and per-window metrics on demand.
+
+## 🤝 Contributing
+
+Have an idea or spotted a quirk? Open an issue or a pull request. Want to add a metric or a new view? It's a focused module in `loggit/`.
+
+## 📄 License
+
+[MIT](LICENSE) — free to use, modify, and distribute.
+
+## ⭐ Support
+
+If `loggit` saved you a minute of `git log` squinting, **give it a star** ⭐.
+
+Want to help keep it free forever? Consider [becoming a sponsor](https://github.com/sponsors/dsk-dev-ai) on GitHub.

loggit-1.0.0/loggit.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+loggit/__init__.py
+loggit/__main__.py
+loggit/cli.py
+loggit/gitcore.py
+loggit/render.py
+loggit.egg-info/PKG-INFO
+loggit.egg-info/SOURCES.txt
+loggit.egg-info/dependency_links.txt
+loggit.egg-info/entry_points.txt
+loggit.egg-info/top_level.txt
+tests/test_loggit.py

loggit-1.0.0/loggit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

loggit-1.0.0/loggit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+loggit = loggit.cli:main

loggit-1.0.0/loggit.egg-info/top_level.txt

@@ -0,0 +1 @@
+loggit

loggit-1.0.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "loggit"
+version = "1.0.0"
+description = "A friendly terminal git history explorer. Zero dependencies, works anywhere."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "dsk-dev-ai" }]
+keywords = ["git", "log", "cli", "terminal", "git-history", "developer-tools", "productivity"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: Utilities",
+]
+[project.urls]
+Homepage = "https://github.com/dsk-dev-ai/loggit"
+Repository = "https://github.com/dsk-dev-ai/loggit"
+Funding = "https://github.com/sponsors/dsk-dev-ai"
+
+[project.scripts]
+loggit = "loggit.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["loggit*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

loggit-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

loggit-1.0.0/tests/test_loggit.py

@@ -0,0 +1,100 @@
+"""Tests for loggit (zero-dependency, uses a scratch git repo)."""
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+
+import pytest
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from loggit.gitcore import GitError, git_log, human_age, is_repo, run_git  # noqa: E402
+from loggit.render import authors_summary, pace_summary  # noqa: E402
+
+
+def _git(repo, *args):
+    subprocess.run(["git", "-C", repo, *args], check=True, capture_output=True)
+
+
+@pytest.fixture
+def repo():
+    tmp = tempfile.mkdtemp()
+    _git(tmp, "init", "-q")
+    _git(tmp, "config", "user.email", "dev@example.com")
+    _git(tmp, "config", "user.name", "Dev Tester")
+    return tmp
+
+
+def _commit(repo, msg, file="a.txt", content="x\n"):
+    path = os.path.join(repo, file)
+    with open(path, "a") as fh:
+        fh.write(content)
+    _git(repo, "add", ".")
+    _git(repo, "commit", "-q", "-m", msg)
+
+
+def test_is_repo(repo):
+    assert is_repo(repo) is True
+    temp = tempfile.mkdtemp()
+    assert is_repo(temp) is False
+
+
+def test_git_log_parses(repo):
+    _commit(repo, "first commit")
+    _commit(repo, "second commit")
+    commits = git_log(cwd=repo, max_count=10)
+    assert len(commits) == 2
+    assert commits[0]["subject"] == "second commit"
+    assert commits[0]["author"] == "Dev Tester"
+    assert commits[1]["subject"] == "first commit"
+    for c in commits:
+        assert c["hash"]
+        assert c["short"]
+        assert c["age_human"]
+
+
+def test_git_log_grep_filter(repo):
+    _commit(repo, "adds awesome feature")
+    _commit(repo, "fixes typo")
+    commits = git_log(cwd=repo, max_count=10, grep="awesome")
+    assert len(commits) == 1
+    assert commits[0]["subject"] == "adds awesome feature"
+
+
+def test_git_log_author_filter(repo):
+    _commit(repo, "alpha")
+    commits = git_log(cwd=repo, max_count=10, author="Tester")
+    assert len(commits) == 1
+    commits = git_log(cwd=repo, max_count=10, author="Nobody")
+    assert len(commits) == 0
+
+
+def test_authors_summary(repo):
+    _commit(repo, "one")
+    _commit(repo, "two")
+    _commit(repo, "three")
+    rows = authors_summary(git_log(cwd=repo, max_count=10, stat=True))
+    assert len(rows) == 1
+    assert rows[0]["count"] == 3
+    assert rows[0]["added"] >= 3
+
+
+def test_pace_summary(repo):
+    _commit(repo, "one")
+    _commit(repo, "two")
+    p = pace_summary(git_log(cwd=repo, max_count=10, stat=True))
+    assert p["commits"] == 2
+    assert p["authors"] == 1
+    assert p["avg_per_day"] > 0
+
+
+def test_human_age():
+    import datetime
+
+    assert "ago" in human_age(datetime.datetime.now() - datetime.timedelta(hours=3))
+
+
+def test_git_error_when_no_git():
+    with pytest.raises(GitError):
+        run_git(["--definitely-not-a-command"])