tool-tray 0.3.8__py3-none-any.whl

tool_tray-0.3.8.dist-info/METADATA

@@ -0,0 +1,185 @@
+Metadata-Version: 2.3
+Name: tool-tray
+Version: 0.3.8
+Summary: System tray tool manager for private GitHub tools via uv
+Author: Fredrik Averpil
+Author-email: Fredrik Averpil <fredrik.averpil@gmail.com>
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pillow>=12.1.0
+Requires-Dist: pyshortcuts>=1.9.7
+Requires-Dist: pystray>=0.19.5
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Tool Tray
+
+System tray app to manage and update Python tools from private GitHub repos via uv.
+
+## Quick Start
+
+### For Users
+
+1. Install:
+   ```bash
+   uv tool install tool-tray
+   ```
+
+2. Run the tray:
+   ```bash
+   tooltray
+   ```
+
+3. On first run, setup dialog opens automatically - paste your config code
+
+### For Admins
+
+Generate a config code to share with your team:
+
+```bash
+tooltray encode --token ghp_xxx --repo myorg/myapp
+# Output: TB-eyJ0b2tlbi...
+```
+
+Each repo must have a `tooltray.toml` manifest (see below).
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `tooltray` | Run tray app |
+| `tooltray setup` | Configure via CLI (paste config code) |
+| `tooltray reset` | Remove config and start fresh |
+| `tooltray init` | Create `tooltray.toml` template in current dir |
+| `tooltray encode` | Generate config code for sharing |
+| `tooltray autostart` | Manage system startup |
+| `tooltray logs` | View log file |
+| `tooltray cleanup` | Remove orphaned desktop icons |
+| `tooltray --help` | Show help |
+| `tooltray --version` | Show version |
+
+### Encode Options
+
+```bash
+tooltray encode --token TOKEN --repo ORG/REPO [--repo ...] [--prefix PREFIX]
+```
+
+Examples:
+```bash
+# Single repo (default TB- prefix)
+tooltray encode --token ghp_xxx --repo myorg/myapp
+
+# Multiple repos
+tooltray encode --token ghp_xxx \
+  --repo acme/cli \
+  --repo acme/api
+
+# Custom prefix for branding
+tooltray encode --prefix ACME --token ghp_xxx --repo acme/cli
+```
+
+### Autostart
+
+```bash
+tooltray autostart --enable   # Add to system startup
+tooltray autostart --disable  # Remove from startup
+tooltray autostart --status   # Check if enabled
+```
+
+### Logs
+
+```bash
+tooltray logs           # Show last 50 lines
+tooltray logs -f        # Tail in real-time
+tooltray logs --path    # Print log file path
+```
+
+### Cleanup
+
+Remove orphaned desktop icons (icons for tools no longer in config):
+
+```bash
+tooltray cleanup --dry-run  # Show what would be removed
+tooltray cleanup            # Prompt and remove
+tooltray cleanup --force    # Remove without prompting
+```
+
+## Tray Menu
+
+When not configured:
+| Item | Description |
+|------|-------------|
+| `[!] Not configured` | Status indicator |
+| Setup... | Open setup dialog |
+| Quit | Exit the app |
+
+When configured:
+| Item | Description |
+|------|-------------|
+| `> myapp 1.0.0` | Click to launch |
+| `> myapp 1.0.0 -> 1.1.0 *` | Update available, click to launch |
+| `myapp (not installed)` | Not yet installed |
+| Orphaned Icons | Shows icons needing cleanup (if any) |
+| Clean Up (n) | Remove orphaned icons |
+| Update All | Install/update all tools |
+| Check for Updates | Refresh version info |
+| Configure... | Open setup dialog to reconfigure |
+| Quit | Exit the app |
+
+## Project Manifest (`tooltray.toml`)
+
+Each managed repo must have a `tooltray.toml` in its root:
+
+```toml
+name = "databridge"           # Display name (required)
+type = "uv"                   # uv | git (required)
+launch = "databridge"         # Command to launch (optional)
+build = "npm install"         # Build command for git type (optional)
+desktop_icon = true           # Create desktop shortcut (default: false)
+icon = "assets/icon.png"      # Path to icon in repo (optional)
+autostart = false             # Add to system autostart (default: false)
+```
+
+Repos without `tooltray.toml` are skipped.
+
+## Config Code Format
+
+The config code is a prefix + base64-encoded JSON:
+
+```
+TB-eyJ0b2tlbiI6ImdocF94eHgiLCJyZXBvcyI6WyJteW9yZy9teWFwcCJdfQ==
+```
+
+Decodes to:
+```json
+{
+  "token": "ghp_xxx",
+  "repos": ["myorg/myapp"]
+}
+```
+
+Config is stored at:
+- **Windows:** `%LOCALAPPDATA%\tooltray\config.json`
+- **macOS:** `~/Library/Application Support/tooltray/config.json`
+- **Linux:** `~/.config/tooltray/config.json`
+
+## Requirements
+
+- Python 3.12+
+- uv
+
+## Development
+
+```bash
+# Run directly
+uv run tooltray
+
+# Test encode command
+uv run tooltray encode --token test123 --repo myorg/myapp
+
+# Type check
+uv run basedpyright src/
+```
+
+## License
+
+MIT

tool_tray-0.3.8.dist-info/RECORD

@@ -0,0 +1,15 @@
+tool_tray/__init__.py,sha256=XLe-TtIKjOmZRxc0AE6p-B57-quCUuB9oPNZBGDwcZI,10337
+tool_tray/__main__.py,sha256=kPhKj3ISnfdEj_xNeV02OyVne5R22PDUJXBrFdCdw6c,66
+tool_tray/autostart.py,sha256=ukgQoqvuMOtn9_toaLwMkDbDbU9aOXaIglScGFseO7Q,7684
+tool_tray/config.py,sha256=sPD2BL4s9ONcOK0Gac-efkiFgHJvbHxD2-LK2nl5-uw,3154
+tool_tray/desktop.py,sha256=87uBbZgE3pgZhjKfV1pKRrk83nuMKtBrR87enH_3eq0,3236
+tool_tray/logging.py,sha256=cXO4mxZsQ2sSdCC1HyMbszBOzDH17GFzVnh_bpsk6-c,1939
+tool_tray/manifest.py,sha256=lr13lcoaNsOi4E2_PCiomPN4-cQ05_bdNVuPyrONJeM,1915
+tool_tray/setup_dialog.py,sha256=1IOifQdrpGWuVd27P0XcMXBriCv9QkK_gMvnWfTKs5c,2301
+tool_tray/state.py,sha256=GEbXheWQeuw_IZGXBgccTxzP3jb_OEu-fh_o_4MrKQc,3079
+tool_tray/tray.py,sha256=RbXWfNbLpVqIhrVRDRr2RXimwsZ6f-CwpzxZnN7qpOM,11910
+tool_tray/updater.py,sha256=4yA1nvV2UKKY4POk_lPegpeXUhXsWVCXRHr5V-2DAjs,4354
+tool_tray-0.3.8.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+tool_tray-0.3.8.dist-info/entry_points.txt,sha256=8tdG3k77qXzGiU9GunLH2EkNwmiBg8dy2MnvMy5NaCA,45
+tool_tray-0.3.8.dist-info/METADATA,sha256=HpRnjUmUahSzHZZV5yPZRu-nJZwNqXxgr9g4kET6P8A,4382
+tool_tray-0.3.8.dist-info/RECORD,,

tool_tray-0.3.8.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.26
+Root-Is-Purelib: true
+Tag: py3-none-any

tool_tray-0.3.8.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+tooltray = tool_tray:main
+