git-tunnel 0.1.0__tar.gz

git_tunnel-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Younes Hamishebahar
+
+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.

git_tunnel-0.1.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: git-tunnel
+Version: 0.1.0
+Summary: Visualize git history as per-machine tunnels in your terminal
+License: MIT
+License-File: LICENSE
+Keywords: developer-tools,git,multi-machine,terminal,visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# git-tunnel
+
+Visualize your git history as **per-machine tunnels** in the terminal.
+
+If you work across multiple machines — a MacBook, a Workstation, a Server — git
+log treats them all the same. `git-tunnel` splits each machine into its own
+colored column so you can see at a glance *where* every commit was made.
+
+```
+────────────────────────────────────────────────────────────────────────────────
+  TIME              │ pre git-tunnel                       │ MacBook                              │ Workstation                          │ HASH
+────────────────────────────────────────────────────────────────────────────────
+  2 hours ago       │ · · · · · · · · · · · · · ·          │ WIP: invoice route                   │ · · · · · · · · · · · · · ·          │ 2c4930f
+  3 hours ago       │ · · · · · · · · · · · · · ·          │ · · · · · · · · · · · · · ·          │ finished validation                  │ 6f46c9f
+  1 day ago         │ added model                          │ · · · · · · · · · · · · · ·          │ · · · · · · · · · · · · · ·          │ fd7bcad
+  1 day ago         │ initial setup                        │ · · · · · · · · · · · · · ·          │ · · · · · · · · · · · · · ·          │ f3bc95b
+────────────────────────────────────────────────────────────────────────────────
+
+  ■ pre git-tunnel   ■ MacBook   ■ Workstation
+```
+
+Commits made before `git-tunnel` was installed appear in a plain white
+`pre git-tunnel` column — no history rewriting, no warnings.
+
+---
+
+## Install
+
+```bash
+pip install git-tunnel
+```
+
+Or with `uv`:
+```bash
+uv tool install git-tunnel
+```
+
+---
+
+## Setup (once per machine)
+
+Run the interactive setup:
+```bash
+git-tunnel install
+```
+
+This will:
+- Ask for a device name (e.g. `MacBook`, `Workstation`, `Server`)
+- Set `git config --global user.device`
+- Install the `prepare-commit-msg` hook globally
+- Point `git config --global core.hooksPath` at the hook
+
+From this point on, every commit you make will automatically get a
+`[device:YourDevice]` tag appended to the message — silently, without
+you doing anything.
+
+---
+
+## Usage
+
+Inside any git repo:
+```bash
+git-tunnel
+```
+
+---
+
+## How it works
+
+`git-tunnel` uses a global `prepare-commit-msg` hook that appends a
+`[device:X]` tag to every commit message, where `X` comes from
+`git config --global user.device`.
+
+Your `user.name` is never touched — it stays clean for collaboration.
+The device tag lives in the commit message body and is stripped from
+the display in the tunnel view.
+
+---
+
+## Multiple machines
+
+Set a different device name on each machine:
+```bash
+# MacBook
+git-tunnel install  # enter "MacBook" when prompted
+
+# Workstation
+git-tunnel install  # enter "Workstation" when prompted
+
+# Server
+git-tunnel install  # enter "Server" when prompted
+```
+
+Since the hook is global, it applies to every repo on that machine
+automatically.
+
+---
+
+## Zero dependencies
+
+`git-tunnel` uses only the Python standard library and git itself.
+No third-party packages required.
+
+---
+
+## License
+
+MIT

git_tunnel-0.1.0/README.md

