s3ui 1.0.0__py3-none-any.whl

s3ui/ui/transfer_panel.py

@@ -0,0 +1,153 @@
+"""Transfer panel widget for the bottom dock."""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING
+
+from PyQt6.QtCore import Qt, pyqtSignal
+from PyQt6.QtWidgets import (
+    QAbstractItemView,
+    QHBoxLayout,
+    QHeaderView,
+    QLabel,
+    QPushButton,
+    QTableView,
+    QVBoxLayout,
+    QWidget,
+)
+
+from s3ui.models.transfer_model import TransferModel
+
+if TYPE_CHECKING:
+    from s3ui.core.transfers import TransferEngine
+    from s3ui.db.database import Database
+
+logger = logging.getLogger("s3ui.transfer_panel")
+
+
+class TransferPanelWidget(QWidget):
+    """Panel showing active and completed transfers."""
+
+    pause_requested = pyqtSignal(int)  # transfer_id
+    resume_requested = pyqtSignal(int)  # transfer_id
+    cancel_requested = pyqtSignal(int)  # transfer_id
+    retry_requested = pyqtSignal(int)  # transfer_id
+
+    def __init__(self, db: Database | None = None, parent=None) -> None:
+        super().__init__(parent)
+        self._db = db
+        self._engine: TransferEngine | None = None
+        self._paused_global = False
+
+        self._setup_ui()
+
+    def _setup_ui(self) -> None:
+        layout = QVBoxLayout(self)
+        layout.setContentsMargins(0, 0, 0, 0)
+        layout.setSpacing(0)
+
+        # Header bar
+        header = QHBoxLayout()
+        header.setContentsMargins(8, 4, 8, 4)
+        self._header_label = QLabel("Transfers")
+        header.addWidget(self._header_label)
+        header.addStretch()
+
+        self._pause_all_btn = QPushButton("Pause All")
+        self._pause_all_btn.clicked.connect(self._on_pause_all)
+        header.addWidget(self._pause_all_btn)
+
+        header_widget = QWidget()
+        header_widget.setLayout(header)
+        layout.addWidget(header_widget)
+
+        # Transfer table
+        self._model = TransferModel(self._db)
+        self._table = QTableView()
+        self._table.setModel(self._model)
+        self._table.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
+        self._table.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows)
+        self._table.setShowGrid(False)
+        self._table.setAlternatingRowColors(True)
+        self._table.verticalHeader().setVisible(False)
+        self._table.horizontalHeader().setStretchLastSection(True)
+        self._table.horizontalHeader().setSectionResizeMode(1, QHeaderView.ResizeMode.Stretch)
+        # Direction column narrow
+        self._table.setColumnWidth(0, 30)
+        self._table.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
+        self._table.customContextMenuRequested.connect(self._on_context_menu)
+        layout.addWidget(self._table)
+
+    @property
+    def model(self) -> TransferModel:
+        return self._model
+
+    def set_engine(self, engine: TransferEngine) -> None:
+        """Wire the transfer engine signals to the model."""
+        self._engine = engine
+        engine.transfer_progress.connect(self._model.on_progress)
+        engine.transfer_speed.connect(self._model.on_speed)
+        engine.transfer_status_changed.connect(self._model.on_status_changed)
+        engine.transfer_error.connect(self._model.on_error)
+        engine.transfer_finished.connect(self._model.on_finished)
+
+    def add_transfer(self, transfer_id: int) -> None:
+        """Add a transfer to the panel."""
+        self._model.add_transfer(transfer_id)
+        self._update_header()
+
+    def _update_header(self) -> None:
+        active = self._model.active_count()
+        queued = self._model.queued_count()
+        parts = []
+        if active:
+            parts.append(f"{active} active")
+        if queued:
+            parts.append(f"{queued} queued")
+        if parts:
+            self._header_label.setText(f"Transfers ({', '.join(parts)})")
+        else:
+            self._header_label.setText("Transfers")
+
+    def _on_pause_all(self) -> None:
+        if not self._engine:
+            return
+        if self._paused_global:
+            self._engine.resume_all()
+            self._pause_all_btn.setText("Pause All")
+            self._paused_global = False
+        else:
+            self._engine.pause_all()
+            self._pause_all_btn.setText("Resume All")
+            self._paused_global = True
+
+    def _on_context_menu(self, pos) -> None:
+        from PyQt6.QtWidgets import QMenu
+
+        index = self._table.indexAt(pos)
+        if not index.isValid():
+            return
+
+        row_data = self._model.get_transfer_row(self._model._rows[index.row()].transfer_id)
+        if not row_data:
+            return
+
+        menu = QMenu(self)
+        tid = row_data.transfer_id
+
+        if row_data.status == "in_progress":
+            pause_action = menu.addAction("Pause")
+            pause_action.triggered.connect(lambda: self.pause_requested.emit(tid))
+        elif row_data.status == "paused":
+            resume_action = menu.addAction("Resume")
+            resume_action.triggered.connect(lambda: self.resume_requested.emit(tid))
+        elif row_data.status == "failed":
+            retry_action = menu.addAction("Retry")
+            retry_action.triggered.connect(lambda: self.retry_requested.emit(tid))
+
+        if row_data.status in ("queued", "in_progress", "paused"):
+            cancel_action = menu.addAction("Cancel")
+            cancel_action.triggered.connect(lambda: self.cancel_requested.emit(tid))
+
+        menu.exec(self._table.viewport().mapToGlobal(pos))

