pytodo-qt 0.2.7__tar.gz → 0.3.8__tar.gz

pytodo_qt-0.3.8/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: pytodo-qt
+Version: 0.3.8
+Summary: A cross-platform to-do list manager with encrypted peer-to-peer synchronization
+Author-email: Michael Berry <trismegustis@gmail.com>
+License: GPLv3
+Project-URL: Homepage, https://github.com/berrym/pytodo-qt
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: COPYING
+Requires-Dist: PyQt6>=6.4
+Requires-Dist: cryptography>=41.0
+Requires-Dist: zeroconf>=0.80
+Requires-Dist: keyring>=24.0
+Requires-Dist: qasync>=0.24
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.2; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: basedpyright>=1.18; extra == "dev"
+Dynamic: license-file
+
+# pytodo-qt
+
+[![CI](https://github.com/berrym/pytodo-qt/actions/workflows/ci.yml/badge.svg)](https://github.com/berrym/pytodo-qt/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/berrym/pytodo-qt/graph/badge.svg)](https://codecov.io/gh/berrym/pytodo-qt)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+A cross-platform to-do list manager with encrypted peer-to-peer synchronization.
+
+## Features
+
+- **Multiple lists** - Organize tasks into separate lists
+- **Priority levels** - High, normal, and low priority with color coding
+- **Encrypted sync** - AES-256-GCM encryption with Ed25519 key exchange
+- **Auto-discovery** - Find other instances on your network via mDNS/Zeroconf
+- **Dark/light themes** - System-following or manual theme selection
+- **Cross-platform** - Linux, macOS, and Windows support
+
+## Requirements
+
+- Python 3.11 or later
+- PyQt6
+
+## Installation
+
+### Pre-built Binaries
+
+Download the latest release for your platform from the [Releases page](https://github.com/berrym/pytodo-qt/releases).
+
+#### macOS
+
+1. Download `pytodo-qt-VERSION-macos-arm64.zip` (Apple Silicon) or `pytodo-qt-VERSION-macos-x86_64.zip` (Intel)
+2. Extract the zip file
+3. Move `pytodo-qt.app` to `/Applications` or `~/Applications`
+4. **First run only:** Right-click the app and select "Open" to bypass Gatekeeper
+   - Alternatively, run: `xattr -rd com.apple.quarantine /Applications/pytodo-qt.app`
+5. After the first run, you can open normally by double-clicking
+
+> **Note:** The app is ad-hoc signed (not notarized with an Apple Developer ID), so macOS will show an "unidentified developer" warning on first launch. This is normal for open-source software distributed outside the App Store.
+
+#### Linux
+
+1. Download `pytodo-qt-VERSION-linux-x86_64.tar.gz` or `pytodo-qt-VERSION-linux-arm64.tar.gz`
+2. Extract: `tar -xzf pytodo-qt-VERSION-linux-*.tar.gz`
+3. Run the install script: `cd pytodo-qt-*/ && ./install.sh`
+4. Or run directly: `./pytodo-qt`
+
+The install script places the binary in `~/.local/bin/` and creates a desktop entry.
+
+To uninstall: `~/.local/lib/pytodo-qt/uninstall.sh` (or run `./uninstall.sh` from the extracted archive)
+
+#### Windows
+
+1. Download `pytodo-qt-VERSION-windows-x86_64.zip`
+2. Extract the zip file
+3. Run `pytodo-qt.exe`
+
+### From PyPI
+
+```bash
+pipx install pytodo-qt    # recommended
+pip install pytodo-qt     # alternative
+```
+
+### From source
+
+```bash
+git clone https://github.com/berrym/pytodo-qt.git
+cd pytodo-qt
+pip install .
+```
+
+### Development install
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Usage
+
+```bash
+pytodo-qt
+```
+
+### Command-line options
+
+```
+Server Options:
+  -s, --server {yes,no}    enable/disable network server
+  --pull {yes,no}          allow remote pull requests
+  --push {yes,no}          allow remote push requests
+  -i, --ip IP              server bind address
+  -p, --port PORT          server port
+
+Discovery Options:
+  -d, --discovery {yes,no} enable/disable mDNS discovery
+
+Appearance Options:
+  -t, --theme {light,dark,system}
+```
+
+## Configuration
+
+Configuration is stored in XDG-compliant locations:
+
+| Platform | Config | Data |
+|----------|--------|------|
+| Linux | `~/.config/pytodo-qt/` | `~/.local/share/pytodo-qt/` |
+| macOS | `~/Library/Application Support/pytodo-qt/` | same |
+| Windows | `%APPDATA%\pytodo-qt\` | same |
+
+### config.toml
+
+```toml
+[database]
+active_list = ""
+sort_key = "priority"
+reverse_sort = false
+
+[server]
+enabled = true
+address = "0.0.0.0"
+port = 5364
+allow_pull = true
+allow_push = true
+
+[discovery]
+enabled = true
+service_name = ""  # defaults to pytodo-{hostname}
+
+[appearance]
+theme = "system"  # light, dark, system
+```
+
+## Synchronization
+
+pytodo-qt uses a secure peer-to-peer protocol for syncing between instances:
+
+1. **Discovery** - Instances advertise themselves via mDNS (`_pytodo._tcp.local.`)
+2. **Key exchange** - Ed25519 identity keys with X25519 ephemeral session keys
+3. **Encryption** - All data encrypted with AES-256-GCM
+4. **Merge** - Last-write-wins conflict resolution with UUID-based items
+
+Identity keys are stored in your system keyring (GNOME Keyring, macOS Keychain, Windows Credential Locker).
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint and format
+ruff check src/ tests/
+ruff format src/ tests/
+
+# Type check
+basedpyright src/
+```
+
+## License
+
+GPLv3 or later. See [COPYING](COPYING) for details.
+
+Copyright 2024 Michael Berry <trismegustis@gmail.com>

pytodo_qt-0.3.8/README.md

@@ -0,0 +1,169 @@
+# pytodo-qt
+
+[![CI](https://github.com/berrym/pytodo-qt/actions/workflows/ci.yml/badge.svg)](https://github.com/berrym/pytodo-qt/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/berrym/pytodo-qt/graph/badge.svg)](https://codecov.io/gh/berrym/pytodo-qt)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+A cross-platform to-do list manager with encrypted peer-to-peer synchronization.
+
+## Features
+
+- **Multiple lists** - Organize tasks into separate lists
+- **Priority levels** - High, normal, and low priority with color coding
+- **Encrypted sync** - AES-256-GCM encryption with Ed25519 key exchange
+- **Auto-discovery** - Find other instances on your network via mDNS/Zeroconf
+- **Dark/light themes** - System-following or manual theme selection
+- **Cross-platform** - Linux, macOS, and Windows support
+
+## Requirements
+
+- Python 3.11 or later
+- PyQt6
+
+## Installation
+
+### Pre-built Binaries
+
+Download the latest release for your platform from the [Releases page](https://github.com/berrym/pytodo-qt/releases).
+
+#### macOS
+
+1. Download `pytodo-qt-VERSION-macos-arm64.zip` (Apple Silicon) or `pytodo-qt-VERSION-macos-x86_64.zip` (Intel)
+2. Extract the zip file
+3. Move `pytodo-qt.app` to `/Applications` or `~/Applications`
+4. **First run only:** Right-click the app and select "Open" to bypass Gatekeeper
+   - Alternatively, run: `xattr -rd com.apple.quarantine /Applications/pytodo-qt.app`
+5. After the first run, you can open normally by double-clicking
+
+> **Note:** The app is ad-hoc signed (not notarized with an Apple Developer ID), so macOS will show an "unidentified developer" warning on first launch. This is normal for open-source software distributed outside the App Store.
+
+#### Linux
+
+1. Download `pytodo-qt-VERSION-linux-x86_64.tar.gz` or `pytodo-qt-VERSION-linux-arm64.tar.gz`
+2. Extract: `tar -xzf pytodo-qt-VERSION-linux-*.tar.gz`
+3. Run the install script: `cd pytodo-qt-*/ && ./install.sh`
+4. Or run directly: `./pytodo-qt`
+
+The install script places the binary in `~/.local/bin/` and creates a desktop entry.
+
+To uninstall: `~/.local/lib/pytodo-qt/uninstall.sh` (or run `./uninstall.sh` from the extracted archive)
+
+#### Windows
+
+1. Download `pytodo-qt-VERSION-windows-x86_64.zip`
+2. Extract the zip file
+3. Run `pytodo-qt.exe`
+
+### From PyPI
+
+```bash
+pipx install pytodo-qt    # recommended
+pip install pytodo-qt     # alternative
+```
+
+### From source
+
+```bash
+git clone https://github.com/berrym/pytodo-qt.git
+cd pytodo-qt
+pip install .
+```
+
+### Development install
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Usage
+
+```bash
+pytodo-qt
+```
+
+### Command-line options
+
+```
+Server Options:
+  -s, --server {yes,no}    enable/disable network server
+  --pull {yes,no}          allow remote pull requests
+  --push {yes,no}          allow remote push requests
+  -i, --ip IP              server bind address
+  -p, --port PORT          server port
+
+Discovery Options:
+  -d, --discovery {yes,no} enable/disable mDNS discovery
+
+Appearance Options:
+  -t, --theme {light,dark,system}
+```
+
+## Configuration
+
+Configuration is stored in XDG-compliant locations:
+
+| Platform | Config | Data |
+|----------|--------|------|
+| Linux | `~/.config/pytodo-qt/` | `~/.local/share/pytodo-qt/` |
+| macOS | `~/Library/Application Support/pytodo-qt/` | same |
+| Windows | `%APPDATA%\pytodo-qt\` | same |
+
+### config.toml
+
+```toml
+[database]
+active_list = ""
+sort_key = "priority"
+reverse_sort = false
+
+[server]
+enabled = true
+address = "0.0.0.0"
+port = 5364
+allow_pull = true
+allow_push = true
+
+[discovery]
+enabled = true
+service_name = ""  # defaults to pytodo-{hostname}
+
+[appearance]
+theme = "system"  # light, dark, system
+```
+
+## Synchronization
+
+pytodo-qt uses a secure peer-to-peer protocol for syncing between instances:
+
+1. **Discovery** - Instances advertise themselves via mDNS (`_pytodo._tcp.local.`)
+2. **Key exchange** - Ed25519 identity keys with X25519 ephemeral session keys
+3. **Encryption** - All data encrypted with AES-256-GCM
+4. **Merge** - Last-write-wins conflict resolution with UUID-based items
+
+Identity keys are stored in your system keyring (GNOME Keyring, macOS Keychain, Windows Credential Locker).
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint and format
+ruff check src/ tests/
+ruff format src/ tests/
+
+# Type check
+basedpyright src/
+```
+
+## License
+
+GPLv3 or later. See [COPYING](COPYING) for details.
+
+Copyright 2024 Michael Berry <trismegustis@gmail.com>

pytodo_qt-0.3.8/pyproject.toml

@@ -0,0 +1,90 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pytodo_qt = ["*.png", "*.qss"]
+"pytodo_qt.gui.icons" = ["*.png", "*.svg", "*.ico", "*.icns"]
+"pytodo_qt.gui.styles" = ["*.qss"]
+
+[tool.basedpyright]
+typeCheckingMode = "standard"
+pythonVersion = "3.11"
+reportMissingImports = "warning"
+reportMissingTypeStubs = false
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+docstring-code-format = true
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # Pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "SIM",    # flake8-simplify
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "SIM108", # allow if-else instead of ternary
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["pytodo_qt"]
+
+[project]
+name = "pytodo-qt"
+version = "0.3.8"
+description = "A cross-platform to-do list manager with encrypted peer-to-peer synchronization"
+readme = "README.md"
+authors = [
+    {name = "Michael Berry", email = "trismegustis@gmail.com"},
+]
+dependencies = [
+    "PyQt6>=6.4",
+    "cryptography>=41.0",
+    "zeroconf>=0.80",
+    "keyring>=24.0",
+    "qasync>=0.24",
+    "rich>=13.0",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Operating System :: OS Independent",
+]
+license = {text = "GPLv3"}
+requires-python = ">=3.11"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-qt>=4.2",
+    "pytest-asyncio>=0.21",
+    "pytest-cov>=4.0",
+    "ruff>=0.4",
+    "basedpyright>=1.18",
+]
+
+[project.urls]
+Homepage = "https://github.com/berrym/pytodo-qt"
+
+[project.scripts]
+pytodo-qt = "pytodo_qt.__main__:main"

pytodo_qt-0.3.8/src/pytodo_qt/__init__.py

@@ -0,0 +1,18 @@
+"""pytodo-qt - A modern cross-platform to-do application with secure sync.
+
+Version 0.3.0 brings:
+- AES-256-GCM authenticated encryption
+- Ed25519/X25519 key exchange for secure connections
+- UUID-based data model with Lamport timestamps
+- Last-Write-Wins sync with conflict tracking
+- Zeroconf/mDNS service discovery
+- TOML configuration with system keyring integration
+- Modern themed UI with light/dark/system mode support
+
+Copyright (C) 2024 Michael Berry
+License: GPLv3
+"""
+
+from .core.settings import __version__
+
+__all__ = ["__version__"]

pytodo_qt-0.3.8/src/pytodo_qt/__main__.py

@@ -0,0 +1,167 @@
+"""__main__.py
+
+pytodo-qt
+
+A modern to-do list application with secure synchronization.
+
+Copyright (C) 2024 Michael Berry <trismegustis@gmail.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+"""
+
+import argparse
+import asyncio
+import sys
+
+from PyQt6.QtWidgets import QApplication
+from qasync import QEventLoop
+
+from .core import settings
+from .core.logger import Logger
+
+logger = Logger(__name__)
+
+
+def main():
+    """Application entry point."""
+    # Initialize configuration system
+    config = settings.init_config()
+
+    # Create command line argument parser
+    arg_parser = argparse.ArgumentParser(
+        prog="pytodo-qt",
+        description="Modern To-Do List Application with Secure Sync",
+        epilog="Copyright (C) 2024 Michael Berry",
+    )
+
+    # Server options
+    server_group = arg_parser.add_argument_group("Server Options")
+
+    server_group.add_argument(
+        "-s",
+        "--server",
+        action="store",
+        type=str,
+        choices=["yes", "no"],
+        help="enable/disable network server",
+    )
+
+    server_group.add_argument(
+        "--pull",
+        action="store",
+        type=str,
+        choices=["yes", "no"],
+        help="allow remote pull requests",
+    )
+
+    server_group.add_argument(
+        "--push",
+        action="store",
+        type=str,
+        choices=["yes", "no"],
+        help="allow remote push requests",
+    )
+
+    server_group.add_argument(
+        "-i",
+        "--ip",
+        type=str,
+        help="server bind address",
+    )
+
+    server_group.add_argument(
+        "-p",
+        "--port",
+        type=int,
+        help="server port",
+    )
+
+    # Discovery options
+    discovery_group = arg_parser.add_argument_group("Discovery Options")
+
+    discovery_group.add_argument(
+        "-d",
+        "--discovery",
+        action="store",
+        type=str,
+        choices=["yes", "no"],
+        help="enable/disable mDNS discovery",
+    )
+
+    # Appearance options
+    appearance_group = arg_parser.add_argument_group("Appearance Options")
+
+    appearance_group.add_argument(
+        "-t",
+        "--theme",
+        type=str,
+        choices=["light", "dark", "system"],
+        help="UI theme",
+    )
+
+    # General options
+    arg_parser.add_argument(
+        "-V",
+        "--version",
+        action="version",
+        version=f"%(prog)s v{settings.__version__}",
+    )
+
+    # Parse arguments
+    args = arg_parser.parse_args()
+
+    # Apply command-line overrides to config
+    if args.server is not None:
+        config.server.enabled = args.server == "yes"
+    if args.pull is not None:
+        config.server.allow_pull = args.pull == "yes"
+    if args.push is not None:
+        config.server.allow_push = args.push == "yes"
+    if args.ip is not None:
+        config.server.address = args.ip
+    if args.port is not None:
+        config.server.port = args.port
+    if args.discovery is not None:
+        config.discovery.enabled = args.discovery == "yes"
+    if args.theme is not None:
+        config.appearance.theme = args.theme
+
+    # Create Qt application
+    app = QApplication(sys.argv)
+    app.setApplicationName("pytodo-qt")
+    app.setApplicationVersion(settings.__version__)
+    app.setOrganizationName("pytodo-qt")
+
+    # Set up async event loop with qasync
+    loop = QEventLoop(app)
+    asyncio.set_event_loop(loop)
+
+    # Apply theme
+    from .gui.styles import apply_current_theme
+
+    apply_current_theme()
+
+    # Create main window
+    logger.log.info("Starting pytodo-qt v%s", settings.__version__)
+    from .gui.main_window import MainWindow
+
+    _window = MainWindow()  # noqa: F841 - window must stay alive for event loop
+
+    # Run application with async event loop
+    with loop:
+        sys.exit(loop.run_forever())
+
+
+if __name__ == "__main__":
+    main()