pysfi 0.1.11__py3-none-any.whl → 0.1.13__py3-none-any.whl

{pysfi-0.1.11.dist-info → pysfi-0.1.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pysfi
-Version: 0.1.11
+Version: 0.1.13
 Summary: Single File commands for Interactive python.
 Requires-Python: >=3.8
 Requires-Dist: tomli>=2.4.0; python_version < '3.11'
@@ -17,6 +17,7 @@ Requires-Dist: pyside2>=5.15.2.1; extra == 'all'
 Requires-Dist: pytesseract>=0.3.10; extra == 'all'
 Requires-Dist: python-docx>=1.1.0; extra == 'all'
 Requires-Dist: python-pptx>=0.6.21; extra == 'all'
+Requires-Dist: pywin32>=311; (sys_platform == 'win32') and extra == 'all'
 Provides-Extra: extra
 Requires-Dist: ebooklib>=0.18; extra == 'extra'
 Requires-Dist: markdown>=3.5; extra == 'extra'
@@ -33,6 +34,7 @@ Requires-Dist: openpyxl>=3.1.0; extra == 'office'
 Requires-Dist: pymupdf>=1.24.11; extra == 'office'
 Requires-Dist: python-docx>=1.1.0; extra == 'office'
 Requires-Dist: python-pptx>=0.6.21; extra == 'office'
+Requires-Dist: pywin32>=311; (sys_platform == 'win32') and extra == 'office'
 Description-Content-Type: text/markdown
 
 # pysfi

pysfi-0.1.13.dist-info/RECORD

@@ -0,0 +1,70 @@
+sfi/__init__.py,sha256=dZ1dacNjP1yRdG5N4-UtVhSZGUdEzRv4usjC1kr-3jY,116
+sfi/cli.py,sha256=QF6-bdw8vOUMmFovjp4lYpWesHtae4oxHeEWDnt7_k8,504
+sfi/alarmclock/__init__.py,sha256=yyFexrNdi65kz3l68YjT5Bdlq4FFqBR80H8vV7e_D58,75
+sfi/alarmclock/alarmclock.py,sha256=ixVkbg548smUivRsqyI3YSZ81BWIrKawnuezAp3BzyE,11635
+sfi/bumpversion/__init__.py,sha256=ajzMFse8CnLshD5qpKEr4fze3tnup2S9GWWyd7xpC2A,127
+sfi/bumpversion/bumpversion.py,sha256=HOyHLaE0sZajrlcVZ8hsim8mPjz77qwQVSo6aIzjMXE,20735
+sfi/cleanbuild/__init__.py,sha256=V4WV0xUvTaNGxawfYqlLT98t_8FeiA7ec1NW6R0-pGE,101
+sfi/cleanbuild/cleanbuild.py,sha256=Fr6_cr3rj4llcEQ8yNTK-DHdSzmx1I4hYFJJHu5YEz0,5200
+sfi/condasetup/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
+sfi/condasetup/condasetup.py,sha256=RlbXVYcAJYMau-ZzHOMzHrHl4r-lqNZO0bT-zWuzP_k,4581
+sfi/docdiff/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
+sfi/docdiff/docdiff.py,sha256=anilgq16icu-UxdgRR7B_57G9CFJ79xBSjOm9DOQluY,7736
+sfi/docscan/__init__.py,sha256=HQzSYiozGNtCdC771DXce57YwdXzQiSWFQKaTnnjAQU,124
+sfi/docscan/docscan.py,sha256=rk8mjEI2SKNIliV-Yb41pfUmYBQ1tUhk5LHUNEjkszI,41890
+sfi/docscan/docscan_gui.py,sha256=c7sJXvq5201Kh7iewalc50qoMnNR_eEna0NqoEJ7igw,52335
+sfi/docscan/lang/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/docscan/lang/eng.py,sha256=GcOcT9FLcPZRdJ-MbLRYyf6vDweZTQBu_zUnEFzRY84,8529
+sfi/docscan/lang/zhcn.py,sha256=1SZwQjZF3oi9FsnzuZB-9v7P64sGm5oNmVjuL-rhcEQ,8885
+sfi/filedate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/filedate/filedate.py,sha256=5FARcsB2Rlz2uTBxeYYjbIEJb9l1cyXj9WSoNKvSrRo,6068
+sfi/gittool/__init__.py,sha256=Xqxw7UUX-TKkWOCB1QHq8AdIKTkU7x87Xr-E0yVmObA,24
+sfi/gittool/gittool.py,sha256=BBE6gm9qP1fAWLqKprmsf7bOFgDvBvia8_bMaXc7dR4,11960
+sfi/img2pdf/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/img2pdf/img2pdf.py,sha256=rR6f5bMg-HoKMvSyu2rWfDbx0kmo6F6e1dg5z3710Wo,15129
+sfi/llmclient/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/llmclient/llmclient.py,sha256=zvaT-HEiL3CM3uEpvzuseLPEqFQe6RO4_fhnA2djHo0,22681
+sfi/llmquantize/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/llmquantize/llmquantize.py,sha256=N4h0RwdpVZdZM3qDWbL34hLGpQ3XuPkP_F8kyhhM8ZI,18855
+sfi/llmserver/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
+sfi/llmserver/llmserver.py,sha256=Fm4Go7wif4xMGomMFDsyJnYMafXsWemGkr-VfaeYa6w,13530
+sfi/makepython/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/makepython/makepython.py,sha256=srinUE1Yr6zF-NjiUFVC1sUrpy8fYpDnCs7p648jWqc,23278
+sfi/pdfsplit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pdfsplit/pdfsplit.py,sha256=QWtW3GU28U2ZOyN5sCbH7jEMBpNbuAIzjXWOAXXW44M,6209
+sfi/pyarchive/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
+sfi/pyarchive/pyarchive.py,sha256=OnPbIRA0C9JdeyNsVZ6rJg7ExItKyJz4jVw5W4c92DA,38293
+sfi/pyembedinstall/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pyembedinstall/pyembedinstall.py,sha256=LHnuvr63DXuntdS6a_7uQynOfarK-30WBUerSzawSHE,24171
+sfi/pylibpack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pylibpack/pylibpack.py,sha256=qK6J2_0VLMWQsKjcZ5njsvfqCnMRmGx8RweH2olhWTo,57818
+sfi/pylibpack/rules/numpy.json,sha256=ee4gA5NBudFi3MaJA-QlBKQwiQAUb-eluF8HNVkl7Vk,384
+sfi/pylibpack/rules/pymupdf.json,sha256=Hkzh8dvXKCzKx4aeHbu5E0qwgfbwQxZH2VLtQZzlMO4,153
+sfi/pylibpack/rules/pyqt5.json,sha256=JKGnVSUMfXGR5XK1sbL1F6cAsEhl7hK12QkrulAB00M,374
+sfi/pylibpack/rules/pyside2.json,sha256=uSSteT-3wDohWwQ36Z5mSOaSbxrR4565In4uZj_eR4w,557
+sfi/pylibpack/rules/scipy.json,sha256=vTSi3W5BGWcwMkaDnyD6Yg7ijZdicPEUMw4fnRTnNf4,468
+sfi/pylibpack/rules/shiboken2.json,sha256=9Pl3eslvergyjlyHNknkyN0oZlcH3049WULe5WjsmKM,515
+sfi/pyloadergen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pyloadergen/pyloadergen.py,sha256=VWJzc0opmMVthHE_RGbWeLe-DBaMn94gZo2yYLkf8cI,45696
+sfi/pypack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pypack/pypack.py,sha256=3LTCZMk8TqYhJbGv9AMLbe_Vi6bV7-cQUuHrWWO7QZU,22385
+sfi/pyprojectparse/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pyprojectparse/pyprojectparse.py,sha256=pHuwVCpVUlRoC9pRo3r6d0DfqqoEbsREsUuYjnkhqhU,30575
+sfi/pysourcepack/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
+sfi/pysourcepack/pysourcepack.py,sha256=5_KrI2Y1TKKcoYfsFpTNXWguj6n8CKdca8lgoBCsL8k,12160
+sfi/quizbase/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/quizbase/quizbase.py,sha256=3tPUuYexZ9TVsNPPO_Itmr5OvyHSgY5OSUZwPoQt9zg,30605
+sfi/quizbase/quizbase_gui.py,sha256=m_Lj3au1a8gEv5x7KOTjomiP1NpXHUgHSPE4lLv63hY,34733
+sfi/regexvalidate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/regexvalidate/regex_help.html,sha256=3ltx3nh-Y5kkbHy5D67KfWtLig3u5XEhIlPHdHLEuTE,12436
+sfi/regexvalidate/regexvalidate.py,sha256=5C_M2EKt9Jlonq03v9zrqtsFfAKK3D1vF1kBxD6iUpE,18600
+sfi/taskkill/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/taskkill/taskkill.py,sha256=wM9g8sWJVTy4GxXe26rKdax2lIBI-uH9wP5wRenriH4,11606
+sfi/which/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/which/which.py,sha256=2YbGgSiT1ySapKVV1ESoPf4P-JU8vvzmsZY39NiVr6k,2596
+sfi/workflowengine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/workflowengine/workflowengine.py,sha256=pPRsxWB2ZoDwcVTjsDlpiml-xZYiZBKjLcINu4TGBcE,19209
+pysfi-0.1.13.dist-info/METADATA,sha256=6MAsufstxqnCpDvLj0O0xA6ZjTMvMAhwlccsrvu9uT4,4198
+pysfi-0.1.13.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pysfi-0.1.13.dist-info/entry_points.txt,sha256=ju_Bwp3L8-5Bpcj0PSCCDL8vGsGb4ZYpjfzprSdFrfA,1215
+pysfi-0.1.13.dist-info/RECORD,,

{pysfi-0.1.11.dist-info → pysfi-0.1.13.dist-info}/entry_points.txt

@@ -3,10 +3,12 @@ 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
@@ -18,6 +20,7 @@ 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

sfi/__init__.py

@@ -1,3 +1,5 @@
-"""Single File commands for Interactive python."""
-
-__version__ = "0.1.11"
+"""Single File commands for Interactive python."""
+
+from __future__ import annotations
+
+__version__ = "0.1.13"

sfi/alarmclock/__init__.py

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

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_())