s3ui-1.0.0.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: s3ui
+Version: 1.0.0
+Summary: A native file manager for Amazon S3
+Project-URL: Homepage, https://github.com/justinGrosvenor/s3ui
+Project-URL: Documentation, https://github.com/justinGrosvenor/s3ui/tree/main/docs
+Project-URL: Repository, https://github.com/justinGrosvenor/s3ui
+Project-URL: Issues, https://github.com/justinGrosvenor/s3ui/issues
+Author: S3UI Contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aws,desktop,file-manager,pyqt6,s3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Desktop Environment :: File Managers
+Classifier: Topic :: System :: Archiving
+Requires-Python: >=3.11
+Requires-Dist: boto3>=1.28
+Requires-Dist: keyring>=24.0
+Requires-Dist: pyqt6>=6.5
+Provides-Extra: dev
+Requires-Dist: moto[s3]>=4.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0; extra == 'dev'
+Requires-Dist: pyinstaller>=6.0; extra == 'dev'
+Requires-Dist: pytest-qt>=4.2; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="s3ui.png" alt="S3UI" width="128">
+</p>
+
+<h1 align="center">S3UI</h1>
+
+<p align="center">
+A native desktop file manager for Amazon S3 and S3-compatible services.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/s3ui/"><img src="https://img.shields.io/pypi/v/s3ui" alt="PyPI"></a>
+  <a href="https://pypi.org/project/s3ui/"><img src="https://img.shields.io/pypi/pyversions/s3ui" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/justinGrosvenor/s3ui" alt="License"></a>
+</p>
+
+---
+
+S3UI is a free, open-source, cross-platform desktop app that makes Amazon S3 feel like a local file system. It provides a dual-pane file manager — local files on the left, S3 on the right — with drag-and-drop transfers, large-file handling, and built-in cost tracking.
+
+Works with **Amazon S3**, **MinIO**, and any S3-compatible storage.
+
+## Features
+
+- **Dual-pane browser** — local filesystem and S3 side by side
+- **Drag and drop** — drop files onto the S3 pane to upload
+- **Upload and download** — right-click context menus or drag and drop
+- **New folder** — toolbar button and context menu
+- **Multipart uploads** — large files are split and uploaded in parallel
+- **Resume support** — interrupted transfers pick up where they left off
+- **Transfer queue** — pause, resume, cancel, and retry individual transfers
+- **Cost tracking** — estimates your monthly S3 costs as you work
+- **AWS CLI profiles** — auto-discovers profiles from `~/.aws/config`
+- **Custom endpoints** — connect to MinIO, LocalStack, or any S3-compatible service
+- **Secure credentials** — stored in your OS keychain via `keyring`
+- **Setup wizard** — guided first-run configuration
+- **Keyboard shortcuts** — Ctrl+1/2 to switch panes, Ctrl+R to refresh, Ctrl+F to filter
+- **System notifications** — notifies on large transfer completion when the app is in the background
+
+## Install
+
+```
+pip install s3ui
+```
+
+Requires Python 3.11+ and a running display server (X11, Wayland, macOS, or Windows).
+
+## Quick start
+
+```
+s3ui
+```
+
+On first launch, the setup wizard walks you through connecting your AWS account or S3-compatible service. You can also configure connections later from **Settings**.
+
+### MinIO example
+
+In the setup wizard or Settings > Credentials > Add Profile:
+
+| Field | Value |
+|---|---|
+| Profile Name | `my-minio` |
+| Access Key ID | `minioadmin` |
+| Secret Access Key | `minioadmin` |
+| Region | `us-east-1` |
+| Endpoint URL | `http://localhost:9000` |
+
+## Development
+
+```bash
+git clone https://github.com/justinGrosvenor/s3ui.git
+cd s3ui
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+pytest
+```
+
+## License
+
+[MIT](LICENSE)

s3ui-1.0.0.dist-info/RECORD