@@ -0,0 +1,108 @@
+# git-tunnel
+
+Visualize your git history as **per-machine tunnels** in the terminal.
+
+If you work across multiple machines — a MacBook, a Workstation, a Server — git
+log treats them all the same. `git-tunnel` splits each machine into its own
+colored column so you can see at a glance *where* every commit was made.
+
+```
+────────────────────────────────────────────────────────────────────────────────
+  TIME              │ pre git-tunnel                       │ MacBook                              │ Workstation                          │ HASH
+────────────────────────────────────────────────────────────────────────────────
+  2 hours ago       │ · · · · · · · · · · · · · ·          │ WIP: invoice route                   │ · · · · · · · · · · · · · ·          │ 2c4930f
+  3 hours ago       │ · · · · · · · · · · · · · ·          │ · · · · · · · · · · · · · ·          │ finished validation                  │ 6f46c9f
+  1 day ago         │ added model                          │ · · · · · · · · · · · · · ·          │ · · · · · · · · · · · · · ·          │ fd7bcad
+  1 day ago         │ initial setup                        │ · · · · · · · · · · · · · ·          │ · · · · · · · · · · · · · ·          │ f3bc95b
+────────────────────────────────────────────────────────────────────────────────
+
+  ■ pre git-tunnel   ■ MacBook   ■ Workstation
+```
+
+Commits made before `git-tunnel` was installed appear in a plain white
+`pre git-tunnel` column — no history rewriting, no warnings.
+
+---
+
+## Install
+
+```bash
+pip install git-tunnel
+```
+
+Or with `uv`:
+```bash
+uv tool install git-tunnel
+```
+
+---
+
+## Setup (once per machine)
+
+Run the interactive setup:
+```bash
+git-tunnel install
+```
+
+This will:
+- Ask for a device name (e.g. `MacBook`, `Workstation`, `Server`)
+- Set `git config --global user.device`
+- Install the `prepare-commit-msg` hook globally
+- Point `git config --global core.hooksPath` at the hook
+
+From this point on, every commit you make will automatically get a
+`[device:YourDevice]` tag appended to the message — silently, without
+you doing anything.
+
+---
+
+## Usage
+
+Inside any git repo:
+```bash
+git-tunnel
+```
+
+---
+
+## How it works
+
+`git-tunnel` uses a global `prepare-commit-msg` hook that appends a
+`[device:X]` tag to every commit message, where `X` comes from
+`git config --global user.device`.
+
+Your `user.name` is never touched — it stays clean for collaboration.
+The device tag lives in the commit message body and is stripped from
+the display in the tunnel view.
+
+---
+
+## Multiple machines
+
+Set a different device name on each machine:
+```bash
+# MacBook
+git-tunnel install  # enter "MacBook" when prompted
+
+# Workstation
+git-tunnel install  # enter "Workstation" when prompted
+
+# Server
+git-tunnel install  # enter "Server" when prompted
+```
+
+Since the hook is global, it applies to every repo on that machine
+automatically.
+
+---
+
+## Zero dependencies
+
+`git-tunnel` uses only the Python standard library and git itself.
+No third-party packages required.
+
+---
+
+## License
+
+MIT

git_tunnel-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "git-tunnel"
+version = "0.1.0"
+description = "Visualize git history as per-machine tunnels in your terminal"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+keywords = ["git", "developer-tools", "terminal", "visualization", "multi-machine"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+
+[project.scripts]
+git-tunnel     = "git_tunnel.cli:main"
+git-tunnel-run = "git_tunnel.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/git_tunnel"]
+
+[tool.hatch.build]
+include = [
+    "src/git_tunnel/**",
+]

git_tunnel-0.1.0/src/git_tunnel/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

git_tunnel-0.1.0/src/git_tunnel/cli.py