sfi/bumpversion/__init__.py

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

sfi/cleanbuild/__init__.py

@@ -0,0 +1,3 @@
+"""Cleanbuild - Clean build artifacts and temporary files."""
+
+from __future__ import annotations

sfi/cli.py

@@ -1,11 +1,21 @@
+from __future__ import annotations
+
 import argparse
 
 from sfi import __version__ as VERSION  # noqa: N812
 
 
-def main():
+def main() -> None:
+    """Main entry point for the pysfi CLI tool.
+
+    Parses command line arguments and handles version printing.
+    """
     parser = argparse.ArgumentParser()
     parser.add_argument(
-        "-v", "--version", action="version", version=f"%(prog)s v{VERSION}", help="Print version and exit"
+        "-v",
+        "--version",
+        action="version",
+        version=f"%(prog)s v{VERSION}",
+        help="Print version and exit",
     )
     parser.parse_args()

sfi/condasetup/__init__.py

@@ -0,0 +1 @@
+ 

sfi/docdiff/__init__.py

@@ -0,0 +1 @@
+ 

sfi/docdiff/docdiff.py

@@ -0,0 +1,238 @@
+from __future__ import annotations
+
+import argparse
+import atexit
+import json
+import logging
+import platform
+import subprocess
+import time
+from dataclasses import dataclass
+from functools import cached_property
+from pathlib import Path
+from typing import Any
+
+CONFIG_FILE = Path.home() / ".pysfi" / "docdiff.json"
+
+logging.basicConfig(level=logging.INFO, format="%(message)s")
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class DocDiffConfig:
+    """Document comparison configuration."""
+
+    DOC_DIFF_TITLE: str = "Comparison Result"
+    OUTPUT_DIR: str = str(Path.home())  # Use current directory if empty
+    COMPARE_MODE: str = "original"  # Options: original, revised
+    SHOW_CHANGES: bool = True
+    TRACK_REVISIONS: bool = True
+
+    def __init__(self) -> None:
+        if CONFIG_FILE.exists():
+            logger.info("Loading configuration from %s", CONFIG_FILE)
+            config_data = json.loads(CONFIG_FILE.read_text())
+            # Update configuration items, keeping defaults as fallback
+            for key, value in config_data.items():
+                if hasattr(self, key):
+                    setattr(self, key, value)
+        else:
+            logger.info("Using default configuration")
+
+    def save(self) -> None:
+        """Save configuration."""
+        CONFIG_FILE.parent.mkdir(parents=True, exist_ok=True)
+        CONFIG_FILE.write_text(json.dumps(vars(self), indent=4))
+
+
+conf = DocDiffConfig()
+atexit.register(conf.save)
+
+
+@dataclass(frozen=True)
+class DiffDocCommand:
+    """Document comparison command."""
+
+    old_doc: Path
+    new_doc: Path
+    output_path: Path | None = None
+
+    def run(self) -> None:
+        """Run the document comparison command."""
+        if platform.system() != "Windows":
+            logger.error("This tool is only available on Windows.")
+            return
+        if not self.old_doc.exists():
+            logger.error(f"Old file does not exist: {self.old_doc}")
+            return
+
+        if not self.new_doc.exists():
+            logger.error(f"New file does not exist: {self.new_doc}")
+            return
+
+        if not self.validate_files:
+            logger.error("Invalid file paths or extensions")
+            return
+
+        if self.word_app is None:
+            logger.error("Word application is not available")
+            return
+
+        if self.compare_data is None:
+            return
+
+        self.output.parent.mkdir(parents=True, exist_ok=True)
+        try:
+            self.compare_data.SaveAs2(str(self.output))
+            self.compare_data.Close()
+        except Exception as e:
+            logger.exception(f"Comparison failed: {e}")
+        else:
+            logger.info(f"Comparison completed. Saved to: {self.output}")
+        finally:
+            try:
+                self.word_app.Documents.Close(SaveChanges=False)
+            except Exception:
+                logger.exception("Close document failed!")
+            else:
+                self.word_app.Quit()
+
+            try:
+                subprocess.run(
+                    ["taskkill", "/f", "/t", "/im", "WINWORD.EXE"], check=False
+                )
+            except Exception:
+                logger.exception("Taskkill failed!")
+            else:
+                logger.info("Taskkill completed successfully")
+
+    @cached_property
+    def word_app(self) -> Any:
+        try:
+            import win32com.client as win32  # type: ignore
+        except ImportError:
+            logger.exception("win32com.client is not installed, exiting.")
+            raise
+        else:
+            logger.info("Started Word application")
+            app = win32.gencache.EnsureDispatch("Word.Application")  # type: ignore
+            app.Visible = False
+            app.DisplayAlerts = False
+
+            try:
+                app.Options.TrackRevisions = conf.TRACK_REVISIONS
+            except AttributeError:
+                logger.warning(
+                    "TrackRevisions option not available in this Word version"
+                )
+
+            return app
+
+    @cached_property
+    def validate_files(self) -> bool:
+        return all([
+            self.old_doc.exists(),
+            self.new_doc.exists(),
+            self.old_doc.suffix.lower() in [".doc", ".docx"],
+            self.new_doc.suffix.lower() in [".doc", ".docx"],
+        ])
+
+    @cached_property
+    def compare_data(self) -> Any:
+        try:
+            compared = self.word_app.CompareDocuments(
+                self.old_doc_data,
+                self.new_doc_data,
+                0,
+                2 if conf.COMPARE_MODE == "revised" else 0,
+                True,
+            )
+        except Exception as e:
+            logger.exception(f"Comparison failed: {e}")
+            return None
+        else:
+            if compared:
+                logger.info("Comparison completed successfully")
+                compared.ShowRevisions = conf.SHOW_CHANGES
+                return compared
+            return None
+
+    @cached_property
+    def old_doc_data(self) -> Any:
+        logger.info(f"Opening old file: {self.old_doc}")
+        return self.word_app.Documents.Open(str(self.old_doc.resolve()))
+
+    @cached_property
+    def new_doc_data(self) -> Any:
+        logger.info(f"Opening new file: {self.new_doc}")
+        return self.word_app.Documents.Open(str(self.new_doc.resolve()))
+
+    @cached_property
+    def output(self) -> Path:
+        """Determine the output directory for the comparison result."""
+        output_filename = (
+            f"{conf.DOC_DIFF_TITLE}@{time.strftime('%Y%m%d_%H_%M_%S')}.docx"
+        )
+
+        if self.output_path is None:
+            output_dir = (
+                Path(conf.OUTPUT_DIR) if conf.OUTPUT_DIR else self.new_doc.parent
+            )
+            return output_dir / output_filename
+
+        if self.output_path.is_dir():
+            return self.output_path / output_filename
+        elif self.output_path.is_file():
+            return self.output_path
+        else:
+            raise ValueError(f"Invalid output path: {self.output_path}")
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description="Compare two doc/docx files.")
+    parser.add_argument(
+        "files", nargs=2, help="Two input files to compare (old_file new_file)"
+    )
+    parser.add_argument(
+        "-o", "--output", dest="output", default=".", help="Output file path"
+    )
+    parser.add_argument("--title", help="Title for the comparison result")
+    parser.add_argument(
+        "--show-changes", action="store_true", help="Show changes in the comparison"
+    )
+    parser.add_argument(
+        "--hide-changes", action="store_true", help="Hide changes in the comparison"
+    )
+    parser.add_argument(
+        "--compare-mode",
+        choices=["original", "revised"],
+        help="Compare mode: original or revised",
+    )
+    parser.add_argument("--output-dir", help="Output directory for the result file")
+
+    args = parser.parse_args()
+
+    # Update configuration from command line arguments
+    if args.title:
+        conf.DOC_DIFF_TITLE = args.title
+    if args.show_changes:
+        conf.SHOW_CHANGES = True
+    if args.hide_changes:
+        conf.SHOW_CHANGES = False
+    if args.compare_mode:
+        conf.COMPARE_MODE = args.compare_mode
+    if args.output_dir:
+        conf.OUTPUT_DIR = args.output_dir
+
+    return args
+
+
+def main() -> None:
+    """Compare two doc/docx files."""
+    args = parse_args()
+
+    DiffDocCommand(
+        Path(args.files[0]),
+        Path(args.files[1]),
+        Path(args.output),
+    ).run()

sfi/docscan/__init__.py

@@ -1,3 +1,3 @@
-"""Document scanner module for scanning and extracting content from various document formats."""
-
-__version__ = "0.1.11"
+"""Document scanner module for scanning and extracting content from various document formats."""
+
+__version__ = "0.1.13"