pushpilot 1.1.0__py3-none-any.whl

autopush/watcher.py

@@ -0,0 +1,159 @@
+"""
+Feature-Completion File Watcher for Autopush.
+Monitors directory for changes with a debounced settlement timer.
+When the developer finishes coding a feature, it automatically stages,
+commits with a semantic message, and pushes to GitHub.
+"""
+
+import os
+import sys
+import time
+from datetime import datetime
+from pathlib import Path
+from typing import Callable
+
+from autopush.detector import ProjectStack
+from autopush.git_ops import get_git_status_changes
+
+
+# Folders and extensions to ignore during file watching
+IGNORED_DIRS = {
+    ".git", ".svn", ".hg", "node_modules", "vendor", "target", "build",
+    "dist", ".next", ".nuxt", ".svelte-kit", "__pycache__", ".venv",
+    "venv", "env", ".idea", ".vscode", ".turbo", ".gradle", "bin", "obj",
+    "coverage", ".pytest_cache", ".dart_tool"
+}
+
+IGNORED_EXTS = {
+    ".tmp", ".swp", ".bak", ".log", ".pyc", ".pyo", ".class", ".exe",
+    ".dll", ".so", ".dylib", ".DS_Store"
+}
+
+
+def should_ignore(path: Path) -> bool:
+    """Returns True if file/directory should be ignored."""
+    for part in path.parts:
+        if part in IGNORED_DIRS or part.startswith(".git"):
+            return True
+    if path.suffix.lower() in IGNORED_EXTS:
+        return True
+    if path.name.startswith("~") or path.name.endswith("~"):
+        return True
+    return False
+
+
+def get_tree_fingerprint(root: Path) -> dict[str, float]:
+    """Scans relevant source files and records modification timestamps."""
+    fingerprint = {}
+    try:
+        for entry in root.rglob("*"):
+            if entry.is_file():
+                try:
+                    rel = entry.relative_to(root)
+                    if not should_ignore(rel):
+                        fingerprint[str(rel)] = entry.stat().st_mtime
+                except (OSError, PermissionError):
+                    continue
+    except (OSError, PermissionError):
+        pass
+    return fingerprint
+
+
+class FeatureWatcher:
+    """Watches the project filesystem and triggers push when a feature is complete."""
+
+    def __init__(
+        self,
+        root: Path,
+        stack: ProjectStack,
+        on_feature_complete: Callable[[list[tuple[str, str]]], None],
+        settle_window_sec: float = 8.0,
+        poll_interval_sec: float = 1.5,
+    ):
+        self.root = root
+        self.stack = stack
+        self.on_feature_complete = on_feature_complete
+        self.settle_window = settle_window_sec
+        self.poll_interval = poll_interval_sec
+        self.last_snapshot = get_tree_fingerprint(root)
+        self.changed_batch: set[str] = set()
+        self.last_activity_time: float | None = None
+
+    def start(self):
+        """Runs the monitoring loop."""
+        print("\n" + "=" * 65)
+        print(" AUTOPUSH WATCHER: FEATURE-DRIVEN AUTO-PUSH")
+        print("=" * 65)
+        print(f"Stack Detected   : {self.stack.language} ({self.stack.framework or 'General'})")
+        print(f"Watch Directory  : {self.root}")
+        print(f"Feature Cooldown : {self.settle_window}s settlement window")
+        print("Status           : [LISTENING] Ready for changes. Press Ctrl+C to stop.\n")
+
+        try:
+            while True:
+                current_snapshot = get_tree_fingerprint(self.root)
+                now = time.time()
+
+                # Detect modified, added, or deleted files
+                current_keys = set(current_snapshot.keys())
+                last_keys = set(self.last_snapshot.keys())
+
+                new_files = current_keys - last_keys
+                deleted_files = last_keys - current_keys
+                modified_files = {
+                    k for k in (current_keys & last_keys)
+                    if current_snapshot[k] != self.last_snapshot[k]
+                }
+
+                diff = new_files | deleted_files | modified_files
+                if diff:
+                    self.changed_batch.update(diff)
+                    self.last_activity_time = now
+                    self.last_snapshot = current_snapshot
+
+                    sample_names = ", ".join(Path(f).name for f in list(self.changed_batch)[:3])
+                    more = f" (+{len(self.changed_batch) - 3} more)" if len(self.changed_batch) > 3 else ""
+                    print(
+                        f"\r[EDITING] {len(self.changed_batch)} file(s) active: {sample_names}{more} ... waiting for edits to settle",
+                        end="",
+                        flush=True,
+                    )
+
+                # Check if user paused editing (feature settlement window reached)
+                if self.last_activity_time is not None:
+                    elapsed = now - self.last_activity_time
+                    remaining = self.settle_window - elapsed
+
+                    if remaining > 0 and self.changed_batch:
+                        # Still counting down
+                        print(
+                            f"\r[SETTLING] Feature completion countdown: {int(remaining) + 1}s remaining...   ",
+                            end="",
+                            flush=True,
+                        )
+                    elif remaining <= 0 and self.changed_batch:
+                        # Feature settlement window passed! Trigger auto commit & push
+                        print("\n\n" + "-" * 65)
+                        ts = datetime.now().strftime("%H:%M:%S")
+                        print(f"[FEATURE COMPLETE] Activity settled at {ts}. Starting auto-push...")
+
+                        # Verify actual git status changes
+                        git_changes = get_git_status_changes(self.root)
+                        if git_changes:
+                            try:
+                                self.on_feature_complete(git_changes)
+                            except Exception as e:
+                                print(f"[ERROR] Auto-push failed: {e}")
+                        else:
+                            print("[INFO] Working tree is clean (no git changes staged or untracked).")
+
+                        # Reset batch and update snapshot
+                        self.changed_batch.clear()
+                        self.last_activity_time = None
+                        self.last_snapshot = get_tree_fingerprint(self.root)
+                        print("\n[LISTENING] Resuming watch mode for next feature...\n")
+
+                time.sleep(self.poll_interval)
+
+        except KeyboardInterrupt:
+            print("\n\n[INFO] Autopush watcher stopped by user.")

