clipsy 1.5.0__py3-none-any.whl → 1.7.0__py3-none-any.whl

clipsy/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "1.5.0"
+__version__ = "1.7.0"
 __app_name__ = "Clipsy"

clipsy/__main__.py

@@ -1,11 +1,136 @@
+import argparse
 import logging
+import os
+import subprocess
 import sys
+from pathlib import Path
 
 from clipsy.config import LOG_PATH
 from clipsy.utils import ensure_dirs
 
+PLIST_NAME = "com.clipsy.app.plist"
+LAUNCHAGENT_DIR = Path.home() / "Library" / "LaunchAgents"
+PLIST_PATH = LAUNCHAGENT_DIR / PLIST_NAME
 
-def main():
+
+def get_clipsy_path() -> str:
+    """Get the path to the clipsy executable."""
+    import shutil
+
+    # Check if we're running from an installed location
+    clipsy_path = shutil.which("clipsy")
+    if clipsy_path:
+        return clipsy_path
+    # Fallback to current Python module
+    return f"{sys.executable} -m clipsy"
+
+
+def create_plist(clipsy_path: str) -> str:
+    """Generate the LaunchAgent plist content."""
+    data_dir = Path.home() / ".local" / "share" / "clipsy"
+    return f"""<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.clipsy.app</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>{clipsy_path}</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>{data_dir}/clipsy.log</string>
+    <key>StandardErrorPath</key>
+    <string>{data_dir}/clipsy.log</string>
+</dict>
+</plist>
+"""
+
+
+def install_launchagent() -> int:
+    """Install and start the LaunchAgent."""
+    ensure_dirs()
+
+    clipsy_path = get_clipsy_path()
+    print(f"Installing LaunchAgent for: {clipsy_path}")
+
+    # Create LaunchAgents directory if needed
+    LAUNCHAGENT_DIR.mkdir(parents=True, exist_ok=True)
+
+    # Unload existing if present
+    if PLIST_PATH.exists():
+        subprocess.run(
+            ["launchctl", "unload", str(PLIST_PATH)],
+            capture_output=True,
+        )
+
+    # Write plist
+    PLIST_PATH.write_text(create_plist(clipsy_path))
+    print(f"Created: {PLIST_PATH}")
+
+    # Load the agent
+    result = subprocess.run(
+        ["launchctl", "load", str(PLIST_PATH)],
+        capture_output=True,
+        text=True,
+    )
+
+    if result.returncode == 0:
+        print("Clipsy is now running in the background.")
+        print("It will start automatically on login.")
+        return 0
+    else:
+        print(f"Failed to load LaunchAgent: {result.stderr}")
+        return 1
+
+
+def uninstall_launchagent() -> int:
+    """Stop and remove the LaunchAgent."""
+    if not PLIST_PATH.exists():
+        print("LaunchAgent not installed.")
+        return 0
+
+    # Unload
+    subprocess.run(
+        ["launchctl", "unload", str(PLIST_PATH)],
+        capture_output=True,
+    )
+
+    # Remove plist
+    PLIST_PATH.unlink()
+    print("LaunchAgent uninstalled.")
+    print("Clipsy will no longer start on login.")
+    return 0
+
+
+def check_status() -> int:
+    """Check if Clipsy is running."""
+    result = subprocess.run(
+        ["launchctl", "list", "com.clipsy.app"],
+        capture_output=True,
+        text=True,
+    )
+
+    if result.returncode == 0:
+        print("Clipsy is running.")
+        if PLIST_PATH.exists():
+            print(f"LaunchAgent: {PLIST_PATH}")
+        return 0
+    else:
+        print("Clipsy is not running.")
+        if PLIST_PATH.exists():
+            print(f"LaunchAgent installed but not loaded: {PLIST_PATH}")
+        else:
+            print("LaunchAgent not installed. Run: clipsy install")
+        return 1
+
+
+def run_app():
+    """Run the Clipsy application."""
     ensure_dirs()
 
     logging.basicConfig(
@@ -18,9 +143,48 @@ def main():
     )
 
     from clipsy.app import ClipsyApp
+
     app = ClipsyApp()
     app.run()
 
 
