claude-code-usage 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

{claude_code_usage-1.0.0.dist-info → claude_code_usage-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-usage
-Version: 1.0.0
+Version: 1.0.2
 Summary: System tray monitor for Claude Code token usage
 Author: Max
 License: MIT
@@ -28,6 +28,7 @@ Dynamic: license-file
 
 A Linux/GNOME system tray application that monitors your Claude Code token usage and alerts you before hitting limits.
 
+[![PyPI version](https://img.shields.io/pypi/v/claude-code-usage.svg)](https://pypi.org/project/claude-code-usage/)
 ![Python](https://img.shields.io/badge/python-3.11+-blue.svg)
 ![Platform](https://img.shields.io/badge/platform-Linux%2FGNOME-lightgrey.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
@@ -73,7 +74,20 @@ Install the [AppIndicator Support](https://extensions.gnome.org/extension/615/ap
 
 ## Installation
 
-### Quick Install (recommended)
+### From PyPI (recommended)
+
+1. Install system dependencies (see [System Dependencies](#system-dependencies) above)
+
+2. Install with pipx (recommended):
+   ```bash
+   pipx install claude-code-usage --system-site-packages
+   ```
+
+   The `--system-site-packages` flag is required to access system GTK libraries.
+
+3. Run: `claude-usage`
+
+### From Source
 
 ```bash
 git clone https://github.com/Maex-z9/CC_Usage.git
@@ -81,32 +95,15 @@ cd CC_Usage
 ./install.sh
 ```
 
-This installs system dependencies and the app. Then run with: `claude-usage`
-
-### Manual Install
-
-1. Install system dependencies:
-   ```bash
-   # Ubuntu/Debian
-   sudo apt install python3-gi python3-gi-cairo gir1.2-ayatanaappindicator3-0.1 gir1.2-notify-0.7
+This installs system dependencies and the app automatically.
 
-   # Fedora
-   sudo dnf install python3-gobject python3-cairo libayatana-appindicator-gtk3 libnotify
+### Prerequisites
 
-   # Arch
-   sudo pacman -S python-gobject python-cairo libayatana-appindicator libnotify
-   ```
-
-2. Install the app:
-   ```bash
-   pip install git+https://github.com/Maex-z9/CC_Usage.git
-   ```
-
-3. Authenticate with Claude Code (if not already done):
-   ```bash
-   claude
-   # Follow the authentication flow
-   ```
+Make sure you have Claude Code CLI installed and authenticated:
+```bash
+claude
+# Follow the authentication flow
+```
 
 ## Usage
 

claude_code_usage-1.0.2.dist-info/RECORD

@@ -0,0 +1,15 @@
+claude_code_usage-1.0.2.dist-info/licenses/LICENSE,sha256=alXcUJ2-k8eqG_Amt8y9Hhlb8fT1nABafZOqWDmdzUw,1060
+src/__init__.py,sha256=rzeXYIMbNbWPF6gpjv7luGXLZA67r_5GU5ZGUNb8pKA,27
+src/api.py,sha256=IymlJFR7_Ou5I_Asij8oyR2b7bx9WurBtREwcysbiJQ,6168
+src/autostart.py,sha256=Xo0JcjUJ8RZ-pervQ6f8mQAxngO73Rf-IDdg0uWzlKw,3369
+src/config.py,sha256=_PIPM7wfbQq1c7tHT26_L39PXbLVQWuzxaB2FMWiavw,5300
+src/icon_generator.py,sha256=h1xJtzjjJp958ulmsla5DOyutOVTR1Q_0T2ymlO1IEk,3537
+src/main.py,sha256=A7Ej5kqbtOYWUGSuZxx6bM-7WNimjjAs--04_kvvta0,506
+src/notifier.py,sha256=3j5ZmhaFMfv5XDLMCFaOgSCCw5jffn4N6dNz2R7gd8I,10267
+src/tray.py,sha256=sCvQLsNdm3uBtdeNGzFmLxzLT1h1w_LH4ZsajZIlg4I,10995
+src/utils.py,sha256=ZqGvw-oyzHompxRMUeYT5FdJFaQ6uvoAthhu-3bPGJk,893
+claude_code_usage-1.0.2.dist-info/METADATA,sha256=LkcegPyA4MNkqfcAmfziXL-MgppRK4TWRG_nfBkbZTM,5568
+claude_code_usage-1.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claude_code_usage-1.0.2.dist-info/entry_points.txt,sha256=MY_VQ3t41-QKCQuBjBsd4ug0uOUlCz1Hz-OyK78gfns,47
+claude_code_usage-1.0.2.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+claude_code_usage-1.0.2.dist-info/RECORD,,

claude_code_usage-1.0.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude-usage = src.main:main

src/api.py

@@ -63,7 +63,9 @@ def fetch_usage(access_token: str) -> UsageData:
     }
 
     try:
-        response = requests.get(USAGE_ENDPOINT, headers=headers, timeout=10)
+        response = requests.get(
+            USAGE_ENDPOINT, headers=headers, timeout=10, verify=True
+        )
     except requests.RequestException as e:
         raise APIError(f"Network error: {e}")
 
@@ -113,9 +115,8 @@ def fetch_usage(access_token: str) -> UsageData:
         raise APIError(f"Server error: {response.status_code}")
 
     else:
-        raise APIError(
-            f"Unexpected response: {response.status_code} - {response.text}"
-        )
+        # Don't expose response body - may contain sensitive server info
+        raise APIError(f"Unexpected response: {response.status_code}")
 
 
 def fetch_with_retry(access_token: str, max_retries: int = 3) -> UsageData:

src/autostart.py

@@ -1,6 +1,8 @@
 """Autostart management for Claude Usage Overlay."""
 
 import os
+import shutil
+from configparser import ConfigParser
 from pathlib import Path
 
 
@@ -31,6 +33,28 @@ def get_desktop_file_path() -> Path:
     return get_autostart_path() / 'claude-usage-overlay.desktop'
 
 
+def _get_exec_command() -> str:
+    """Determine the best Exec command for the .desktop file.
+
+    Returns:
+        Command string for Exec= line, preferring installed entry point
+    """
+    # Prefer the installed 'claude-usage' command if available
+    claude_usage_path = shutil.which("claude-usage")
+    if claude_usage_path:
+        return claude_usage_path
+
+    # Fallback to running module directly with python
+    project_root = Path(__file__).parent.parent.absolute()
+    main_py = project_root / "src" / "main.py"
+    if main_py.exists():
+        # Use sys.executable equivalent for current python
+        return f"python3 -m src.main"
+
+    # Last resort: assume it's installed as module
+    return "python3 -m src.main"
+
+
 def create_autostart_entry(enable: bool = True):
     """Create or update autostart .desktop file.
 
@@ -39,9 +63,8 @@ def create_autostart_entry(enable: bool = True):
     """
     desktop_file = get_desktop_file_path()
 
-    # Get absolute path to main.py
-    project_root = Path(__file__).parent.parent.absolute()
-    exec_path = f"/usr/bin/python3 {project_root}/src/main.py"
+    # Get best exec command (prefer installed entry point)
+    exec_cmd = _get_exec_command()
 
     # Desktop entry content
     hidden_value = "false" if enable else "true"
@@ -50,7 +73,7 @@ Type=Application
 Version=1.0
 Name=Claude Code Usage Monitor
 Comment=System tray monitor for Claude Code token usage
-Exec={exec_path}
+Exec={exec_cmd}
 Icon=dialog-information
 Terminal=false
 Categories=Utility;Monitor;
@@ -59,9 +82,10 @@ X-GNOME-Autostart-enabled=true
 Hidden={hidden_value}
 """
 
-    # Write .desktop file
+    # Write .desktop file with secure permissions (rw-r--r--)
+    # .desktop files don't need execute bit - they're parsed by desktop environment
     desktop_file.write_text(content)
-    desktop_file.chmod(0o755)
+    desktop_file.chmod(0o644)
 
 
 def remove_autostart_entry():
@@ -82,13 +106,14 @@ def is_autostart_enabled() -> bool:
     if not desktop_file.exists():
         return False
 
-    content = desktop_file.read_text()
-
-    # Parse for Hidden= line (case insensitive value)
-    for line in content.splitlines():
-        if line.strip().startswith('Hidden='):
-            value = line.split('=', 1)[1].strip().lower()
-            return value != 'true'
-
-    # If Hidden not present, autostart is enabled
-    return True
+    # Use configparser for proper INI parsing
+    parser = ConfigParser(interpolation=None)
+    try:
+        parser.read(desktop_file)
+        # Desktop files use 'Desktop Entry' section
+        # Hidden=true means disabled; absent or false means enabled
+        hidden = parser.get('Desktop Entry', 'Hidden', fallback='false')
+        return hidden.lower() != 'true'
+    except Exception:
+        # If parsing fails, assume enabled if file exists
+        return True

src/icon_generator.py

@@ -6,8 +6,27 @@ Generates circular gauge icons using Cairo for system tray display.
 import cairo
 import math
 import os
+import tempfile
+from pathlib import Path
 from typing import Tuple
 
+# Secure temp directory for icons (created once, reused)
+_icon_temp_dir: str | None = None
+
+
+def _get_secure_icon_dir() -> str:
+    """Get or create a secure temporary directory for icon files.
+
+    Returns:
+        Path to secure temp directory with restricted permissions (0o700)
+    """
+    global _icon_temp_dir
+    if _icon_temp_dir is None or not Path(_icon_temp_dir).exists():
+        # Create secure temp directory owned by current user only
+        _icon_temp_dir = tempfile.mkdtemp(prefix="claude-usage-icons-")
+        os.chmod(_icon_temp_dir, 0o700)
+    return _icon_temp_dir
+
 
 def get_color_for_percentage(percentage: float) -> Tuple[float, float, float]:
     """
@@ -85,8 +104,9 @@ def generate_gauge_icon(percentage: float, color_percentage: float, size: int =
         ctx.arc(center, center, radius, -math.pi / 2, end_angle)
         ctx.stroke()
 
-    # Save to unique filename per percentage and color state (bust GTK icon cache)
-    icon_path = f"/tmp/claude-usage-{int(percentage)}-{color_name}.png"
+    # Save to secure temp directory with unique filename (bust GTK icon cache)
+    icon_dir = _get_secure_icon_dir()
+    icon_path = os.path.join(icon_dir, f"gauge-{int(percentage)}-{color_name}.png")
     surface.write_to_png(icon_path)
 
     return os.path.abspath(icon_path)

claude_code_usage-1.0.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-claude_code_usage-1.0.0.dist-info/licenses/LICENSE,sha256=alXcUJ2-k8eqG_Amt8y9Hhlb8fT1nABafZOqWDmdzUw,1060
-src/__init__.py,sha256=rzeXYIMbNbWPF6gpjv7luGXLZA67r_5GU5ZGUNb8pKA,27
-src/api.py,sha256=IChRjcU8vqmiQ64YOQRXiQi8DSNxvknD4Y4mVOwH01g,6100
-src/autostart.py,sha256=2Rnsr1y_yXbwwARnoYJl5_uQfMch8XsD7vgJi2CfTII,2399
-src/config.py,sha256=_PIPM7wfbQq1c7tHT26_L39PXbLVQWuzxaB2FMWiavw,5300
-src/icon_generator.py,sha256=Ljwhrj9ezqJSLspLu2DlmJGbfvcOLJnW50O-4J3gwKE,2861
-src/main.py,sha256=A7Ej5kqbtOYWUGSuZxx6bM-7WNimjjAs--04_kvvta0,506
-src/notifier.py,sha256=3j5ZmhaFMfv5XDLMCFaOgSCCw5jffn4N6dNz2R7gd8I,10267
-src/tray.py,sha256=sCvQLsNdm3uBtdeNGzFmLxzLT1h1w_LH4ZsajZIlg4I,10995
-src/utils.py,sha256=ZqGvw-oyzHompxRMUeYT5FdJFaQ6uvoAthhu-3bPGJk,893
-claude_code_usage-1.0.0.dist-info/METADATA,sha256=tbz_u_pwUI_L31RgUWMCvrIAmkIltnjCKUimCLhyUTA,5613
-claude_code_usage-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-claude_code_usage-1.0.0.dist-info/entry_points.txt,sha256=sRUb89gemjebLTvCQVv6TJWunjYrD-i_it3A3E9bJVc,95
-claude_code_usage-1.0.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-claude_code_usage-1.0.0.dist-info/RECORD,,

claude_code_usage-1.0.0.dist-info/entry_points.txt

@@ -1,5 +0,0 @@
-[console_scripts]
-claude-usage = src.main:main
-
-[gui_scripts]
-claude-usage-gui = src.main:main