cloudhop 0.6.0__tar.gz

cloudhop-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Husam Soboh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cloudhop-0.6.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: cloudhop
+Version: 0.6.0
+Summary: The easiest way to copy files between cloud storage services
+Author: Husam Soboh
+License: MIT
+Project-URL: Homepage, https://github.com/husamsoboh-cyber/cloudhop
+Project-URL: Issues, https://github.com/husamsoboh-cyber/cloudhop/issues
+Keywords: cloud,file-transfer,rclone,google-drive,onedrive,dropbox,icloud
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/cloudhop.svg)](https://pypi.org/project/cloudhop/)
+[![GitHub stars](https://img.shields.io/github/stars/husamsoboh-cyber/cloudhop.svg?style=social)](https://github.com/husamsoboh-cyber/cloudhop)
+
+# CloudHop - Free Cloud File Transfer
+
+**Switching cloud providers? CloudHop copies everything for you. Free, open source, runs on your machine.**
+
+![CloudHop Dashboard](screenshots/dashboard.png)
+
+## Download / Install
+
+**Mac** - Download `CloudHop.dmg` from [Releases](https://github.com/husamsoboh-cyber/cloudhop/releases)
+
+**Windows** - Download `CloudHop-Setup.exe` from [Releases](https://github.com/husamsoboh-cyber/cloudhop/releases)
+
+**pip**
+```bash
+pip install cloudhop && cloudhop
+```
+
+**From source**
+```bash
+git clone https://github.com/husamsoboh-cyber/cloudhop && cd cloudhop && pip install -e . && cloudhop
+```
+
+## Why CloudHop?
+
+- **Free and open source** -- no limits, no account needed
+- **Runs on your machine** -- files never touch our servers
+- **Works with 70+ cloud providers** -- Google Drive, OneDrive, Dropbox, iCloud, MEGA, S3, Proton Drive...
+- **Visual wizard** -- no command line needed
+- **Pause and resume** across restarts
+
+## How is this different from...
+
+**rclone?**
+CloudHop uses rclone as its engine. If you're comfortable with CLI, you don't need this. CloudHop adds a visual wizard and live dashboard.
+
+**MultCloud / CloudFuze?**
+Those are paid SaaS that route files through their servers. CloudHop is free and your files transfer directly between providers.
+
+**Download and re-upload?**
+That requires local disk space and 2x transfer time. CloudHop uses server-side copy where supported.
+
+## How it works
+
+1. **Run CloudHop** -- launch the app or run `cloudhop` in a terminal
+2. **Pick source** -- choose where your files are (e.g., OneDrive)
+3. **Pick destination** -- choose where to copy them (e.g., Google Drive)
+4. **Configure options** -- set parallel transfers, exclude folders, limit bandwidth
+5. **Connect accounts** -- authorize each cloud provider in your browser
+6. **Start transfer** -- watch progress in the live dashboard with speed charts and ETA
+
+## CLI Usage
+
+```bash
+cloudhop source: dest: [--transfers=8] [--bwlimit=10M] [--exclude="*.tmp"]
+```
+
+## Supported Providers
+
+Google Drive, OneDrive, Dropbox, iCloud Drive, MEGA, Amazon S3, Proton Drive, Local Folder + 70 more via rclone
+
+## Links
+
+[Security](SECURITY.md) | [Contributing](CONTRIBUTING.md) | [Changelog](CHANGELOG.md)
+
+## Built by
+
+Built by an orthodontist who needed to move 500GB between cloud services and found no free, simple tool to do it.
+
+## Donate
+
+If CloudHop saved you time, consider supporting development:
+
+[GitHub Sponsors](https://github.com/sponsors/husamsoboh-cyber) | [Buy Me a Coffee](https://buymeacoffee.com/husamsoboh)
+
+## License
+
+MIT License -- see [LICENSE](LICENSE) for details.

cloudhop-0.6.0/README.md

@@ -0,0 +1,82 @@
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/cloudhop.svg)](https://pypi.org/project/cloudhop/)
+[![GitHub stars](https://img.shields.io/github/stars/husamsoboh-cyber/cloudhop.svg?style=social)](https://github.com/husamsoboh-cyber/cloudhop)
+
+# CloudHop - Free Cloud File Transfer
+
+**Switching cloud providers? CloudHop copies everything for you. Free, open source, runs on your machine.**
+
+![CloudHop Dashboard](screenshots/dashboard.png)
+
+## Download / Install
+
+**Mac** - Download `CloudHop.dmg` from [Releases](https://github.com/husamsoboh-cyber/cloudhop/releases)
+
+**Windows** - Download `CloudHop-Setup.exe` from [Releases](https://github.com/husamsoboh-cyber/cloudhop/releases)
+
+**pip**
+```bash
+pip install cloudhop && cloudhop
+```
+
+**From source**
+```bash
+git clone https://github.com/husamsoboh-cyber/cloudhop && cd cloudhop && pip install -e . && cloudhop
+```
+
+## Why CloudHop?
+
+- **Free and open source** -- no limits, no account needed
+- **Runs on your machine** -- files never touch our servers
+- **Works with 70+ cloud providers** -- Google Drive, OneDrive, Dropbox, iCloud, MEGA, S3, Proton Drive...
+- **Visual wizard** -- no command line needed
+- **Pause and resume** across restarts
+
+## How is this different from...
+
+**rclone?**
+CloudHop uses rclone as its engine. If you're comfortable with CLI, you don't need this. CloudHop adds a visual wizard and live dashboard.
+
+**MultCloud / CloudFuze?**
+Those are paid SaaS that route files through their servers. CloudHop is free and your files transfer directly between providers.
+
+**Download and re-upload?**
+That requires local disk space and 2x transfer time. CloudHop uses server-side copy where supported.
+
+## How it works
+
+1. **Run CloudHop** -- launch the app or run `cloudhop` in a terminal
+2. **Pick source** -- choose where your files are (e.g., OneDrive)
+3. **Pick destination** -- choose where to copy them (e.g., Google Drive)
+4. **Configure options** -- set parallel transfers, exclude folders, limit bandwidth
+5. **Connect accounts** -- authorize each cloud provider in your browser
+6. **Start transfer** -- watch progress in the live dashboard with speed charts and ETA
+
+## CLI Usage
+
+```bash
+cloudhop source: dest: [--transfers=8] [--bwlimit=10M] [--exclude="*.tmp"]
+```
+
+## Supported Providers
+
+Google Drive, OneDrive, Dropbox, iCloud Drive, MEGA, Amazon S3, Proton Drive, Local Folder + 70 more via rclone
+
+## Links
+
+[Security](SECURITY.md) | [Contributing](CONTRIBUTING.md) | [Changelog](CHANGELOG.md)
+
+## Built by
+
+Built by an orthodontist who needed to move 500GB between cloud services and found no free, simple tool to do it.
+
+## Donate
+
+If CloudHop saved you time, consider supporting development:
+
+[GitHub Sponsors](https://github.com/sponsors/husamsoboh-cyber) | [Buy Me a Coffee](https://buymeacoffee.com/husamsoboh)
+
+## License
+
+MIT License -- see [LICENSE](LICENSE) for details.

cloudhop-0.6.0/cloudhop/__init__.py

@@ -0,0 +1,2 @@
+"""CloudHop - The easiest way to copy files between cloud storage services."""
+__version__ = "0.6.0"

cloudhop-0.6.0/cloudhop/__main__.py

@@ -0,0 +1,4 @@
+"""Entry point for python -m cloudhop."""
+from .cli import main
+
+main()

cloudhop-0.6.0/cloudhop/cli.py

@@ -0,0 +1,200 @@
+"""CloudHop CLI entry point."""
+import sys
+import signal
+import platform
+import webbrowser
+import threading
+import http.server
+from typing import Any, List
+
+from .server import CloudHopHandler
+from .transfer import TransferManager, ensure_rclone
+from .utils import PORT
+
+
+def main() -> None:
+    """Main entry point -- wizard mode (no args) or CLI mode (source dest [flags])."""
+    args = sys.argv[1:]
+    manager = TransferManager()
+    CloudHopHandler.manager = manager
+
+    signal.signal(signal.SIGTERM, lambda signum, frame: _signal_handler(manager))
+
+    if len(args) == 0:
+        # Web wizard mode
+        print()
+        print("  +==================================================+")
+        print("  |               Welcome to CloudHop                |")
+        print("  |                                                   |")
+        print("  |   Starting web setup wizard...                    |")
+        print("  +==================================================+")
+        if platform.system() == "Windows":
+            print("  Note: Some features (pause/resume) may not work on Windows.")
+            print("  For best results, use macOS or Linux.")
+            print()
+        start_dashboard(manager, start_rclone=False)
+    else:
+        # CLI mode for advanced users
+        ensure_rclone()
+        parse_cli_args(manager, args)
+        print()
+        if manager.rclone_pid and not manager.rclone_cmd:
+            # Attach mode - monitoring existing process
+            print(f"  CloudHop - Monitoring PID {manager.rclone_pid}")
+            print(f"  Log: {manager.log_file}")
+            start_dashboard(manager, start_rclone=False)
+        else:
+            print("  CloudHop - Advanced Mode")
+            print(f"  Command: {' '.join(manager.rclone_cmd)}")
+            start_dashboard(manager, start_rclone=True)
+
+
+def start_dashboard(manager: TransferManager, start_rclone: bool = False) -> None:
+    """Start the web dashboard and optionally the rclone process."""
+    import subprocess
+
+    # Load RCLONE_CMD from state if not set (enables resume after restart)
+    if not manager.rclone_cmd and "rclone_cmd" in manager.state:
+        manager.rclone_cmd = manager.state["rclone_cmd"]
+        # Restore LOG_FILE from the saved command
+        for arg in manager.rclone_cmd:
+            if arg.startswith("--log-file="):
+                manager.log_file = arg.split("=", 1)[1]
+                break
+
+    # Initial full log scan
+    print()
+    print("  Scanning transfer log...")
+    manager.scan_full_log()
+    session_count = len(manager.state.get("sessions", []))
+    if session_count > 0:
+        print(f"  Found {session_count} previous session(s)")
+
+    # Start background scanner
+    scanner = threading.Thread(target=manager.background_scanner, daemon=True)
+    scanner.start()
+
+    # Start rclone if requested
+    if start_rclone and manager.rclone_cmd:
+        print("  Starting file transfer...")
+        proc = subprocess.Popen(
+            manager.rclone_cmd,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            start_new_session=True,
+        )
+        manager.rclone_pid = proc.pid
+        print(f"  Transfer started (PID {proc.pid})")
+        manager.transfer_active = True
+
+    port = PORT
+
+    print()
+    print(f"  CloudHop: http://localhost:{port}")
+    print()
+    if manager.transfer_active:
+        print("  Open the link above in your browser to monitor progress.")
+    else:
+        print("  Open the link above in your browser to start the setup wizard.")
+    print("  Press Ctrl+C to stop the server.")
+    print()
+
+    server = None
+    for try_port in range(port, port + 5):
+        try:
+            server = http.server.ThreadingHTTPServer(("127.0.0.1", try_port), CloudHopHandler)
+            if try_port != port:
+                print(f"  Port {port} was busy, using port {try_port} instead.")
+                port = try_port
+            CloudHopHandler.actual_port = port
+            break
+        except OSError as e:
+            if ("Address already in use" in str(e) or e.errno == 48) and try_port < port + 4:
+                continue
+            if "Address already in use" in str(e) or e.errno == 48:
+                print(f"\n  Error: Ports {port}-{port + 4} are all in use.")
+                print("  Please stop the other process(es) and try again.\n")
+                sys.exit(1)
+            raise
+
+    if server is None:
+        print(f"\n  Error: Could not bind to any port in range {port}-{port + 4}.\n")
+        sys.exit(1)
+
+    # Try to open browser automatically (after port binding succeeds)
+    try:
+        webbrowser.open(f"http://localhost:{port}")
+    except Exception:
+        pass
+
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        _signal_handler(manager)
+
+
+def parse_cli_args(manager: TransferManager, args: List[str]) -> None:
+    """Parse CLI arguments for advanced usage: cloudhop source: dest: [flags]"""
+    source = None
+    dest = None
+    extra_flags = []
+    attach_pid = None
+    attach_log = None
+
+    for arg in args:
+        if arg.startswith("--attach-pid="):
+            try:
+                attach_pid = int(arg.split("=", 1)[1])
+            except ValueError:
+                print(f"  Error: --attach-pid requires a numeric PID")
+                sys.exit(1)
+        elif arg.startswith("--attach-log="):
+            attach_log = arg.split("=", 1)[1]
+        elif arg.startswith("--"):
+            extra_flags.append(arg)
+        elif source is None:
+            source = arg
+        elif dest is None:
+            dest = arg
+        else:
+            extra_flags.append(arg)
+
+    if not source or not dest:
+        print("Usage: cloudhop <source> <destination> [--flags]")
+        print("Example: cloudhop onedrive: gdrive:backup --transfers=8")
+        print()
+        print("Or just run without arguments for the interactive wizard:")
+        print("  cloudhop")
+        sys.exit(1)
+
+    manager.set_transfer_paths(source, dest)
+
+    # Attach to an existing rclone process instead of starting a new one
+    if attach_pid:
+        manager.rclone_pid = attach_pid
+        manager.transfer_active = True
+        if attach_log:
+            manager.log_file = attach_log
+        return
+
+    manager.rclone_cmd = [
+        "rclone", "copy", source, dest,
+        f"--log-file={manager.log_file}",
+        "--log-level=INFO",
+        "--stats=10s",
+        "--stats-log-level=INFO",
+    ] + extra_flags
+
+    # Add default transfers if not specified
+    if not any(f.startswith("--transfers") for f in extra_flags):
+        manager.rclone_cmd.append("--transfers=8")
+    if not any(f.startswith("--checkers") for f in extra_flags):
+        manager.rclone_cmd.append("--checkers=16")
+
+
+def _signal_handler(manager: TransferManager) -> None:
+    print("\n  CloudHop stopped.")
+    if manager.transfer_active:
+        print("  (The file transfer continues in the background)")
+    print()
+    sys.exit(0)