+def main():
+    parser = argparse.ArgumentParser(
+        description="Clipsy - Clipboard history manager for macOS",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Commands:
+  (none)      Install and run as background service (default)
+  uninstall   Remove LaunchAgent
+  status      Check if Clipsy is running
+  run         Run in foreground (for debugging)
+
+Examples:
+  clipsy            # Install and start as background service
+  clipsy status     # Check if running
+  clipsy uninstall  # Stop and remove from login items
+  clipsy run        # Run in foreground (debugging)
+""",
+    )
+    parser.add_argument(
+        "command",
+        nargs="?",
+        choices=["uninstall", "status", "run"],
+        help="Command to run",
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "uninstall":
+        sys.exit(uninstall_launchagent())
+    elif args.command == "status":
+        sys.exit(check_status())
+    elif args.command == "run":
+        run_app()
+    else:
+        # Default: install and start as background service
+        sys.exit(install_launchagent())
+
+
 if __name__ == "__main__":
     main()

{clipsy-1.5.0.dist-info → clipsy-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clipsy
-Version: 1.5.0
+Version: 1.7.0
 Summary: Lightweight clipboard history manager for macOS
 Author-email: Brendan Conrad <brendan.conrad@gmail.com>
 License: MIT
@@ -59,10 +59,19 @@ A lightweight clipboard history manager for macOS. Runs as a menu bar icon — n
 
 ## Installation
 
-### Via pip (recommended)
+### Via pipx (recommended)
+
+```bash
+brew install pipx
+pipx install clipsy
+clipsy
+```
+
+### Via pip
 
 ```bash
 pip install clipsy
+clipsy
 ```
 
 ### From source
@@ -72,14 +81,12 @@ git clone https://github.com/brencon/clipsy.git
 cd clipsy
 python3 -m venv .venv
 .venv/bin/pip install -e .
+.venv/bin/clipsy
 ```
 
 ## Usage
 
-```bash
-# Run clipsy (a scissors icon appears in your menu bar)
-clipsy
-```
+After running `clipsy`, the app installs as a background service and starts automatically on login. A scissors icon (✂️) appears in your menu bar.
 
 Then just use your Mac normally. Every time you copy something, it shows up in the Clipsy menu:
 
@@ -102,19 +109,13 @@ Then just use your Mac normally. Every time you copy something, it shows up in t
 └── Quit Clipsy
 ```
 
-## Auto-Start on Login
-
-Run clipsy automatically when you log in — no terminal needed:
+## Commands
 
 ```bash
-# Install as a LaunchAgent
-scripts/install_launchagent.sh install
-
-# Check status
-scripts/install_launchagent.sh status
-
-# Remove auto-start
-scripts/install_launchagent.sh uninstall
+clipsy            # Install and start as background service (default)
+clipsy status     # Check if running
+clipsy uninstall  # Remove from login items
+clipsy run        # Run in foreground (for debugging)
 ```
 
 ## Data Storage

{clipsy-1.5.0.dist-info → clipsy-1.7.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-clipsy/__init__.py,sha256=RfTNMAT90hngQkclaI0i0rdsR5s2s2IFJWzExWhvwjU,46
-clipsy/__main__.py,sha256=vCWOKz08ZY3Uc5orHOMND0sEgBnyvD0WkD4o6b4_6Mw,493
+clipsy/__init__.py,sha256=5B_3MB6DYDXcJfVxDSzafJY1_-IM-eLcNadIWCMyJTc,46
+clipsy/__main__.py,sha256=Ipb_HlLKeG5TPKdaAd4FALgrvCX9PPw9TuMF1BH0AAQ,4962
 clipsy/app.py,sha256=_IKuZgA-DvAE3KDsDN00S0aaMIxwBpiv_P1fpzwQFqU,7299
 clipsy/config.py,sha256=E9NCsGMeT2H0YXYCq5xYwbd27VkksV4S9txZSMX0RmE,672
 clipsy/models.py,sha256=i3KjD4Dcp7y_gTXkIBr2xZxFIIC6kHaMWmv6cSIDABM,563
@@ -7,9 +7,9 @@ clipsy/monitor.py,sha256=UUKZToYcZ5pzu7LfiuJ_nnE4AA-d3uLW-WdQU_XrDME,6288
 clipsy/redact.py,sha256=EU2nq8oEDYLZ_I_9tX2bXACIF971a0V_ApKdvpN4VGY,7284
 clipsy/storage.py,sha256=QNox2-spkVx_gMPSWqKgF_yj-SMpRJ4UAT6yd9l6rVY,9794
 clipsy/utils.py,sha256=rztT20cXYJ7633q3oLwt6Fv0Ubq9hm5bPPKDkWyvxdI,2208
-clipsy-1.5.0.dist-info/licenses/LICENSE,sha256=bZ7uVihgPnLGryi5ugUgkVrEoho0_hFAd3bVdhYXGqs,1071
-clipsy-1.5.0.dist-info/METADATA,sha256=7lAWnXyqO69PZSLoFjOZKU1WuXaaykI0a3V-dUSRkUE,5693
-clipsy-1.5.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-clipsy-1.5.0.dist-info/entry_points.txt,sha256=ISIoWU3Zj-4NEuj2pJW96LxpsvjRJJH73otv9gA9YSs,48
-clipsy-1.5.0.dist-info/top_level.txt,sha256=trxprVJk4ZMudCshc7PD0N9iFgQO4Tq4sW5L5wLduns,7
-clipsy-1.5.0.dist-info/RECORD,,
+clipsy-1.7.0.dist-info/licenses/LICENSE,sha256=bZ7uVihgPnLGryi5ugUgkVrEoho0_hFAd3bVdhYXGqs,1071
+clipsy-1.7.0.dist-info/METADATA,sha256=xO1ksDaZw867EM92OS3AsH8yakCtH1doeytarvNCAtQ,5811
+clipsy-1.7.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clipsy-1.7.0.dist-info/entry_points.txt,sha256=ISIoWU3Zj-4NEuj2pJW96LxpsvjRJJH73otv9gA9YSs,48
+clipsy-1.7.0.dist-info/top_level.txt,sha256=trxprVJk4ZMudCshc7PD0N9iFgQO4Tq4sW5L5wLduns,7
+clipsy-1.7.0.dist-info/RECORD,,