gitcast 1.0.6__tar.gz → 1.0.7__tar.gz

{gitcast-1.0.6/gitcast.egg-info → gitcast-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcast
-Version: 1.0.6
+Version: 1.0.7
 Summary: git diff → published post. under 60 seconds.
 Home-page: https://github.com/drizzy765/gitcast
 Author: Timilehin Agoro

{gitcast-1.0.6 → gitcast-1.0.7}/cli/gitcast.py

@@ -67,16 +67,12 @@ def main():
         # open browser
         webbrowser.open("http://localhost:8000")
 
-        # start tray and hotkey
+        print("[OK] server running at http://localhost:8000")
+        print("[OK] browser opened")
+        print("[OK] hotkey: Ctrl+Shift+P")
+
         from core.tray import run_tray
-        import sys as _sys
-        import os as _os
-        _parent = _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__)))
-        if _os.path.exists(_os.path.join(_parent, "main.py")):
-            _sys.path.insert(0, _parent)
-        elif _os.path.exists(_os.path.join(_os.getcwd(), "main.py")):
-            _sys.path.insert(0, _os.getcwd())
-        from main import on_trigger
+        from core.trigger import on_trigger
         run_tray(trigger_callback=on_trigger)
         return
 

gitcast-1.0.7/core/trigger.py

@@ -0,0 +1,96 @@
+import threading
+from core.capture import run_capture
+from core.ocr import run_ocr
+from api.payload import build_payload
+from ui.popup import show_popup
+from config.settings import is_sprint_mode
+from storage.sprint import log_sprint_capture
+from ai.generator import generate_posts
+from ui.review import show_review
+from publisher.twitter import publish_post
+from storage.logger import log_post
+import asyncio
+import webbrowser
+
+
+def on_trigger():
+    """
+    Called every time the hotkey fires.
+    Full capture → generate → review flow.
+    """
+    print("[Gitcast] Hotkey fired — starting capture...")
+
+    capture = run_capture()
+    ocr = run_ocr(capture["screenshot"]["path"])
+
+    if is_sprint_mode():
+        log_sprint_capture(
+            git_diff=capture["git_diff"].get("diff", ""),
+            ocr_text=ocr.get("text", ""),
+            raw_thought="",
+            timestamp=capture["screenshot"]["timestamp"],
+        )
+        print("[Gitcast] Sprint Mode — capture logged silently.")
+        return
+
+    def on_submit(raw_thought):
+        print(f"[Gitcast] Raw thought: '{raw_thought}'")
+        payload = build_payload(
+            raw_thought=raw_thought,
+            ocr_result=ocr,
+            capture_result=capture,
+        )
+        payload["use_vision_fallback"] = False
+        payload["screenshot_b64"] = None
+
+        def generate_and_show():
+            variations = asyncio.run(generate_posts(payload))
+
+            def on_publish(post_text, format_key,
+                           screenshot_path):
+                print(f"[Gitcast] Publishing: {format_key}")
+                result = publish_post(
+                    post_text, screenshot_path)
+                if result.get("success"):
+                    if result.get("fallback"):
+                        print("[Gitcast] Copied to clipboard")
+                    else:
+                        print(f"[Gitcast] Published: "
+                              f"{result.get('tweet_url')}")
+                    log_post(
+                        post_text=post_text,
+                        format_key=format_key,
+                        screenshot_path=screenshot_path,
+                        tweet_url=result.get(
+                            "tweet_url", ""),
+                        tweet_id=result.get(
+                            "tweet_id", ""),
+                        fallback=result.get(
+                            "fallback", False),
+                    )
+                else:
+                    print(f"[Gitcast] Error: "
+                          f"{result.get('error')}")
+
+            def on_close():
+                print("[Gitcast] Review closed.")
+
+            show_review(
+                payload=payload,
+                variations=variations,
+                on_publish=on_publish,
+                on_close=on_close,
+            )
+
+        threading.Thread(
+            target=generate_and_show,
+            daemon=True
+        ).start()
+
+    def on_dismiss():
+        print("[Gitcast] Capture dismissed.")
+
+    show_popup(
+        on_submit=on_submit,
+        on_dismiss=on_dismiss
+    )