pushpilot-1.1.0.dist-info/METADATA

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: pushpilot
+Version: 1.1.0
+Summary: PushPilot - Intelligent multi-framework Git autopilot that watches features, detects AI coding context, and ships to GitHub
+Author: PushPilot Developers
+Project-URL: Homepage, https://github.com/rhamifydev/PushPilot
+Project-URL: Repository, https://github.com/rhamifydev/PushPilot.git
+Project-URL: Issues, https://github.com/rhamifydev/PushPilot/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 🚀 PushPilot
+
+> **Intelligent Multi-Framework Git & GitHub Autopilot**  
+> One command to initialize Git, link your GitHub repository, generate conventional commits, and push. Includes a **Feature-Complete File Watcher** that automatically syncs code to GitHub whenever a feature is completed.
+
+[![GitHub](https://img.shields.io/badge/GitHub-rhamifydev%2FPushPilot-blue?logo=github)](https://github.com/rhamifydev/PushPilot)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+
+---
+
+## 🌟 What PushPilot Does
+
+1. **Zero-Config One-Command Setup (`pushpilot <github-url>`)**:
+   - Give it your GitHub repo URL once: `pushpilot https://github.com/username/repo.git`.
+   - If Git is not initialized, PushPilot initializes it with default branch `main`.
+   - Links the `origin` remote automatically.
+   - Detects if GitHub was initialized with a default README or `.gitignore` and merges/rebases seamlessly without conflicts.
+   - Generates a framework-tailored `.gitignore` if none exists.
+   - Stages all files, creates a conventional commit, and pushes directly to GitHub!
+
+2. **Subsequent One-Command Push (`pushpilot` or `auto-push`)**:
+   - Devs just write `pushpilot` (or `auto-push`).
+   - Detects all modified/added/deleted files.
+   - Generates a **Conventional Semantic Commit Message** (e.g., `feat(auth): implement login endpoint in FastAPI`).
+   - Stages, commits, and pushes to GitHub in 2 seconds.
+
+3. **Internal AI Commit Intelligence (Auto-Detect)**:
+   - **Coding with AI?** If you are coding inside an AI-assisted environment (**Google Antigravity IDE**, **Cursor**, **Aider**, **Claude Code**, **Cline**) or have an AI API configured (**Gemini**, **OpenAI**, **Anthropic**, **Groq**, or local **Ollama**), PushPilot detects the active developer intent and git diff to generate **ultra-accurate, laser-focused Conventional Commit messages**.
+   - **Not coding with AI?** PushPilot instantly and seamlessly uses its **smart default heuristic engine** (zero dependencies, zero delay, offline-friendly).
+   - Use `--no-ai` to disable AI detection or `--ai` to force it.
+
+4. **Multi-Language & Multi-Framework Intelligence**:
+   - **JavaScript / TypeScript**: React, Next.js, Vue, Nuxt, Angular, Svelte, Vite, Node.js, Express, NestJS
+   - **Python**: Django, FastAPI, Flask, standard Python, AI/ML
+   - **Rust**: Cargo projects
+   - **Go**: Go modules
+   - **Dart / Flutter**: Mobile & Web Flutter apps
+   - **Java / Kotlin**: Spring Boot, Maven, Gradle
+   - **C# / .NET**: ASP.NET Core, .NET solutions
+   - **PHP**: Laravel, Symfony, Composer
+   - **Ruby**: Ruby on Rails, Bundler
+
+---
+
+## 🚀 One-Command Installation for Developers
+
+Any developer can install and use **PushPilot** globally with a single command:
+
+### Option 1: Install Directly from GitHub (Works right now for anyone!)
+```bash
+# Recommended for CLI tools (pipx or uv)
+pipx install git+https://github.com/rhamifydev/PushPilot.git
+
+# Or via standard pip
+pip install git+https://github.com/rhamifydev/PushPilot.git
+```
+
+### Option 2: Install from PyPI
+```bash
+pip install pushpilot
+# or
+pipx install pushpilot
+```
+
+### Option 3: Local / Development
+Clone the repo and run:
+```bash
+pip install -e .
+```
+
+Once installed, the commands `pushpilot`, `pilot`, and `push` are available anywhere in your terminal!
+
+---
+
+## 🛠️ Usage Examples
+
+### 1. Initialize & Link GitHub in One Step
+```bash
+pushpilot https://github.com/rhamifydev/PushPilot.git
+```
+*Initializes Git if needed, sets default branch `main`, links remote `origin`, stages, commits, and pushes to GitHub.*
+
+### 2. Instant Auto-Push (Subsequent uses)
+```bash
+pushpilot
+```
+
+### 3. Continuous Feature-Complete Watcher
+```bash
+pushpilot --watch
+```
+*Watches files and pushes to GitHub whenever you finish coding a feature increment!*
+
+Customizing the feature settlement window:
+```bash
+pushpilot -w --cooldown 10
+```
+
+### 4. Custom Commit Message
+```bash
+pushpilot -m "feat(payment): integrate Stripe checkout webhook"
+```
+
+### 5. Inspect Detected Project Stack
+```bash
+pushpilot --detect
+```
+
+### 6. Interactive Setup / Update GitHub Remote
+```bash
+pushpilot --setup
+```
+
+### 7. Dry-Run (Preview what would happen)
+```bash
+pushpilot --dry-run
+```
+
+---
+
+## 📋 CLI Reference
+
+| Command / Option | Description |
+| :--- | :--- |
+| `pushpilot [URL]` | Run auto-sync (optionally initialize & link GitHub repository URL) |
+| `-w`, `--watch` | Continuous watcher mode with feature-completion settlement |
+| `--cooldown SEC` | Seconds of inactivity before triggering feature commit (default: 8s) |
+| `-m`, `--message MSG` | Override auto-generated message with a custom commit message |
+| `-b`, `--branch NAME` | Target git branch (defaults to active branch / `main`) |
+| `-r`, `--remote NAME` | Target git remote (default: `origin`) |
+| `--detect` | Print detected language, framework, ecosystem, and git status |
+| `--setup` | Interactively link or update GitHub repository URL |
+| `--init-gitignore` | Create/reset tailored `.gitignore` for the detected stack |
+| `--ai` | Explicitly enable AI-powered commit generation (auto-detected by default) |
+| `--no-ai` | Disable AI detection and force default rule-based conventional commit |
+| `--dry-run` | Simulate actions without staging, committing, or pushing |
+| `-v`, `--version` | Display version information |

pushpilot-1.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+autopush/__init__.py,sha256=SpOQFYdsQu6vZ7YZgLb8XZgeMaEhuoKxY4euDJaCSW0,145
+autopush/ai_commit.py,sha256=c6HEmiJANjW07uP0N_81t3SpRGZWDSEE3PSO3t0zIwc,17638
+autopush/cli.py,sha256=JHKW7eXorYn7JYxjclJuCiTL3guu-gA6qnCGEQZNfhM,10714
+autopush/commit_gen.py,sha256=annJAlEK_rwMaZUzFR6t4imSknhWEoVtYAEwvy268tE,5647
+autopush/detector.py,sha256=n4nMeYOlzVc4g3J14BMr6FccAgi3yKJX1LEItVEKKYE,10850
+autopush/git_ops.py,sha256=OogEKTFnZ25TrBVXX6Gu3vE8Pk6U38rq4v6q6fINPlE,9884
+autopush/watcher.py,sha256=iBt9R1Es4EciUoJtaOkx8QP7cHsouPCFB4z7rOZD71Y,6548
+pushpilot-1.1.0.dist-info/licenses/LICENSE,sha256=vrjkLp1rQoTgMwTQWoGgdVIAqWX8jQpeCuoehM-AXW4,1361
+pushpilot-1.1.0.dist-info/METADATA,sha256=70wfTpPWHBGBEoTA-Bgw20n9dAOq_Cn1cxTabNVAkys,6357
+pushpilot-1.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+pushpilot-1.1.0.dist-info/entry_points.txt,sha256=aayTSdbvlMZRK-VMJ9p85QtWTd6Z7sjEPbkUrrGUKbE,158
+pushpilot-1.1.0.dist-info/top_level.txt,sha256=f3ETxgK4ewbR38w1QOu-wIr7qAy_UzfJiowrTJp9bbI,9
+pushpilot-1.1.0.dist-info/RECORD,,

pushpilot-1.1.0.dist-info/WHEEL

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

pushpilot-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+auto-push = autopush.cli:main
+autopush = autopush.cli:main
+pilot = autopush.cli:main
+push = autopush.cli:main
+pushpilot = autopush.cli:main

pushpilot-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,23 @@
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+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, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

pushpilot-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+autopush