mailbench 0.3.4__tar.gz

mailbench-0.3.4/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

mailbench-0.3.4/.gitignore

@@ -0,0 +1,40 @@
+# Virtual environment
+venv/
+.venv/
+env/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+eggs/
+*.egg-info/
+*.egg
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Local data
+*.db
+*.sqlite
+*.sqlite3
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Distribution
+*.tar.gz
+*.whl

mailbench-0.3.4/LICENSE

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

mailbench-0.3.4/Makefile

@@ -0,0 +1,20 @@
+.PHONY: run install clean
+
+VENV := venv
+PYTHON := $(VENV)/bin/python
+PIP := $(VENV)/bin/pip
+
+run: $(VENV)
+	$(PYTHON) -m mailbench
+
+install: $(VENV)
+
+$(VENV): requirements.txt
+	python3 -m venv $(VENV)
+	$(PIP) install -r requirements.txt
+	touch $(VENV)
+
+clean:
+	rm -rf $(VENV)
+	rm -f mailbench/mailbench.db
+	find . -type d -name __pycache__ -exec rm -rf {} +

mailbench-0.3.4/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: mailbench
+Version: 0.3.4
+Summary: A Python email client for Kerio Connect
+Project-URL: Homepage, https://github.com/jpsteil/mailbench
+Project-URL: Repository, https://github.com/jpsteil/mailbench
+Project-URL: Issues, https://github.com/jpsteil/mailbench/issues
+Author: Jim
+License-Expression: MIT
+License-File: LICENSE
+Keywords: client,email,gui,kerio,mail
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Communications :: Email :: Email Clients (MUA)
+Requires-Python: >=3.10
+Requires-Dist: pyside6>=6.5
+Requires-Dist: requests>=2.28
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: keyring
+Requires-Dist: keyring>=24.0.0; extra == 'keyring'
+Description-Content-Type: text/markdown
+
+# Mailbench
+
+A desktop email client for Kerio Connect mail servers, built with Python and Tkinter.
+
+## Features
+
+- **Multi-account support** - Connect to multiple Kerio Connect servers
+- **3-pane layout** - Folders, message list, and preview pane
+- **Dark/light themes** - Toggle between themes with Ctrl+D
+- **Compose, Reply, Forward** - Full email composition with HTML support
+- **Attachments** - View, download, and attach files
+- **Address book integration** - Autocomplete from Kerio contacts and cached addresses
+- **Local caching** - SQLite database for offline message access
+- **Keyboard shortcuts** - Efficient navigation and actions
+- **Zoom support** - Ctrl+scroll to adjust preview size
+
+## Requirements
+
+- Python 3.10+
+- Kerio Connect mail server with JSON-RPC API access
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/jpsteil/mailbench.git
+cd mailbench
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -e .
+```
+
+## Usage
+
+```bash
+mailbench
+```
+
+On first run, go to **Accounts > Add Account** to configure your Kerio Connect server.
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| Ctrl+N | New message |
+| Ctrl+R | Reply |
+| Ctrl+Shift+R | Reply All |
+| Ctrl+F | Forward |
+| Ctrl+D | Toggle dark mode |
+| Ctrl+Scroll | Zoom preview |
+| Delete | Delete message |
+| Escape | Clear filter / Discard compose |
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.

mailbench-0.3.4/README.md

@@ -0,0 +1,60 @@
+# Mailbench
+
+A desktop email client for Kerio Connect mail servers, built with Python and Tkinter.
+
+## Features
+
+- **Multi-account support** - Connect to multiple Kerio Connect servers
+- **3-pane layout** - Folders, message list, and preview pane
+- **Dark/light themes** - Toggle between themes with Ctrl+D
+- **Compose, Reply, Forward** - Full email composition with HTML support
+- **Attachments** - View, download, and attach files
+- **Address book integration** - Autocomplete from Kerio contacts and cached addresses
+- **Local caching** - SQLite database for offline message access
+- **Keyboard shortcuts** - Efficient navigation and actions
+- **Zoom support** - Ctrl+scroll to adjust preview size
+
+## Requirements
+
+- Python 3.10+
+- Kerio Connect mail server with JSON-RPC API access
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/jpsteil/mailbench.git
+cd mailbench
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -e .
+```
+
+## Usage
+
+```bash
+mailbench
+```
+
+On first run, go to **Accounts > Add Account** to configure your Kerio Connect server.
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| Ctrl+N | New message |
+| Ctrl+R | Reply |
+| Ctrl+Shift+R | Reply All |
+| Ctrl+F | Forward |
+| Ctrl+D | Toggle dark mode |
+| Ctrl+Scroll | Zoom preview |
+| Delete | Delete message |
+| Escape | Clear filter / Discard compose |
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file.

mailbench-0.3.4/mailbench/__init__.py

@@ -0,0 +1,3 @@
+"""Mailbench - A Python email client for Kerio Connect."""
+
+__version__ = "0.1.0"

mailbench-0.3.4/mailbench/__main__.py

@@ -0,0 +1,76 @@
+"""Entry point for mailbench."""
+
+import sys
+
+
+def check_pyside6():
+    """Check if PySide6 is available and provide installation instructions if not."""
+    try:
+        import PySide6
+        return True
+    except ImportError:
+        pass
+
+    import platform
+    system = platform.system().lower()
+
+    print("Error: PySide6 is not installed.")
+    print()
+    print("Mailbench requires PySide6 for its graphical interface.")
+    print()
+
+    if system == "linux":
+        print("To install PySide6:")
+        print("  pip install PySide6")
+    elif system == "darwin":
+        print("To install on macOS:")
+        print("  pip install PySide6")
+    elif system == "windows":
+        print("To install on Windows:")
+        print("  pip install PySide6")
+    else:
+        print("To install PySide6:")
+        print("  pip install PySide6")
+
+    print()
+    print("After installing, run mailbench again.")
+    return False
+
+
+def main():
+    """Main entry point with argument handling."""
+    if len(sys.argv) > 1:
+        arg = sys.argv[1].lower()
+
+        if arg in ("--install-launcher", "--create-launcher"):
+            from mailbench.launcher import create_launcher
+            success = create_launcher()
+            sys.exit(0 if success else 1)
+
+        elif arg in ("--remove-launcher", "--uninstall-launcher"):
+            from mailbench.launcher import remove_launcher
+            success = remove_launcher()
+            sys.exit(0 if success else 1)
+
+        elif arg in ("--help", "-h"):
+            print("Mailbench - Python Email Client for Kerio Connect")
+            print()
+            print("Usage: mailbench [options]")
+            print()
+            print("Options:")
+            print("  --install-launcher   Create a desktop launcher for this OS")
+            print("  --remove-launcher    Remove the desktop launcher")
+            print("  --help, -h           Show this help message")
+            print()
+            print("Run without arguments to start the application.")
+            sys.exit(0)
+
+    if not check_pyside6():
+        sys.exit(1)
+
+    from mailbench.app import main as app_main
+    app_main()
+
+
+if __name__ == "__main__":
+    main()