{gitcast-1.0.6 → gitcast-1.0.7}/docs/pypi-errors.md

@@ -66,3 +66,56 @@ This document records the issues faced during the testing, packaging, and execut
   ```
 * **Status**: Logged and waiting for future triage. The application starts, but key bindings or endpoints triggers are failing to generate the actual post output.
 
+### Issue 2.2: ImportError and Pygame conflicts when running gitcast CLI from project directories containing `main.py`
+* **Symptom**: Running `gitcast` from any project directory containing its own `main.py` (e.g., `snakegame/main.py`) causes the application to crash on startup after initializing the user's local modules (e.g., importing `pygame` and running game startup logic).
+* **Console Logs & Traceback**:
+  ```text
+  (venv) PS C:\Users\USER\Documents\snakegame> gitcast
+  [Monitoring] Sentry not configured - skipping
+
+  [Auth] Session Token: fe45cf73-a93b-4db3-a90a-f03dda41001c
+  [Server] Starting Gitcast API on http://127.0.0.1:8000
+
+  [Auth] Session Token: fe45cf73-a93b-4db3-a90a-f03dda41001c
+  [Server] Starting Gitcast API on http://127.0.0.1:8000
+  pygame 2.6.1 (SDL 2.28.4, Python 3.10.0)
+  Hello from the pygame community. https://www.pygame.org/contribute.html
+  Traceback (most recent call last):
+    File "C:\Users\USER\AppData\Local\Programs\Python\Python310\lib\runpy.py", line 196, in _run_module_as_main
+      return _run_code(code, main_globals, None,
+    File "C:\Users\USER\AppData\Local\Programs\Python\Python310\lib\runpy.py", line 86, in _run_code
+      exec(code, run_globals)
+    File "C:\Users\USER\Documents\context-engine\venv\Scripts\gitcast.exe\__main__.py", line 7, in <module>
+      sys.exit(main())
+    File "C:\Users\USER\Documents\context-engine\venv\lib\site-packages\cli\gitcast.py", line 79, in main
+      from main import on_trigger
+  ImportError: cannot import name 'on_trigger' from 'main' (C:\Users\USER\Documents\snakegame\main.py)
+  ```
+* **Root Cause**:
+  In `cli/gitcast.py`, the script checks if `main.py` exists in the current working directory (`os.getcwd()`), and if so, prepends `os.getcwd()` to `sys.path` and attempts to run `from main import on_trigger`. 
+  This causes the following critical failures:
+  1. **Unwanted Side-Effects**: It imports and executes the user's local `main.py` (e.g., in a snake game project), causing dependencies like `pygame` to initialize and boot, printing their community welcome messages and running game startup side-effects.
+  2. **Namespace Collision & ImportError**: Since the user's `main.py` does not define `on_trigger`, the application crashes with an `ImportError`.
+  3. **Missing Package Module**: The packaged/installed version of `gitcast` from PyPI does not distribute its own root-level `main.py` file because `find_packages()` in `setup.py` only bundles directories containing `__init__.py`. Thus, `main` is completely missing from site-packages.
+* **Status**: Logged and pending future resolution.
+
+#### Proposed Solutions & Analysis
+
+##### Option A: Move trigger callback logic to a dedicated package module (e.g., `core/trigger.py`)
+* **Rating**: ⭐⭐⭐⭐⭐ (Best Possible Fix)
+* **Ups (Pros)**:
+  1. **Clean Namespace isolation**: Completely eliminates the custom `sys.path.insert(0, os.getcwd())` lookup logic inside `cli/gitcast.py`.
+  2. **No collisions**: Importing from `core.trigger` is guaranteed to load files packaged inside your library's namespace, so it won't conflict with any `main.py` inside the user's workspace.
+  3. **No side-effects**: Users' codebases (like a Pygame-based game) will never be imported or executed by Gitcast's boot process.
+  4. **Packaging Standard**: Adheres to Python's package guidelines by not polluting the global site-packages namespace with a top-level module named `main`.
+* **Downs (Cons)**:
+  - Requires moving the `on_trigger` function definition from `main.py` to `core/trigger.py` (minimal effort).
+
+##### Option B: Package the root-level `main.py` explicitly in `setup.py`
+* **Rating**: ⭐⭐ (Poor Packaging Practice)
+* **Ups (Pros)**:
+  - Quick fix: Simply adding `py_modules=["main"]` in `setup.py` distributes `main.py` alongside the package directories.
+* **Downs (Cons)**:
+  - **Global namespace pollution**: Distributing a generic package module named `main` into Python's `site-packages` namespace is highly discouraged. It will clash with any local `main` module import in users' custom python environments.
+  - **Does not solve the collision**: Since `sys.path` in `cli/gitcast.py` checks `os.getcwd()` first, the local `main.py` of the user's project (e.g. `snakegame/main.py`) will still override and take precedence over the packaged `main.py`, preserving the pygame execution side-effects and crash.
+

{gitcast-1.0.6 → gitcast-1.0.7/gitcast.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcast
-Version: 1.0.6
+Version: 1.0.7
 Summary: git diff → published post. under 60 seconds.
 Home-page: https://github.com/drizzy765/gitcast
 Author: Timilehin Agoro

{gitcast-1.0.6 → gitcast-1.0.7}/gitcast.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ core/ocr.py
 core/screenshot_session.py
 core/security.py
 core/tray.py
+core/trigger.py
 docs/api-keys.md
 docs/article-generator.md
 docs/capture-flow.md
@@ -78,6 +79,8 @@ storage/tone_memory.py
 tests/test_keys.py
 tests/test_ocr_fix.py
 ui/__init__.py
+ui/popup.py
+ui/review.py
 web/__init__.py
 web/index.html
 web/landing.html

{gitcast-1.0.6 → gitcast-1.0.7}/setup.py

@@ -51,7 +51,7 @@ if os.path.exists(requirements_path):
 
 setup(
     name="gitcast",
-    version="1.0.6",
+    version="1.0.7",
     description="git diff → published post. under 60 seconds.",
     long_description=long_description,
     long_description_content_type="text/markdown",

gitcast-1.0.7/ui/popup.py

@@ -0,0 +1,12 @@
+def show_popup(on_submit, on_dismiss):
+    """
+    Tkinter popup fallback/mock.
+    Immediately submits a default thought to run the pipeline.
+    """
+    import threading
+    
+    def run():
+        print("[Gitcast] Mock popup triggered.")
+        on_submit("Captured via hotkey trigger")
+        
+    threading.Thread(target=run, daemon=True).start()

gitcast-1.0.7/ui/review.py

@@ -0,0 +1,25 @@
+import json
+import webbrowser
+from config.settings import CURRENT_DRAFT
+
+def show_review(payload, variations, on_publish, on_close):
+    """
+    Tkinter review window fallback/mock.
+    Saves the generated variations to current draft and opens the web dashboard.
+    """
+    print("[Gitcast] Mock review window triggered - saving draft and opening browser.")
+    draft_data = {
+        "payload": payload,
+        "variations": variations,
+        "timestamp": payload.get("timestamp", ""),
+        "status": "ready"
+    }
+    try:
+        with open(CURRENT_DRAFT, "w", encoding="utf-8") as f:
+            json.dump(draft_data, f, indent=4)
+        print("[Gitcast] Draft saved successfully.")
+    except Exception as e:
+        print(f"[Gitcast] Failed to save draft: {e}")
+        
+    webbrowser.open("http://localhost:8000")
+    on_close()