pysfi 0.1.12__tar.gz → 0.1.14__tar.gz

{pysfi-0.1.12 → pysfi-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pysfi
-Version: 0.1.12
+Version: 0.1.14
 Summary: Single File commands for Interactive python.
 Requires-Python: >=3.8
 Requires-Dist: tomli>=2.4.0; python_version < '3.11'

{pysfi-0.1.12 → pysfi-0.1.14}/pyproject.toml

@@ -1,172 +1,179 @@
-[build-system]
-build-backend = "hatchling.build"
-requires = ["hatchling"]
-
-[project]
-dependencies = ["tomli>=2.4.0; python_version<'3.11'"]
-description = "Single File commands for Interactive python."
-name = "pysfi"
-readme = "README.md"
-requires-python = ">=3.8"
-version = "0.1.12"
-
-[project.scripts]
-alarmclk = "sfi.alarmclock.alarmclock:main"
-bumpversion = "sfi.bumpversion.bumpversion:main"
-cleanbuild = "sfi.cleanbuild.cleanbuild:main"
-condasetup = "sfi.condasetup.condasetup:main"
-docdiff = "sfi.docdiff.docdiff:main"
-docscan = "sfi.docscan.docscan:main"
-docscan-gui = "sfi.docscan.docscan_gui:main"
-filedate = "sfi.filedate.filedate:main"
-gitt = "sfi.gittool.gittool:main"
-llmcli = "sfi.llmclient.llmclient:main"
-llmqnt = "sfi.llmquantize.llmquantize:main"
-llmsvr = "sfi.llmserver.llmserver:main"
-mkp = "sfi.makepython.makepython:main"
-pdfsplit = "sfi.pdfsplit.pdfsplit:main"
-pyarchive = "sfi.pyarchive.pyarchive:main"
-pyembedinstall = "sfi.pyembedinstall.pyembedinstall:main"
-pylibpack = "sfi.pylibpack.pylibpack:main"
-pyloadergen = "sfi.pyloadergen.pyloadergen:main"
-pyp = "sfi.pypack.pypack:main"
-pypack = "sfi.pypack.pypack:main"
-pyprojectparse = "sfi.pyprojectparse.pyprojectparse:main"
-pysourcepack = "sfi.pysourcepack.pysourcepack:main"
-quizbase = "sfi.quizbase.quizbase:main"
-quizbase-gui = "sfi.quizbase.quizbase_gui:main"
-regval = "sfi.regexvalidate.regexvalidate:main"
-sfi = "sfi.cli:main"
-taskk = "sfi.taskkill.taskkill:main"
-wch = "sfi.which.which:main"
-
-[project.optional-dependencies]
-all = ["pysfi[gui,office,ocr,extra]"]
-extra = ["ebooklib>=0.18", "markdown>=3.5", "odfpy>=1.4.1", "pypdf>=3.0.0"]
-gui = ["PySide2>=5.15.2.1", "pyside2-stubs>=5.15.2.1.2"]
-ocr = ["Pillow>=10.0.0", "pytesseract>=0.3.10"]
-office = [
-    "openpyxl>=3.1.0",
-    "pymupdf>=1.24.11",
-    "python-docx>=1.1.0",
-    "python-pptx>=0.6.21",
-    "pywin32>=311; sys.platform=='win32'",
-]
-
-[tool.hatch.build.targets.wheel]
-exclude = [
-    "sfi/*/README.md",
-    "sfi/*/dist",
-    "sfi/*/pyproject.toml",
-    "sfi/*/tests",
-]
-packages = ["sfi"]
-
-# Only include necessary source files to minimize package size
-[tool.hatch.build]
-include = ["README.md", "sfi/**/*.py", "sfi/pyproject.toml"]
-
-[tool.ruff]
-line-length = 88
-target-version = "py38"
-
-# Exclude files and directories
-exclude = [
-    ".bzr",
-    ".direnv",
-    ".eggs",
-    ".git",
-    ".git-rewrite",
-    ".hg",
-    ".mypy_cache",
-    ".nox",
-    ".pants.d",
-    ".pytype",
-    ".ruff_cache",
-    ".svn",
-    ".tox",
-    ".venv",
-    "__pypackages__",
-    "_build",
-    "buck-out",
-    "build",
-    "dist",
-    "node_modules",
-    "venv",
-]
-
-[tool.ruff.lint]
-dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
-fixable = ["ALL"]
-ignore = [
-    "B008",   # Do not perform function calls in function arguments
-    "E501",   # Line too long (handled by formatter)
-    "RUF001", # Language specific rules
-    "RUF002", # Language specific rules
-    "RUF003", # Language specific rules
-]
-select = [
-    "B",   # flake8-bugbear
-    "C4",  # flake8-comprehensions
-    "E",   # pycodestyle errors
-    "F",   # Pyflakes
-    "I",   # isort
-    "N",   # pep8-naming
-    "RUF", # Ruff-specific rules
-    "SIM", # flake8-simplify
-    "UP",  # pyupgrade
-    "W",   # pycodestyle warnings
-]
-unfixable = []
-
-[tool.ruff.lint.isort]
-known-first-party = ["sfi"]
-
-[tool.ruff.lint.per-file-ignores]
-"__init__.py" = ["F401"] # Allow unused imports
-
-[tool.uv.workspace]
-members = [
-    "sfi/alarmclock",
-    "sfi/bumpversion",
-    "sfi/cleanbuild",
-    "sfi/condasetup",
-    "sfi/docdiff",
-    "sfi/docscan",
-    "sfi/filedate",
-    "sfi/gittool",
-    "sfi/llmclient",
-    "sfi/llmquantize",
-    "sfi/llmserver",
-    "sfi/makepython",
-    "sfi/pdfsplit",
-    "sfi/pyarchive",
-    "sfi/pyembedinstall",
-    "sfi/pylibpack",
-    "sfi/pyloadergen",
-    "sfi/pypack",
-    "sfi/pyprojectparse",
-    "sfi/pysourcepack",
-    "sfi/quizbase",
-    "sfi/regexvalidate",
-    "sfi/taskkill",
-    "sfi/which",
-    "sfi/workflowengine",
-]
-
-[dependency-groups]
-dev = [
-    "hatch>=1.14.2",
-    "hypothesis>=6.113.0",
-    "pysfi[all]",
-    "pyside2>=5.15.2.1",
-    "pytest-asyncio>=0.24.0",
-    "pytest-benchmark>=4.0.0",
-    "pytest-cov>=5.0.0",
-    "pytest-mock>=3.14.0",
-    "pytest-qt>=4.4.0",
-    "pytest>=8.3.5",
-    "qdarkstyle>=3.2.3",
-    "ruff>=0.14.11",
-    "tomli>=2.4.0",
-]
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[project]
+dependencies = ["tomli>=2.4.0; python_version<'3.11'"]
+description = "Single File commands for Interactive python."
+name = "pysfi"
+readme = "README.md"
+requires-python = ">=3.8"
+version = "0.1.14"
+
+[project.scripts]
+alarmclk = "sfi.alarmclock.alarmclock:main"
+bumpversion = "sfi.bumpversion.bumpversion:main"
+cleanbuild = "sfi.cleanbuild.cleanbuild:main"
+condasetup = "sfi.condasetup.condasetup:main"
+docdiff = "sfi.docdiff.docdiff:main"
+docscan = "sfi.docscan.docscan:main"
+docscan-gui = "sfi.docscan.docscan_gui:main"
+filedate = "sfi.filedate.filedate:main"
+gitt = "sfi.gittool.gittool:main"
+img2pdf = "sfi.img2pdf.img2pdf:main"
+llmcli = "sfi.llmclient.llmclient:main"
+llmqnt = "sfi.llmquantize.llmquantize:main"
+llmsvr = "sfi.llmserver.llmserver:main"
+mkp = "sfi.makepython.makepython:main"
+makepython = "sfi.makepython.makepython:main"
+pdfsplit = "sfi.pdfsplit.pdfsplit:main"
+pyarchive = "sfi.pyarchive.pyarchive:main"
+pyembedinstall = "sfi.pyembedinstall.pyembedinstall:main"
+pylibpack = "sfi.pylibpack.pylibpack:main"
+pyloadergen = "sfi.pyloadergen.pyloadergen:main"
+pyp = "sfi.pypack.pypack:main"
+pypack = "sfi.pypack.pypack:main"
+pypp = "sfi.pyprojectparse.pyprojectparse:main"
+pyprojectparse = "sfi.pyprojectparse.pyprojectparse:main"
+pysourcepack = "sfi.pysourcepack.pysourcepack:main"
+quizbase = "sfi.quizbase.quizbase:main"
+quizbase-gui = "sfi.quizbase.quizbase_gui:main"
+regval = "sfi.regexvalidate.regexvalidate:main"
+sfi = "sfi.cli:main"
+taskk = "sfi.taskkill.taskkill:main"
+wch = "sfi.which.which:main"
+
+[project.optional-dependencies]
+all = ["pysfi[gui,office,ocr,extra]"]
+extra = ["ebooklib>=0.18", "markdown>=3.5", "odfpy>=1.4.1", "pypdf>=3.0.0"]
+gui = ["PySide2>=5.15.2.1", "pyside2-stubs>=5.15.2.1.2"]
+ocr = ["Pillow>=10.0.0", "pytesseract>=0.3.10"]
+office = [
+    "openpyxl>=3.1.0",
+    "pymupdf>=1.24.11",
+    "python-docx>=1.1.0",
+    "python-pptx>=0.6.21",
+    "pywin32>=311; sys.platform=='win32'",
+]
+
+[tool.hatch.build.targets.wheel]
+exclude = [
+    "sfi/*/README.md",
+    "sfi/*/dist",
+    "sfi/*/pyproject.toml",
+    "sfi/*/tests",
+]
+packages = ["sfi"]
+
+# Only include necessary source files to minimize package size
+[tool.hatch.build]
+include = ["README.md", "sfi/**/*.py", "sfi/pyproject.toml"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py38"
+
+# Exclude files and directories
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+]
+
+[tool.ruff.lint]
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+fixable = ["ALL"]
+ignore = [
+    "B008",   # Do not perform function calls in function arguments
+    "E501",   # Line too long (handled by formatter)
+    "RUF001", # Language specific rules
+    "RUF002", # Language specific rules
+    "RUF003", # Language specific rules
+]
+select = [
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "E",   # pycodestyle errors
+    "F",   # Pyflakes
+    "I",   # isort
+    "N",   # pep8-naming
+    "RUF", # Ruff-specific rules
+    "SIM", # flake8-simplify
+    "UP",  # pyupgrade
+    "W",   # pycodestyle warnings
+]
+unfixable = []
+
+[tool.ruff.lint.isort]
+known-first-party = ["sfi"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"] # Allow unused imports
+
+[tool.uv.sources]
+pysfi = { workspace = true }
+
+[tool.uv.workspace]
+members = [
+    "sfi/alarmclock",
+    "sfi/bumpversion",
+    "sfi/cleanbuild",
+    "sfi/condasetup",
+    "sfi/docdiff",
+    "sfi/docscan",
+    "sfi/filedate",
+    "sfi/gittool",
+    "sfi/img2pdf",
+    "sfi/llmclient",
+    "sfi/llmquantize",
+    "sfi/llmserver",
+    "sfi/makepython",
+    "sfi/pdfsplit",
+    "sfi/pyarchive",
+    "sfi/pyembedinstall",
+    "sfi/pylibpack",
+    "sfi/pyloadergen",
+    "sfi/pypack",
+    "sfi/pyprojectparse",
+    "sfi/pysourcepack",
+    "sfi/quizbase",
+    "sfi/regexvalidate",
+    "sfi/taskkill",
+    "sfi/which",
+]
+
+[dependency-groups]
+dev = [
+    "hatch>=1.14.2",
+    "hypothesis>=6.113.0",
+    "pysfi[all]",
+    "pyside2>=5.15.2.1",
+    "pytest-asyncio>=0.24.0",
+    "pytest-benchmark>=4.0.0",
+    "pytest-cov>=5.0.0",
+    "pytest-mock>=3.14.0",
+    "pytest-qt>=4.4.0",
+    "pytest-xdist>=3.5.0",
+    "pytest>=8.3.5",
+    "qdarkstyle>=3.2.3",
+    "ruff>=0.14.11",
+    "tomli>=2.4.0",
+]

pysfi-0.1.14/sfi/__init__.py

@@ -0,0 +1,20 @@
+"""Single File commands for Interactive python.
+
+pysfi (Python Single File Interactive) is a collection of Python utility
+tools designed to streamline development workflows and enhance productivity.
+
+This package provides:
+- Document processing utilities (docscan, docdiff, pdfsplit, img2pdf)
+- Development tools (makepython, bumpversion, cleanbuild)
+- System management utilities (filedate, taskkill, gittool)
+- AI/LLM tools (llmclient, llmserver, llmquantize)
+- And many more specialized utilities
+
+Each module can be used independently as a command-line tool
+or imported as a Python library.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.14"
+__all__ = ["__version__"]

pysfi-0.1.14/sfi/alarmclock/README.md

@@ -0,0 +1,117 @@
+# Alarm Clock
+
+A digital alarm clock application with a graphical user interface built using PySide2. Features include configurable alarms, digital time display, visual notifications, alarm history, and advanced configuration options.
+
+## Features
+
+- **Digital clock display** with animated border effects and customizable styling
+- **Configurable alarm time setting** with precise time selection
+- **Quick delay options** (1, 5, 10, 15, 30, 60 minutes) for fast alarm setup
+- **Repeat alarm functionality** for daily recurring alarms
+- **Snooze feature** with configurable snooze duration and count limits
+- **Multiple visual notification effects** including color, opacity, and combined animations
+
+- **Alarm history tracking** with statistics and recent activity
+- **Dark theme interface** with modern styling
+- **Persistent configuration** with automatic saving and loading
+- **Advanced settings** including window behavior, logging, and performance options
+
+## Installation
+
+Install the required dependencies:
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+Run the alarm clock application:
+
+```bash
+alarmclk
+```
+
+Or directly with Python:
+
+```bash
+python -m sfi.alarmclock
+```
+
+### Command Line Options
+
+- `-d, --debug`: Enable debug mode with verbose logging
+- `-v, --version`: Show version information
+- `--config PATH`: Use custom configuration file
+- `--reset-config`: Reset configuration to defaults
+
+### Configuration
+
+The application creates configuration files in `~/.pysfi/alarmclock/`:
+
+- `config.json`: Main configuration settings
+- `history.json`: Alarm history and statistics
+- `alarmclock.log`: Application logs
+
+Configuration can be customized through the config file or programmatically.
+
+## Configuration Parameters
+
+The application uses the following configuration parameters:
+
+- **Digital Clock**: Displays current time with animated border colors
+- **Alarm Time**: Set specific time for the alarm to trigger
+- **Delay Options**: Quick buttons to set alarms for specific intervals
+- **Repeat Option**: Enable/disable alarm repetition
+- **Visual Notifications**: Alert dialog with blinking effect
+
+## Architecture
+
+The application follows a modular design:
+
+- `AlarmClockConfig`: Configuration dataclass with all application settings
+- `DigitalClock`: Widget displaying current time with animation
+- `BlinkDialog`: Notification dialog with visual effects
+- `AlarmClock`: Main application window with GUI controls
+
+## Testing
+
+The module includes comprehensive tests divided into two categories:
+
+### Core Tests (Non-GUI)
+
+```bash
+python -m pytest sfi/alarmclock/tests/test_alarmclock_core.py -v
+```
+
+Tests configuration, data classes, enums, and core logic without requiring a GUI environment.
+
+### GUI Tests
+
+```bash
+python -m pytest sfi/alarmclock/tests/test_alarmclock_gui.py -v -m qt
+```
+
+Tests GUI components using pytest-qt. These tests require a working Qt environment.
+
+### Benchmark Tests
+
+```bash
+python -m pytest sfi/alarmclock/tests/test_benchmark.py -v
+```
+
+Performance benchmarks for critical operations.
+
+### Run All Tests
+
+```bash
+python -m pytest sfi/alarmclock/tests/ -v
+```
+
+## Dependencies
+
+- PySide2: GUI framework
+- qdarkstyle: Dark theme styling
+- typing-extensions: Type hinting support for older Python versions
+- pytest: Testing framework
+- pytest-qt: Qt testing utilities

pysfi-0.1.14/sfi/alarmclock/__init__.py

@@ -0,0 +1,3 @@
+"""Alarm clock module for pysfi."""
+
+from __future__ import annotations

{pysfi-0.1.12 → pysfi-0.1.14}/sfi/alarmclock/alarmclock.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import argparse
 import logging
 import random
 import sys
@@ -8,7 +7,6 @@ from dataclasses import dataclass
 from datetime import datetime, timedelta, timezone
 from functools import partial
 
-import qdarkstyle
 from PySide2.QtCore import QSize, Qt, QTime, QTimer
 from PySide2.QtGui import QCloseEvent
 from PySide2.QtWidgets import (
@@ -28,7 +26,7 @@ __version__ = "0.1.3"
 __build_date__ = "2026-01-22"
 
 
-@dataclass(frozen=True)
+@dataclass
 class AlarmClockConfig:
     """Configuration for the alarm clock application."""
 
@@ -87,9 +85,9 @@ class DigitalClock(QLabel):
         logger.debug(f"Updated time: {current}")
 
         # Add blink effect
-        self._color = random.choice(
-            [_ for _ in config.DIGITAL_BORDER_COLORS if _ != self._color],
-        )
+        self._color = random.choice([
+            c for c in config.DIGITAL_BORDER_COLORS if c != self._color
+        ])
         self.setStyleSheet(f"""
             font: {config.DIGITAL_FONT};
             color: {config.DIGITAL_COLOR};
@@ -112,6 +110,7 @@ class BlinkDialog(QDialog):
             self.windowFlags() | Qt.WindowStaysOnTopHint | Qt.WindowType.Dialog,
         )
         self.setFixedSize(QSize(400, 240))
+        self.setWindowFlag(Qt.WindowCloseButtonHint, False)
 
         layout = QVBoxLayout()
         msg_label = QLabel(config.BLINK_CONTENT)
@@ -122,32 +121,28 @@ class BlinkDialog(QDialog):
         msg_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
 
         close_button = QPushButton("Close Alarm")
-        close_button.clicked.connect(self.accept)
+        close_button.clicked.connect(self.close_alarm)
 
         layout.addWidget(msg_label)
         layout.addWidget(close_button)
         self.setLayout(layout)
 
-        # Prevent user from closing dialog by other means, ensure button click only
-        self.setWindowFlag(Qt.WindowCloseButtonHint, False)
-
         # Blink control variables and timer
         self.blink_timer = QTimer(self)
         self.blink_timer.timeout.connect(self.update_blink)
         self.blink_state = False
         self.blink_type = config.BLINK_TYPE
-
-        # Initialize style
         self.bg_color = random.choice(config.BLINK_BG_COLORS)
-        self.origin_style = self.styleSheet()
         self.blink_timer.start(config.BLINK_INTERVAL)
 
     def update_blink(self) -> None:
         """Timer timeout, update blink state."""
         if self.blink_type == "color":
             # Color blink logic
-            colors = [_ for _ in config.BLINK_BG_COLORS[:] if _ != self.bg_color]
-            self.setStyleSheet(f"background-color: {random.choice(colors)}")
+            colors = [c for c in config.BLINK_BG_COLORS if c != self.bg_color]
+            new_color = random.choice(colors)
+            self.setStyleSheet(f"background-color: {new_color}")
+            self.bg_color = new_color
         elif self.blink_type == "opacity":
             # Opacity blink logic - Note: Some systems may not fully support window opacity
             new_opacity = 0.3 if self.blink_state else 1.0
@@ -155,10 +150,14 @@ class BlinkDialog(QDialog):
 
         self.blink_state = not self.blink_state  # Toggle state
 
+    def close_alarm(self) -> None:
+        """Close alarm dialog and stop blinking."""
+        self.stop_blinking()
+        self.accept()
+
     def stop_blinking(self) -> None:
-        """Stop blinking, restore original style."""
+        """Stop blinking."""
         self.blink_timer.stop()
-        self.setStyleSheet(self.origin_style)  # Restore original style
         self.setWindowOpacity(1.0)  # Ensure opacity is restored
 
     def closeEvent(self, event: QCloseEvent) -> None:  # noqa: N802
@@ -173,13 +172,6 @@ class AlarmClock(QMainWindow):
     def __init__(self) -> None:
         super().__init__()
         self.setWindowTitle(f"{config.ALARM_CLOCK_TITLE} v{__version__}")
-        self.setGeometry(
-            QApplication.desktop().screenGeometry().center().x() - self.width() // 4,
-            QApplication.desktop().screenGeometry().center().y() - self.height() // 2,
-            self.width(),
-            self.height(),
-        )
-        self.adjustSize()
 
         # Set window style
         self.setStyleSheet("""
@@ -277,6 +269,13 @@ class AlarmClock(QMainWindow):
         self.status_label.setStyleSheet("color: #aaaaaa; font-size: 16px;")
         main_layout.addWidget(self.status_label)
 
+        # Center window on screen
+        self.adjustSize()
+        screen = QApplication.desktop().screenGeometry()
+        x = (screen.width() - self.width()) // 2
+        y = (screen.height() - self.height()) // 2
+        self.move(x, y)
+
         # Alarm timer
         self.alarm_timer = QTimer()
         self.alarm_timer.timeout.connect(self.check_alarm)
@@ -330,11 +329,6 @@ class AlarmClock(QMainWindow):
             dialog.exec_()
 
             self.status_label.setText("⏰ Alarm Rang! ⏰")
-            self.status_label.setStyleSheet(
-                "color: #ff5555; font-size: 18px; font-weight: bold;",
-            )
-
-            # Add blink effect
             self.status_label.setStyleSheet("""
                 color: #ff0000;
                 font-size: 18px;
@@ -350,18 +344,7 @@ class AlarmClock(QMainWindow):
 
 
 def main() -> None:
-    parser = argparse.ArgumentParser(
-        prog="alarmclock", description="Digital Alarm Clock"
-    )
-    parser.add_argument("-d", "--debug", action="store_true", help="Enable debug mode")
-    parser.add_argument("-v", "--version", action="version", version=f"{__version__}")
-
-    args = parser.parse_args()
-    if args.debug:
-        logger.setLevel(logging.DEBUG)
-
     app = QApplication(sys.argv)
-    app.setStyleSheet(qdarkstyle.load_stylesheet_pyside2())
     window = AlarmClock()
     window.show()
     sys.exit(app.exec_())

{pysfi-0.1.12 → pysfi-0.1.14}/sfi/bumpversion/__init__.py

@@ -1,3 +1,5 @@
 """Bumpversion - Automated version number management tool."""
 
-__version__ = "0.1.12"
+from __future__ import annotations
+
+__version__ = "0.1.14"