@@ -0,0 +1,40 @@
+s3ui/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+s3ui/app.py,sha256=RyLMR08xHXWSjh7DdDC6545jw0EzMWpFIWT88dT82X8,1428
+s3ui/constants.py,sha256=qU8d6BpEvBnFDVRI4ktJRNDoOQPwmR2EK9KB5qbnCzU,998
+s3ui/logging_setup.py,sha256=B4wAfuuFqk6GZfad0ynueGofdX0nM32Mv1M6FbmFP48,596
+s3ui/main_window.py,sha256=Mu7Fh0dB9NR50UArkN4UOe6px9vaVuQoeB-EFhUxrPk,35756
+s3ui/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+s3ui/core/cost.py,sha256=iGe3OZx35XA5sqE3Ikul9TtlPnrv1G5-3gN19HokNoQ,7988
+s3ui/core/credentials.py,sha256=awCnOiuCJF0B5yosGPRkANfaXLJwlNkXz2m8HTlirT4,5858
+s3ui/core/download_worker.py,sha256=ypFUURMoSt7Ad43GNdIhglRNQc5J_I6qBNRXvm0nIyI,9233
+s3ui/core/errors.py,sha256=RfYkgTn5pUAg8Cnoq7wFlux3O86LuJtPbL736D-PpwA,3490
+s3ui/core/listing_cache.py,sha256=j4v6RtuPc5LN0LrpA_ktzWTIhknJgiCcpUp6-a4DHoI,6386
+s3ui/core/s3_client.py,sha256=eP9mC9XyYH6vfBcZlKYYOlcxp0xzsfA8SsA21CrceHw,13726
+s3ui/core/stats.py,sha256=N39DbEQQjOHWVQByARR2PxuBjnz12aN9lBSAyS6OfLM,4206
+s3ui/core/transfers.py,sha256=j52WB8Lh9_D7Q3pGp4c-nhrRZrrs_qzc7onZTGot21E,10300
+s3ui/core/upload_worker.py,sha256=JB9kn44Jl9SqpjXH7RzmOiT3g4zPNCFHjzsvfoAgNgU,11453
+s3ui/db/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+s3ui/db/database.py,sha256=Evb27RAjQ98BPJfIQ6wPW0e3RssQ5IcCqZBuy5ubbJg,5078
+s3ui/db/migrations/001_initial.sql,sha256=r6uzCaG4D-W3pDHP7sCD31XucPaVioTAP2MyRqLPlOo,4657
+s3ui/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+s3ui/models/s3_objects.py,sha256=r-ejl8sOYBL5HZrDEjWJmykIRbmttyqdlotiMck5y1s,9789
+s3ui/models/transfer_model.py,sha256=DcjwR1edLxKIfZgRlfGoKatBOkw6pAmSJZmj8SO0Up0,9166
+s3ui/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+s3ui/resources/s3ui.png,sha256=KR06DVDjEzwxOK900qnDEBzW4gbVkwbGfNHTsi8GETg,1260324
+s3ui/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+s3ui/ui/breadcrumb_bar.py,sha256=rPLcPE0PBpb7EBzAtMVnoH5s5ozwyiMQCzCIRDjCnRw,5082
+s3ui/ui/confirm_delete.py,sha256=w_UbOunh6ZWQIavyXzxIuBvuIDIrKkE_ep1HY7NrlTg,1655
+s3ui/ui/cost_dialog.py,sha256=UlDkOtu86Erl9Vb1UUS9aElLkWg38AyOn4Ibpo14TiY,5904
+s3ui/ui/get_info.py,sha256=S6jpnaoIhMSAsCZ999DFqpNpQJNWPi6g_3qPicXMzCs,1477
+s3ui/ui/local_pane.py,sha256=UXOB9PzeSRBGiS6myUvqrC0grH9r0OPRlgixTsra0uM,8127
+s3ui/ui/name_conflict.py,sha256=4v8i9fyFFUoY1j6806l8-AUiwsvzbOC5EmbNbMau9Qs,2116
+s3ui/ui/s3_pane.py,sha256=OIxcgRnxh6ucEGduHIX6_B9epzDy4ZWd1_Ave7uEpDQ,20438
+s3ui/ui/settings_dialog.py,sha256=7xUdSOYqy0hIVDIch6dRnKyB6srJohrXaPBY7SAAeg0,10828
+s3ui/ui/setup_wizard.py,sha256=x6d6xE0WxHepQ-9FbN_lql5nXono8600oss03jicQY4,17063
+s3ui/ui/stats_dialog.py,sha256=SNUi4mz_9fYgX27xpDL7OGIb_hf3-JmnWP8MLy7jqQc,5997
+s3ui/ui/transfer_panel.py,sha256=OYH8yxRdabU7pvyUvhz360Yyl9qAvS9bRcHte16dAS0,5398
+s3ui-1.0.0.dist-info/METADATA,sha256=dGRvuGeHYTToLtAw912VDcd-q8qG640AhGjgRFpGz3U,4260
+s3ui-1.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+s3ui-1.0.0.dist-info/entry_points.txt,sha256=QeGaHmKRofZDCm4oWvH3_8nhl8gKWw3SSyYoc7MfUTg,39
+s3ui-1.0.0.dist-info/licenses/LICENSE,sha256=w83Hvu4TWOszaK7RWJ8LgS7tWsBMVeQW3_EjG42nOP0,1078
+s3ui-1.0.0.dist-info/RECORD,,

s3ui-1.0.0.dist-info/WHEEL

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

s3ui-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+s3ui = s3ui.app:main

s3ui-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Justin Grosvenor
+
+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.