@@ -0,0 +1,75 @@
+import sys
+import subprocess
+import shutil
+from pathlib import Path
+
+
+def install():
+    """
+    Interactive setup:
+      - Sets git config --global user.device
+      - Installs the prepare-commit-msg hook
+      - Sets git config --global core.hooksPath
+      - Adds the shell function hint
+    """
+    RESET  = '\033[0m'
+    BOLD   = '\033[1m'
+    CYAN   = '\033[96m'
+    GREEN  = '\033[92m'
+    YELLOW = '\033[93m'
+
+    def ok(t):   print(f"  \033[92m✓\033[0m {t}")
+    def info(t): print(f"  \033[96m→\033[0m {t}")
+    def warn(t): print(f"  \033[93m⚠\033[0m  {t}")
+
+    print(f"\n{BOLD}git-tunnel setup{RESET}\n")
+
+    # ── Device name ───────────────────────────────────────────────────────────
+    current = subprocess.run(
+        ['git', 'config', '--global', 'user.device'],
+        capture_output=True, text=True
+    ).stdout.strip()
+
+    if current:
+        info(f"user.device already set to '{CYAN}{current}{RESET}'")
+        answer = input("  Change it? [y/N] ").strip().lower()
+        if answer != 'y':
+            device = current
+        else:
+            device = input("  Enter device name (e.g. MacBook, Workstation, Server): ").strip()
+    else:
+        device = input("  Enter device name for this machine (e.g. MacBook, Workstation, Server): ").strip()
+
+    if not device:
+        warn("No device name entered — skipping.")
+    else:
+        subprocess.run(['git', 'config', '--global', 'user.device', device])
+        ok(f"user.device set to '{device}'")
+
+    # ── Hook installation ─────────────────────────────────────────────────────
+    hooks_dir = Path.home() / '.git-tunnel-hooks'
+    hooks_dir.mkdir(exist_ok=True)
+
+    # Find the hook bundled with the package
+    pkg_hook = Path(__file__).parent / 'hooks' / 'prepare-commit-msg'
+    dest     = hooks_dir / 'prepare-commit-msg'
+    shutil.copy(pkg_hook, dest)
+    dest.chmod(0o755)
+    ok(f"Hook installed → {dest}")
+
+    # Point git at the hooks dir
+    subprocess.run(['git', 'config', '--global', 'core.hooksPath', str(hooks_dir)])
+    ok(f"core.hooksPath set to {hooks_dir}")
+
+    # ── Shell function hint ───────────────────────────────────────────────────
+    print(f"\n{BOLD}Almost done!{RESET} Add this to your shell config (~/.zshrc or ~/.bashrc):\n")
+    print(f"  {CYAN}function git-tunnel() {{ git-tunnel-run; }}{RESET}\n")
+    print(f"Or just run:  {BOLD}git-tunnel-run{RESET}  directly.\n")
+
+
+def main():
+    if len(sys.argv) > 1 and sys.argv[1] == 'install':
+        install()
+    else:
+        from git_tunnel.tunnel import main as run
+        run()

git_tunnel-0.1.0/src/git_tunnel/hooks/prepare-commit-msg

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# prepare-commit-msg hook — part of git-tunnel
+# Appends [device:X] tag to every commit using git config user.device
+
+COMMIT_MSG_FILE="$1"
+COMMIT_SOURCE="$2"
+
+# Skip merge, squash, amend
+if [ "$COMMIT_SOURCE" = "merge" ] || \
+   [ "$COMMIT_SOURCE" = "squash" ] || \
+   [ "$COMMIT_SOURCE" = "commit" ]; then
+    exit 0
+fi
+
+DEVICE=$(git config --global user.device)
+
+if [ -z "$DEVICE" ]; then
+    echo "⚠  git-tunnel: user.device not set. Run: git-tunnel install"
+    exit 0
+fi
+
+# Don't double-tag
+if grep -qE "\[device:" "$COMMIT_MSG_FILE"; then
+    exit 0
+fi
+
+echo "" >> "$COMMIT_MSG_FILE"
+echo "[device:$DEVICE]" >> "$COMMIT_MSG_FILE"

git_tunnel-0.1.0/src/git_tunnel/tunnel.py

