gitbar 0.1.0__py3-none-any.whl

gitbar-0.1.0.dist-info/METADATA

@@ -0,0 +1,408 @@
+Metadata-Version: 2.4
+Name: gitbar
+Version: 0.1.0
+Summary: Multi-repo Git dashboard in your macOS menubar — PRs, issues, CI status, and local repo health at a glance.
+Author: Vamsi Krishna Kollipara
+License: MIT
+Project-URL: Homepage, https://github.com/vamsi876/gitbar
+Project-URL: Issues, https://github.com/vamsi876/gitbar/issues
+Keywords: git,github,gitlab,bitbucket,menubar,macos,dashboard,pull-request
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pyobjc-framework-Cocoa>=10.0
+Dynamic: license-file
+
+<p align="center">
+  <h1 align="center">gitbar</h1>
+  <p align="center">
+    <strong>Multi-repo Git dashboard in your macOS menubar</strong>
+  </p>
+  <p align="center">
+    Monitor PRs, issues, CI failures, and local repo health — all at a glance.
+  </p>
+  <p align="center">
+    <a href="https://pypi.org/project/gitbar/"><img src="https://img.shields.io/pypi/v/gitbar?color=blue" alt="PyPI"></a>
+    <a href="https://pypi.org/project/gitbar/"><img src="https://img.shields.io/pypi/pyversions/gitbar" alt="Python"></a>
+    <img src="https://img.shields.io/badge/platform-macOS-lightgrey" alt="macOS">
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
+  </p>
+</p>
+
+---
+
+## What You Get
+
+```
+┌──────────────────────────────────────────┐
+│  GP  2❗ • 1✖ • 5                        │  ← menubar with live counts
+└──────────────────────────────────────────┘
+
+┌──────────────────────────────────────────┐
+│  GitPulse                                │
+│──────────────────────────────────────────│
+│  👀  NEEDS YOUR REVIEW  (2)             │
+│    ✅  #142  Fix auth timeout  — api     │
+│    ⏳  #138  Add rate limiting — core    │
+│──────────────────────────────────────────│
+│  🔁  OPEN PULL REQUESTS  (5)            │
+│    ✅  #201  Upgrade deps  — frontend    │
+│    ❌  #199  New dashboard — backend     │
+│    •   #195  Update README — docs        │
+│──────────────────────────────────────────│
+│  📋  MY ISSUES  (3)                     │
+│    #89  Fix login redirect • bug — app   │
+│    #72  Add dark mode • feature — ui     │
+│──────────────────────────────────────────│
+│  ❌  CI FAILURES  (1)                   │
+│    ●  deploy  →  main — backend          │
+│──────────────────────────────────────────│
+│  💻  LOCAL REPOS                         │
+│    myapp      [main]    ● modified • ↑2  │
+│    backend    [dev]     ✓ clean          │
+│──────────────────────────────────────────│
+│  🔓  ACCOUNTS                            │
+│    ✅  GitHub connected                  │
+│    Connect GitLab...                     │
+│    Connect Bitbucket...                  │
+│──────────────────────────────────────────│
+│  Updated 45s ago                         │
+│  ↻  Refresh Now                     ⌘R  │
+│  ⚙  Open Config                     ⌘,  │
+│  Quit GitPulse                       ⌘Q  │
+└──────────────────────────────────────────┘
+```
+
+---
+
+## Quick Start
+
+```bash
+# 1. Install
+pip install gitbar
+
+# 2. Launch
+gitbar
+
+# 3. Connect (click GP in menubar → Connect GitHub...)
+```
+
+That's it. GitBar auto-detects your `gh` CLI login or walks you through a token setup. Your repos are discovered automatically.
+
+---
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Pull Requests** | See all open PRs across every repo, with CI status indicators |
+| **Review Requests** | PRs waiting for *your* review, highlighted at the top |
+| **Issues** | Issues assigned to you across all repos |
+| **CI Failures** | Failed GitHub Actions / GitLab pipelines at a glance |
+| **Local Repos** | Dirty files, ahead/behind counts, current branch |
+| **Click to Open** | Click any PR, issue, or CI run to open it in your browser |
+| **Notifications** | Native macOS alerts for new PRs, review requests, CI failures |
+| **Multi-Provider** | GitHub + GitLab + Bitbucket in one view |
+| **Secure** | Tokens stored in macOS Keychain, never in plain text |
+| **Keyboard Shortcuts** | `R` refresh, `,` config, `Q` quit |
+
+---
+
+## Architecture
+
+```mermaid
+graph TB
+    subgraph Menubar["macOS Menubar (PyObjC)"]
+        SI["Status Item: GP"]
+        Menu["NSMenu + NSMenuDelegate"]
+    end
+
+    subgraph Polling["Background Polling"]
+        Timer["NSTimer (configurable interval)"]
+        Pool["ThreadPoolExecutor (3 workers)"]
+    end
+
+    subgraph Providers["API Providers"]
+        GH["GitHub REST API v3"]
+        GL["GitLab REST API v4"]
+        BB["Bitbucket REST API v2"]
+    end
+
+    subgraph Data["Data Collected Per Poll"]
+        PRs["Open PRs + CI Status"]
+        Issues["Assigned Issues"]
+        CI["Failed CI Runs"]
+        Activity["Recent Activity"]
+    end
+
+    subgraph Local["Local Git"]
+        Checker["LocalRepoChecker"]
+        Git["git subprocess calls"]
+    end
+
+    subgraph Storage["Persistence"]
+        Config["~/.gitpulse/config.yaml"]
+        State["~/.gitpulse/state.json"]
+        Keychain["macOS Keychain"]
+    end
+
+    subgraph Notify["Notifications"]
+        Notifier["Notifier (dedup via StateStore)"]
+        macOS["macOS Notification Center"]
+    end
+
+    SI --> Menu
+    Timer --> Pool
+    Pool --> GH & GL & BB
+    GH & GL & BB --> PRs & Issues & CI & Activity
+    Timer --> Checker
+    Checker --> Git
+    PRs & Issues & CI & Activity --> Menu
+    Activity --> Notifier --> macOS
+    Config --> Providers
+    Keychain --> Providers
+    Notifier --> State
+```
+
+---
+
+## Connection Flow
+
+```mermaid
+flowchart TD
+    A["Click 'Connect GitHub...'"] --> B{gh CLI token cached?}
+    B -->|Yes| C["Show: 'Found gh CLI as username.\nUse this account?'"]
+    C -->|Yes, Connect| D["Background thread"]
+    C -->|Enter Token Manually| E
+    B -->|No| E["Show PAT dialog"]
+    E --> F["Open github.com/settings/tokens"]
+    F --> G["User pastes token"]
+    G --> D
+    D --> H["Validate token via API"]
+    H -->|Invalid| I["Notification: Invalid token"]
+    H -->|Valid| J["Discover all user repos"]
+    J --> K["Store token in macOS Keychain"]
+    K --> L["Save repos to config.yaml"]
+    L --> M["Start polling"]
+    M --> N["Menu shows: GitHub ✅"]
+
+    style A fill:#4a9eff,color:#fff
+    style N fill:#22c55e,color:#fff
+    style I fill:#ef4444,color:#fff
+```
+
+---
+
+## Polling Pipeline
+
+```mermaid
+sequenceDiagram
+    participant T as NSTimer
+    participant P as ThreadPool
+    participant GH as GitHub API
+    participant LC as LocalRepoChecker
+    participant S as StateStore
+    participant M as Menu
+    participant N as Notifier
+
+    T->>P: poll_once()
+    par For each provider
+        P->>GH: fetch_open_prs()
+        P->>GH: fetch_assigned_issues()
+        P->>GH: fetch_ci_runs()
+        P->>GH: fetch_recent_activity()
+    end
+    T->>LC: check_all()
+    LC-->>T: LocalRepoStatus[]
+
+    GH-->>P: PollResult (PRs, Issues, CI, Activity)
+    P->>S: mark_seen(activity)
+    P->>N: maybe_notify(new_pr)
+    N-->>N: macOS notification (if new)
+
+    Note over M: User clicks GP icon
+    M->>M: menuNeedsUpdate_()
+    M->>M: Build sections from cached data
+```
+
+---
+
+## Supported Providers
+
+| Feature | GitHub | GitLab | Bitbucket |
+|---------|:------:|:------:|:---------:|
+| Open Pull Requests | ✅ | ✅ | ✅ |
+| Review Requests | ✅ | ✅ | ✅ |
+| CI/CD Status | ✅ Actions | ✅ Pipelines | — |
+| Assigned Issues | ✅ | — | — |
+| Failed CI Runs | ✅ | — | — |
+| Repo Discovery | ✅ | ✅ | ✅ |
+| Wildcard Repos (`org/*`) | ✅ | ✅ | ✅ |
+| Keychain Storage | ✅ | ✅ | ✅ |
+| `gh` CLI Auto-detect | ✅ | — | — |
+| Enterprise / Self-hosted | ✅ | ✅ | — |
+
+---
+
+## Configuration
+
+Config is auto-created at `~/.gitpulse/config.yaml` when you connect an account. You can also edit it manually:
+
+```yaml
+# How often to poll APIs (seconds, minimum 60)
+poll_interval: 300
+
+# Play sound with notifications
+notification_sound: true
+
+# Git providers (auto-managed via Connect flow)
+providers:
+  github:
+    token: keychain              # "keychain" = stored in macOS Keychain
+    # api_url: https://github.example.com/api/v3   # GitHub Enterprise
+    repos:
+      - owner/repo1
+      - owner/repo2
+      - org-name/*               # wildcard: all repos in an org
+
+  gitlab:
+    token: keychain
+    # api_url: https://gitlab.example.com           # self-hosted
+    repos:
+      - group/project1
+      - group/*
+
+  bitbucket:
+    token: keychain
+    username: your_username      # required for Bitbucket
+    repos:
+      - workspace/repo1
+      - workspace/*
+
+# Local git repos to monitor
+local_repos:
+  - ~/code/project-a
+  - ~/code/project-b
+
+# Toggle individual notification types
+notify:
+  new_pr: true
+  review_requested: true
+  ci_failure: true
+  pr_merged: true
+```
+
+---
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    macOS Menubar                         │
+│                                                         │
+│  PyObjC NSStatusBar → NSMenu with NSMenuDelegate        │
+│  Menu rebuilds dynamically every time you click GP      │
+│  No timer-based menu updates (avoids macOS UI bugs)     │
+└──────────────┬──────────────────────────┬───────────────┘
+               │                          │
+     ┌─────────▼─────────┐    ┌──────────▼──────────┐
+     │  Background Poll   │    │  Local Git Check    │
+     │                    │    │                     │
+     │  NSTimer fires     │    │  subprocess.run()   │
+     │  every N seconds   │    │  git status/log     │
+     │  ThreadPoolExec    │    │  per configured     │
+     │  (3 workers max)   │    │  repo path          │
+     └─────────┬──────────┘    └──────────┬──────────┘
+               │                          │
+     ┌─────────▼──────────────────────────▼───────────┐
+     │              Shared State (thread-safe)         │
+     │                                                 │
+     │  _current_prs[]    _current_issues[]           │
+     │  _current_ci_runs[]  _local_statuses[]         │
+     │  Protected by threading.Lock()                  │
+     └─────────┬──────────────────────────┬───────────┘
+               │                          │
+     ┌─────────▼─────────┐    ┌──────────▼──────────┐
+     │  Notifier          │    │  StateStore         │
+     │  Dedup via seen IDs│    │  JSON persistence   │
+     │  macOS native      │    │  LRU (5000 max)     │
+     │  notifications     │    │  Debounced flush    │
+     └───────────────────┘    └─────────────────────┘
+```
+
+**Key design decisions:**
+- **PyObjC instead of rumps** — rumps has compatibility issues on macOS 26+. Native PyObjC gives full control.
+- **NSMenuDelegate pattern** — Menu content rebuilds on every open (`menuNeedsUpdate_`), so it's always fresh without timer-based UI updates.
+- **All dialogs in main thread** — NSAlert/NSTextField only from menu action callbacks, never from timers or background threads.
+- **Background work via threading** — API calls and git checks run in daemon threads; only `notify()` is called from background (via osascript, which is thread-safe).
+- **macOS Keychain for tokens** — Uses the `security` CLI tool. Config stores `token: keychain` as a sentinel.
+
+---
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/vamsi876/gitbar.git
+cd gitbar
+
+# Install in dev mode
+pip install -e .
+
+# Run
+gitbar
+# or
+python run.py
+```
+
+### Project Structure
+
+```
+gitbar/
+├── gitpulse/                  # main package
+│   ├── app.py                 # PyObjC menubar app + menu building
+│   ├── auth.py                # GitHub/GitLab/Bitbucket auth + keychain
+│   ├── config.py              # YAML config loader/saver
+│   ├── models.py              # Dataclasses: PullRequest, Issue, CIRun, etc.
+│   ├── ui.py                  # Native macOS dialogs (NSAlert, notifications)
+│   ├── poller.py              # Concurrent polling scheduler
+│   ├── notifier.py            # Notification dedup + delivery
+│   ├── state.py               # Persistent state (seen events, last poll)
+│   ├── localrepo.py           # Local git repo status checker
+│   └── providers/
+│       ├── base.py            # Abstract provider with rate-limit handling
+│       ├── github.py          # GitHub REST API v3
+│       ├── gitlab.py          # GitLab REST API v4
+│       └── bitbucket.py       # Bitbucket REST API v2
+├── run.py                     # Dev entry point
+├── config.example.yaml        # Config template
+├── pyproject.toml             # Package config (PyPI name: gitbar)
+├── requirements.txt
+├── LICENSE
+└── README.md
+```
+
+---
+
+## Requirements
+
+- **macOS** 13+ (Ventura or later)
+- **Python** 3.10+
+
+---
+
+## License
+
+MIT &mdash; see [LICENSE](LICENSE)