@@ -0,0 +1,159 @@
+import subprocess
+import sys
+import re
+
+# ── ANSI styling ─────────────────────────────────────────────────────────────
+RESET  = '\033[0m'
+BOLD   = '\033[1m'
+DIM    = '\033[2m'
+
+DEVICE_COLORS = [
+    '\033[96m',   # Cyan
+    '\033[93m',   # Yellow
+    '\033[92m',   # Green
+    '\033[95m',   # Magenta
+    '\033[91m',   # Red
+    '\033[94m',   # Blue
+]
+
+HASH_COLOR   = '\033[90m'
+TIME_COLOR   = '\033[37m'
+BORDER_COLOR = '\033[90m'
+HEADER_COLOR = '\033[1;37m'
+LEGACY_COLOR = '\033[37m'
+
+# ── Layout ────────────────────────────────────────────────────────────────────
+TIME_WIDTH   = 17
+MSG_WIDTH    = 36
+HASH_WIDTH   = 9
+
+DEVICE_TAG   = re.compile(r'\[device:(.+?)\]', re.IGNORECASE)
+LEGACY_LABEL = 'pre git-tunnel'
+
+
+def run_git_log():
+    result = subprocess.run(
+        ['git', 'log', '--pretty=format:%h|%an|%ar|%B|||END|||',
+         '--exclude=refs/original/*', '--all'],
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        print(f"\n  ✗  Not a git repository (or git not found).\n")
+        sys.exit(1)
+    return result.stdout
+
+
+def parse_commits(raw):
+    entries = raw.split('|||END|||')
+    commits = []
+    for entry in entries:
+        entry = entry.strip()
+        if not entry:
+            continue
+        lines  = entry.split('\n')
+        header = lines[0]
+        parts  = header.split('|', 3)
+        if len(parts) < 3:
+            continue
+
+        hash_      = parts[0].strip()
+        author     = parts[1].strip()
+        time_      = parts[2].strip()
+        first_line = parts[3].strip() if len(parts) > 3 else ''
+        rest       = '\n'.join(lines[1:]).strip()
+        body       = (first_line + '\n' + rest).strip()
+
+        match  = DEVICE_TAG.search(body)
+        device = match.group(1).strip() if match else None
+
+        clean_msg = DEVICE_TAG.sub('', body).strip().splitlines()
+        clean_msg = ' '.join(l.strip() for l in clean_msg if l.strip())
+
+        commits.append({
+            'hash':    hash_,
+            'author':  author,
+            'device':  device,
+            'time':    time_,
+            'message': clean_msg,
+        })
+
+    seen, unique = set(), []
+    for c in commits:
+        if c['hash'] not in seen:
+            seen.add(c['hash'])
+            unique.append(c)
+    return unique
+
+
+def truncate(text, width):
+    return text if len(text) <= width else text[:width - 1] + '…'
+
+
+def border(ch):
+    return f"{BORDER_COLOR}{ch}{RESET}"
+
+
+def render(commits):
+    has_legacy = any(c['device'] is None for c in commits)
+    devices    = [LEGACY_LABEL] if has_legacy else []
+
+    for c in reversed(commits):
+        if c['device'] and c['device'] not in devices:
+            devices.append(c['device'])
+
+    def get_color(d):
+        if d == LEGACY_LABEL:
+            return LEGACY_COLOR
+        device_only = [x for x in devices if x != LEGACY_LABEL]
+        idx = device_only.index(d) if d in device_only else 0
+        return DEVICE_COLORS[idx % len(DEVICE_COLORS)]
+
+    col_w     = MSG_WIDTH + 2
+    row_total = TIME_WIDTH + (col_w + 3) * len(devices) + HASH_WIDTH + 4
+    bar       = BORDER_COLOR + '─' * row_total + RESET
+
+    print(f"\n{bar}")
+    header  = f"  {HEADER_COLOR}{'TIME':<{TIME_WIDTH}}{RESET}"
+    header += border('│')
+    for d in devices:
+        color = get_color(d)
+        label = truncate(d, col_w)
+        header += f" {color}{BOLD}{label:<{col_w}}{RESET} {border('│')}"
+    header += f" {HEADER_COLOR}{'HASH':<{HASH_WIDTH}}{RESET}"
+    print(header)
+    print(bar)
+
+    for c in commits:
+        device   = c['device'] if c['device'] else LEGACY_LABEL
+        time_str = truncate(c['time'], TIME_WIDTH)
+        color    = get_color(device)
+
+        row  = f"  {TIME_COLOR}{time_str:<{TIME_WIDTH}}{RESET}"
+        row += border('│')
+
+        for d in devices:
+            if device == d:
+                msg = truncate(c['message'], col_w)
+                row += f" {color}{msg:<{col_w}}{RESET} {border('│')}"
+            else:
+                dots = DIM + '· ' * ((col_w + 1) // 2)
+                row += f" {dots:<{col_w + len(DIM)}}{RESET} {border('│')}"
+
+        row += f" {HASH_COLOR}{c['hash']}{RESET}"
+        print(row)
+
+    print(bar)
+    print()
+    legend = "  "
+    for d in devices:
+        legend += f"{get_color(d)}{BOLD}■ {d}{RESET}   "
+    print(legend + "\n")
+
+
+def main():
+    raw     = run_git_log()
+    commits = parse_commits(raw)
+    if not commits:
+        print("\n  No commits found.\n")
+        return
+    render(commits)