gitbar-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+gitbar-0.1.0.dist-info/licenses/LICENSE,sha256=Z8XyzNwaJVpuXfMorAIWMwErgHpZL_WRludkikrEH7g,1080
+gitpulse/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+gitpulse/app.py,sha256=E1wZYTFrOITwqUSrrZyYL_vkrOeGKhf5bww4FVg_CRQ,22477
+gitpulse/auth.py,sha256=51Clz51Vxvb000zHtNsdyfJGly1YPP8AmAF0qBBSQMo,6246
+gitpulse/config.py,sha256=C7tDGIw1mKDnpauEXCIVIBVdzKVhRSjNKvUCkHCQsbw,4102
+gitpulse/localrepo.py,sha256=QgO7U3QJcqOyp0IGz8qoYfaZu3WUke7XApY9ClPMbY8,2272
+gitpulse/models.py,sha256=k9OLRvE-HccRJrU0yOnoosttTMvKZBL8dxfJf0pXBKo,2678
+gitpulse/notifier.py,sha256=P9fQryEp-c-LuyJ4xbj3cW8i6yKEK1sWnDIv9n5ub9E,2048
+gitpulse/poller.py,sha256=ypcj2AT-xawmIKs020yFMnJDxsNuGIv-nqSHsGBHAb8,3892
+gitpulse/state.py,sha256=lo5dIf4WuiHCFgtJDqA8POTlkyroD_j1PSJK6kwCkww,2222
+gitpulse/ui.py,sha256=-mp_X0vF8hggI5MyfR2h-1xOspRnpu2m-sCTPAJ66tA,2649
+gitpulse/providers/__init__.py,sha256=p1NOkMIrVTlqz-V0Pdup14_rhJL4asN7HPy-ooTImW4,180
+gitpulse/providers/base.py,sha256=dmrC4V1L-SnHxVhDBl0XClAL7Oi1GzkIRR0EZFAYw5E,2816
+gitpulse/providers/bitbucket.py,sha256=Yi2ppSoBlA51NkksQr0Xbphe92uNuWnPrwy976lMpKk,5068
+gitpulse/providers/github.py,sha256=pK3tt6tXQpKoFqCR61XXiwG8f3PO541kcQXJV7RzhmI,9534
+gitpulse/providers/gitlab.py,sha256=Fx4OBnI9zua3Kt3nCa1jLZDACCh-CsbEeh1vSdJ_tEs,5991
+gitbar-0.1.0.dist-info/METADATA,sha256=vIqh9GI9mo0esZtRIJJrCa74_r6gSqG1IEAi6T6tYUI,15328
+gitbar-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitbar-0.1.0.dist-info/entry_points.txt,sha256=IT1jtAF4mmgxj5PukgAC9Nw5mZ45kJoHvGt1ecIsEpc,48
+gitbar-0.1.0.dist-info/top_level.txt,sha256=0x5i8Ky8Tjsh9daTBEMs79J9ahVc7Ny3zchI4Do3VKI,9
+gitbar-0.1.0.dist-info/RECORD,,

gitbar-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gitbar-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gitbar = gitpulse.app:run_app

gitbar-0.1.0.dist-info/licenses/LICENSE

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

gitbar-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+gitpulse

gitpulse/__init__.py

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