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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pysfi
-Version: 0.1.10
+Version: 0.1.11
 Summary: Single File commands for Interactive python.
 Requires-Python: >=3.8
 Requires-Dist: tomli>=2.4.0; python_version < '3.11'
@@ -47,10 +47,10 @@ pysfi is a Python project that provides single-file command-line utilities, desi
 
 - **alarmclk**: Alarm clock functionality
 - **[bumpversion](sfi/bumpversion/README.md)**: Automated version number management tool
-- **embedinstall**: Embed installation utilities
+- **pyembedinstall**: Embed installation utilities
 - **[filedate](sfi/filedate/README.md)**: A file date management tool that normalizes date prefixes in filenames
 - **mkp**: Make Python project utilities
-- **projectparse**: Project parsing and analysis tools
+- **pyprojectparse**: Project parsing and analysis tools
 - **pyloadergen**: Python loader code generation
 - **pypack**: Python packaging utilities
 
@@ -101,8 +101,8 @@ pysfi/
     │   ├── alarmclock.py
     │   ├── pyproject.toml
     │   └── __init__.py
-    ├── embedinstall/       # embedinstall command module
-    │   ├── embedinstall.py
+    ├── pyembedinstall/       # pyembedinstall command module
+    │   ├── pyembedinstall.py
     │   ├── pyproject.toml
     │   └── __init__.py
     ├── filedate/           # filedate command module
@@ -114,8 +114,8 @@ pysfi/
     │   ├── makepython.py
     │   ├── pyproject.toml
     │   └── __init__.py
-    ├── projectparse/       # projectparse command module
-    │   ├── projectparse.py
+    ├── pyprojectparse/       # pyprojectparse command module
+    │   ├── pyprojectparse.py
     │   ├── pyproject.toml
     │   └── __init__.py
     ├── pyloadergen/        # pyloadergen command module

pysfi-0.1.11.dist-info/RECORD

@@ -0,0 +1,60 @@
+sfi/__init__.py,sha256=W9IqwgCQr3sYmRyRC3ryCaJDJcMWBtyLzxp5CVsT3Nc,75
+sfi/cli.py,sha256=bUUTOg18sJQbSKSfsVANhlMgSj9yzO2txIzFAd9B2Ok,296
+sfi/alarmclock/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/alarmclock/alarmclock.py,sha256=0HoacKlGdYq_hINAdl54Cz2E_z6nNjPyqif2xcEBQss,12381
+sfi/bumpversion/__init__.py,sha256=j3XC03YiSDWRJV6UOcDWWsp09STfV5LrvzFkjsehSwA,86
+sfi/bumpversion/bumpversion.py,sha256=HOyHLaE0sZajrlcVZ8hsim8mPjz77qwQVSo6aIzjMXE,20735
+sfi/cleanbuild/cleanbuild.py,sha256=Fr6_cr3rj4llcEQ8yNTK-DHdSzmx1I4hYFJJHu5YEz0,5200
+sfi/condasetup/condasetup.py,sha256=RlbXVYcAJYMau-ZzHOMzHrHl4r-lqNZO0bT-zWuzP_k,4581
+sfi/docscan/__init__.py,sha256=qKkwfRoVBNMzNNdQk69QnFUrmJACtW9qbvoRloTDHfk,121
+sfi/docscan/docscan.py,sha256=rk8mjEI2SKNIliV-Yb41pfUmYBQ1tUhk5LHUNEjkszI,41890
+sfi/docscan/docscan_gui.py,sha256=T_blCyGGaWxL6rtjLIYW3nGdX8DpLQv73YbDnITR4eg,50671
+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/llmclient/llmclient.py,sha256=SnFZ9c2cNvFeLeobJV1ls7Ewftaam4s-HVBYW2tgHPo,21706
+sfi/llmquantize/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/llmquantize/llmquantize.py,sha256=ILmfdJg7Rc7xAygfcVgkSKJ_qRAHDRZXjBymYFBy6fg,17693
+sfi/llmserver/llmserver.py,sha256=vYEcNOV-OEvDULpzzCAJ0zHrXgqJFolOhqNdCZU0Bjs,11339
+sfi/makepython/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/makepython/makepython.py,sha256=87lySTg0j1lZNIJMf8U_Go_fkuLkuwGDUf6LUbR_r6c,11445
+sfi/pdfsplit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pdfsplit/pdfsplit.py,sha256=QWtW3GU28U2ZOyN5sCbH7jEMBpNbuAIzjXWOAXXW44M,6209
+sfi/pyarchive/pyarchive.py,sha256=1rkWY96U_DWbgTvdFGZto7dfutfhUo-OxmoVoaTo6WU,12892
+sfi/pyembedinstall/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pyembedinstall/pyembedinstall.py,sha256=kxp5YuwNHB29AVBMEJvzaIqTc7bEx-oBpKReGRJ1Pyw,23737
+sfi/pylibpack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pylibpack/pylibpack.py,sha256=lcGrzijibFFaJnxL8ZVALAGNHGs3g7-N4DO_AuiKwPs,54436
+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=R2E6YBCUwfgT3SLr7paBBYEcuySLaj1q_CTZC2slwWQ,39741
+sfi/pypack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pypack/pypack.py,sha256=-l3jc4akSSlgEmwiB-kITP0ioBBy42-taHkEsGNEQNw,35168
+sfi/pyprojectparse/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pyprojectparse/pyprojectparse.py,sha256=MLDuQm5LFZW-TQ_GfaaeFSa18lsQq5u2ZTjnlkFQ_Ao,19112
+sfi/pysourcepack/pysourcepack.py,sha256=qjBCFnY_3S7xwPgQ2GB0dr0WFbEj3uusZQ_udiU0Bok,9452
+sfi/quizbase/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/quizbase/quizbase.py,sha256=3tPUuYexZ9TVsNPPO_Itmr5OvyHSgY5OSUZwPoQt9zg,30605
+sfi/quizbase/quizbase_gui.py,sha256=7prc5tWkbUPzs1ofNc4xIC_aRrMCWB6RYN_NTq70p0Q,34729
+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=kRacCP78mDsZk44tfm4qblOplPxQuo3_6lHl6UQEmkU,7744
+sfi/which/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/which/which.py,sha256=zVIAwZA-pGGngxkkwZ6IxDX3ozVHg7cLSYwYO9FjaIc,2439
+sfi/workflowengine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/workflowengine/workflowengine.py,sha256=ck5PjyyjtWtbjN4ePEKsTWV6QR-BUlrfwrY6jih52jQ,17055
+pysfi-0.1.11.dist-info/METADATA,sha256=4dkuiM92FRkYo-8ti_ZEmAxq1eoFa6HF0xs8ErJyc68,4047
+pysfi-0.1.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pysfi-0.1.11.dist-info/entry_points.txt,sha256=FhBsBY75x9e-AAyJ0t0HD1rb90FDllsM_IdVGHWZx9o,1099
+pysfi-0.1.11.dist-info/RECORD,,

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

@@ -1,18 +1,28 @@
 [console_scripts]
 alarmclk = sfi.alarmclock.alarmclock:main
 bumpversion = sfi.bumpversion.bumpversion:main
+cleanbuild = sfi.cleanbuild.cleanbuild:main
+condasetup = sfi.condasetup.condasetup:main
 docscan = sfi.docscan.docscan:main
 docscan-gui = sfi.docscan.docscan_gui:main
-embedinstall = sfi.embedinstall.embedinstall: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
-projectparse = sfi.projectparse.projectparse: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

sfi/__init__.py

@@ -1,3 +1,3 @@
 """Single File commands for Interactive python."""
 
-__version__ = "0.1.10"
+__version__ = "0.1.11"

sfi/alarmclock/alarmclock.py

@@ -4,9 +4,9 @@ import argparse
 import logging
 import random
 import sys
+from dataclasses import dataclass
 from datetime import datetime, timedelta, timezone
 from functools import partial
-from typing import ClassVar
 
 import qdarkstyle
 from PySide2.QtCore import QSize, Qt, QTime, QTimer
@@ -24,42 +24,42 @@ from PySide2.QtWidgets import (
     QWidget,
 )
 
-__version__ = "0.1.2"
-__build_date__ = "2025-09-16"
+__version__ = "0.1.3"
+__build_date__ = "2026-01-22"
 
 
+@dataclass(frozen=True)
 class AlarmClockConfig:
-    """Alarm clock configuration."""
-
-    ALARM_CLOCK_TITLE = "Digital Alarm Clock"
+    """Configuration for the alarm clock application."""
 
+    ALARM_CLOCK_TITLE: str = "Digital Alarm Clock"
     DIGITAL_FONT: str = "bold italic 81px 'Consolas'"
     DIGITAL_COLOR: str = "#ccee00"
-    DIGITAL_BORDER_COLORS: ClassVar[list[str]] = [
+    DIGITAL_BORDER_COLORS: tuple[str, ...] = (
         "#00aa00",
         "#eecc00",
         "#aa00aa",
         "#c0e0b0",
-    ]
+    )
     DIGITAL_TIMER_FORMAT: str = "%H:%M:%S"
     DIGITAL_UPDATE_INTERVAL: int = 1000
 
     BLINK_TITLE: str = "Alarm Reminder!"
     BLINK_CONTENT: str = "⏰ Time's Up!"
     BLINK_TYPE: str = "color"  # Options: 'color' or 'opacity'
-    BLINK_BG_COLORS: ClassVar[list[str]] = [
+    BLINK_BG_COLORS: tuple[str, ...] = (
         "#baf1ba",
         "#f8ccc3",
         "#aab4f0",
         "#efaec0",
-    ]
-    BLINK_INTERVAL: ClassVar[int] = 300  # ms
-    DELAY_STEPS: ClassVar[list[int]] = [1, 5, 10, 15, 30, 60]  # minutes
+    )
+    BLINK_INTERVAL: int = 300  # ms
+    DELAY_STEPS: tuple[int, ...] = (1, 5, 10, 15, 30, 60)  # minutes
 
 
 logging.basicConfig(level=logging.INFO, format="%(message)s")
 
-conf = AlarmClockConfig()
+config = AlarmClockConfig()
 logger = logging.getLogger(__name__)
 
 
@@ -69,30 +69,30 @@ class DigitalClock(QLabel):
     def __init__(self, parent: QWidget | None = None) -> None:
         super().__init__(parent)
 
-        self.setAlignment(Qt.AlignCenter)  # type: ignore
+        self.setAlignment(Qt.AlignCenter)
 
-        self._color = conf.DIGITAL_BORDER_COLORS[0]
+        self._color = config.DIGITAL_BORDER_COLORS[0]
 
         # Timer to update current time
         self._timer = QTimer()
-        self._timer.timeout.connect(self.update_time)  # type: ignore
-        self._timer.start(conf.DIGITAL_UPDATE_INTERVAL)  # Update every second
+        self._timer.timeout.connect(self.update_time)
+        self._timer.start(config.DIGITAL_UPDATE_INTERVAL)  # Update every second
 
         self.update_time()
 
     def update_time(self) -> None:
         """Update current time display."""
         current = datetime.now(timezone.utc) + timedelta(hours=8)  # Beijing time
-        self.setText(current.strftime(conf.DIGITAL_TIMER_FORMAT))
+        self.setText(current.strftime(config.DIGITAL_TIMER_FORMAT))
         logger.debug(f"Updated time: {current}")
 
         # Add blink effect
         self._color = random.choice(
-            [_ for _ in conf.DIGITAL_BORDER_COLORS if _ != self._color],
+            [_ for _ in config.DIGITAL_BORDER_COLORS if _ != self._color],
         )
         self.setStyleSheet(f"""
-            font: {conf.DIGITAL_FONT};
-            color: {conf.DIGITAL_COLOR};
+            font: {config.DIGITAL_FONT};
+            color: {config.DIGITAL_COLOR};
             background-color: black;
             border: 2px dashed {self._color};
             border-radius: 10px;
@@ -106,47 +106,47 @@ class BlinkDialog(QDialog):
     def __init__(self) -> None:
         super().__init__()
 
-        self.setWindowTitle(conf.BLINK_TITLE)
+        self.setWindowTitle(config.BLINK_TITLE)
         self.setModal(True)
         self.setWindowFlags(
-            self.windowFlags() | Qt.WindowStaysOnTopHint | Qt.WindowType.Dialog,  # type: ignore
+            self.windowFlags() | Qt.WindowStaysOnTopHint | Qt.WindowType.Dialog,
         )
         self.setFixedSize(QSize(400, 240))
 
         layout = QVBoxLayout()
-        msg_label = QLabel(conf.BLINK_CONTENT)
+        msg_label = QLabel(config.BLINK_CONTENT)
         msg_label.setStyleSheet("""
             color: red;
             font-size: 24px;
         """)
-        msg_label.setAlignment(Qt.AlignmentFlag.AlignCenter)  # type: ignore
+        msg_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
 
         close_button = QPushButton("Close Alarm")
-        close_button.clicked.connect(self.accept)  # type: ignore
+        close_button.clicked.connect(self.accept)
 
         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)  # type: ignore
+        self.setWindowFlag(Qt.WindowCloseButtonHint, False)
 
         # Blink control variables and timer
         self.blink_timer = QTimer(self)
-        self.blink_timer.timeout.connect(self.update_blink)  # type: ignore
+        self.blink_timer.timeout.connect(self.update_blink)
         self.blink_state = False
-        self.blink_type = conf.BLINK_TYPE
+        self.blink_type = config.BLINK_TYPE
 
         # Initialize style
-        self.bg_color = random.choice(conf.BLINK_BG_COLORS)
+        self.bg_color = random.choice(config.BLINK_BG_COLORS)
         self.origin_style = self.styleSheet()
-        self.blink_timer.start(conf.BLINK_INTERVAL)
+        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 conf.BLINK_BG_COLORS[:] if _ != self.bg_color]
+            colors = [_ for _ in config.BLINK_BG_COLORS[:] if _ != self.bg_color]
             self.setStyleSheet(f"background-color: {random.choice(colors)}")
         elif self.blink_type == "opacity":
             # Opacity blink logic - Note: Some systems may not fully support window opacity
@@ -172,7 +172,7 @@ class AlarmClock(QMainWindow):
 
     def __init__(self) -> None:
         super().__init__()
-        self.setWindowTitle(f"{conf.ALARM_CLOCK_TITLE} v{__version__}")
+        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,
@@ -238,7 +238,7 @@ class AlarmClock(QMainWindow):
         self.alarm_time_edit = QTimeEdit()
         self.alarm_time_edit.setDisplayFormat("HH:mm:ss")
         self.alarm_time_edit.setTime(
-            QTime.currentTime().addSecs(conf.DELAY_STEPS[0] * 60),
+            QTime.currentTime().addSecs(config.DELAY_STEPS[0] * 60),
         )
 
         time_layout.addWidget(time_label)
@@ -249,10 +249,10 @@ class AlarmClock(QMainWindow):
         delay_label = QLabel("Delay (min):")
         delay_label.setStyleSheet("color: white; font-size: 16px;")
         delay_layout.addWidget(delay_label)
-        for minutes in conf.DELAY_STEPS:
+        for minutes in config.DELAY_STEPS:
             button = QPushButton(str(minutes))
             button.setStyleSheet("color: white; font-size: 16px;")
-            button.clicked.connect(partial(self.set_delay, minutes))  # type: ignore
+            button.clicked.connect(partial(self.set_delay, minutes))
             delay_layout.addWidget(button)
         main_layout.addLayout(delay_layout)
 
@@ -263,9 +263,9 @@ class AlarmClock(QMainWindow):
         # Control buttons
         button_layout = QHBoxLayout()
         self.set_alarm_button = QPushButton("Set Alarm")
-        self.set_alarm_button.clicked.connect(self.set_alarm)  # type: ignore
+        self.set_alarm_button.clicked.connect(self.set_alarm)
         self.cancel_alarm_button = QPushButton("Cancel Alarm")
-        self.cancel_alarm_button.clicked.connect(self.cancel_alarm)  # type: ignore
+        self.cancel_alarm_button.clicked.connect(self.cancel_alarm)
         self.cancel_alarm_button.setEnabled(False)
         button_layout.addWidget(self.set_alarm_button)
         button_layout.addWidget(self.cancel_alarm_button)
@@ -273,13 +273,13 @@ class AlarmClock(QMainWindow):
 
         # Status display
         self.status_label = QLabel("Alarm not set")
-        self.status_label.setAlignment(Qt.AlignCenter)  # type: ignore
+        self.status_label.setAlignment(Qt.AlignCenter)
         self.status_label.setStyleSheet("color: #aaaaaa; font-size: 16px;")
         main_layout.addWidget(self.status_label)
 
         # Alarm timer
         self.alarm_timer = QTimer()
-        self.alarm_timer.timeout.connect(self.check_alarm)  # type: ignore
+        self.alarm_timer.timeout.connect(self.check_alarm)
 
         # Alarm state
         self.alarm_set = False

sfi/bumpversion/__init__.py

@@ -1,3 +1,3 @@
 """Bumpversion - Automated version number management tool."""
 
-__version__ = "0.1.10"
+__version__ = "0.1.11"

sfi/cleanbuild/cleanbuild.py

@@ -0,0 +1,155 @@
+"""Clean build folders, such as .venv, node_modules, dist, build, etc."""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import os
+import shutil
+import stat
+import time
+from collections import Counter
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from dataclasses import dataclass, field
+from functools import cached_property
+from pathlib import Path
+
+
+logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
+logger = logging.getLogger(__name__)
+
+CWD = Path.cwd()
+PROJECT_ROOT = Path(__file__).parent.parent.parent
+_BUILD_FOLDERS = ("build", "dist", ".venv", "node_modules")
+
+@dataclass(frozen=True)
+class SearchResult:
+    """Search result for build folders."""
+
+    root_dir: Path = field(default_factory=Path)
+    folders_to_delete: list[Path] = field(default_factory=list)
+    folders_to_skip: list[Path] = field(default_factory=list)
+
+    def __repr__(self) -> str:
+        return f"<SearchResult: root={self.root_dir}>, delete={self.delete_counter}, skip={self.skip_counter}\n>"
+
+    @cached_property
+    def delete_counter(self) -> Counter:
+        """Get the most common folder names."""
+        return Counter([folder.name for folder in self.folders_to_delete])
+
+    @cached_property
+    def skip_counter(self) -> Counter:
+        """Get the most common folder names."""
+        return Counter([folder.name for folder in self.folders_to_skip])
+
+    @cached_property
+    def delete_count(self) -> int:
+        """Get the total number of folders to delete."""
+        return len(self.folders_to_delete)
+
+    def perform_delete(self):
+        """Perform the delete operation."""
+        t0 = time.perf_counter()
+        deleted_count = 0
+        failed_folders = []
+        with ThreadPoolExecutor(max_workers=4) as executor:
+            future_to_folder = {
+                executor.submit(SearchResult.delete_folder, folder): folder
+                for folder in self.folders_to_delete
+            }
+            for future in as_completed(future_to_folder):
+                folder, error = future.result()
+                if error:
+                    logger.error(f"Error deleting {folder}: {error}")
+                    failed_folders.append(folder)
+                else:
+                    logger.info(f"Deleted {folder}")
+                    deleted_count += 1
+
+        if failed_folders:
+            logger.warning(f"Failed to delete {len(failed_folders)} folders")
+        logger.info(f"Successfully deleted {deleted_count}/{self.delete_count} folders")
+        logger.info(f"Time taken: {time.perf_counter() - t0:.4f}s")
+
+    @staticmethod
+    def handle_remove_readonly(func, path, _):
+        """Handle Windows readonly files when removing."""
+        try:
+            os.chmod(path, stat.S_IWUSR)
+            func(path)
+        except OSError:
+            if not os.path.exists(path):
+                pass
+            else:
+                raise
+
+    @staticmethod
+    def delete_folder(folder: Path):
+        """Delete a single folder with error handling."""
+        try:
+            shutil.rmtree(folder, onerror=SearchResult.handle_remove_readonly)
+            return folder, None
+        except Exception as e:
+            return folder, e
+
+    @staticmethod
+    def is_target_folder(entry: Path) -> bool:
+        """Check if a path is a build folder."""
+        return entry.is_dir() and entry.name in _BUILD_FOLDERS
+
+    @staticmethod
+    def from_path(directory: Path) -> SearchResult:
+        """Create a SearchResult from a path."""
+        logger.info(f"Searching for build folders in {directory}")
+
+        folders_to_delete = []
+        folders_to_skip = []
+        for root, dirs, _ in os.walk(directory, onerror=lambda _: None):
+            root_path = Path(root)
+            for dir_name in dirs:
+                entry = root_path / dir_name
+                if entry == PROJECT_ROOT / ".venv":
+                    folders_to_skip.append(entry)
+                    continue
+                elif SearchResult.is_target_folder(entry):
+                    folders_to_delete.append(entry)
+
+        result = SearchResult(
+            root_dir=directory,
+            folders_to_delete=folders_to_delete,
+            folders_to_skip=folders_to_skip,
+        )
+        logger.info(f"Found {result.delete_count} build folders to delete")
+        logger.info(f"Summary: {result}")
+        return result
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description="Clean build folders")
+    parser.add_argument(
+        "directory", type=str, nargs="?", default=str(CWD), help="Directory to clean"
+    )
+    parser.add_argument("--yes", "-y", action="store_true", help="Skip confirmation")
+    return parser.parse_args()
+
+
+def main():
+    args = parse_args()
+
+    result = SearchResult.from_path(Path(args.directory))
+    if not args.yes:
+        logger.info(
+            f"\nAre you sure you want to clean build folders in {args.directory}? (y/n) [n]"
+        )
+        choice = input().lower()
+        if choice != "y":
+            logger.info("Dry run, no changes will be made")
+            return
+
+    logger.info("Running clean build")
+    result.perform_delete()
+
+
+if __name__ == "__main__":
+    main()

sfi/condasetup/condasetup.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+import argparse
+import logging
+import os
+from pathlib import Path
+
+logging.basicConfig(level=logging.INFO, format="%(message)s")
+logger = logging.getLogger(__name__)
+cwd = Path.cwd()
+
+_CONDA_MIRROR_URLS: dict[str, frozenset[str]] = {
+    "tsinghua": frozenset(
+        [
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/pro/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/menpo/",
+            "https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/",
+        ]
+    ),
+    "ustc": frozenset(
+        [
+            "https://mirrors.ustc.edu.cn/anaconda/pkgs/main/",
+            "https://mirrors.ustc.edu.cn/anaconda/pkgs/free/",
+            "https://mirrors.ustc.edu.cn/anaconda/pkgs/r/",
+            "https://mirrors.ustc.edu.cn/anaconda/pkgs/msys2/",
+            "https://mirrors.ustc.edu.cn/anaconda/pkgs/pro/",
+            "https://mirrors.ustc.edu.cn/anaconda/pkgs/dev/",
+            "https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge/",
+            "https://mirrors.ustc.edu.cn/anaconda/cloud/bioconda/",
+            "https://mirrors.ustc.edu.cn/anaconda/cloud/menpo/",
+            "https://mirrors.ustc.edu.cn/anaconda/cloud/pytorch/",
+        ]
+    ),
+    "bsfu": frozenset(
+        [
+            "https://mirrors.bsfu.edu.cn/anaconda/pkgs/main/",
+            "https://mirrors.bsfu.edu.cn/anaconda/pkgs/free/",
+            "https://mirrors.bsfu.edu.cn/anaconda/pkgs/r/",
+            "https://mirrors.bsfu.edu.cn/anaconda/pkgs/msys2/",
+            "https://mirrors.bsfu.edu.cn/anaconda/pkgs/pro/",
+            "https://mirrors.bsfu.edu.cn/anaconda/pkgs/dev/",
+            "https://mirrors.bsfu.edu.cn/anaconda/cloud/conda-forge/",
+            "https://mirrors.bsfu.edu.cn/anaconda/cloud/bioconda/",
+            "https://mirrors.bsfu.edu.cn/anaconda/cloud/menpo/",
+            "https://mirrors.bsfu.edu.cn/anaconda/cloud/pytorch/",
+        ]
+    ),
+    "aliyun": frozenset(
+        [
+            "https://mirrors.aliyun.com/anaconda/pkgs/main/",
+            "https://mirrors.aliyun.com/anaconda/pkgs/free/",
+            "https://mirrors.aliyun.com/anaconda/pkgs/r/",
+            "https://mirrors.aliyun.com/anaconda/pkgs/msys2/",
+            "https://mirrors.aliyun.com/anaconda/pkgs/pro/",
+            "https://mirrors.aliyun.com/anaconda/pkgs/dev/",
+            "https://mirrors.aliyun.com/anaconda/cloud/conda-forge/",
+            "https://mirrors.aliyun.com/anaconda/cloud/bioconda/",
+            "https://mirrors.aliyun.com/anaconda/cloud/menpo/",
+            "https://mirrors.aliyun.com/anaconda/cloud/pytorch/",
+        ]
+    ),
+}
+
+
+def set_conda_mirror(mirror: str = "tsinghua") -> None:
+    """Set the Conda mirror for the given channel."""
+    if mirror in _CONDA_MIRROR_URLS:
+        old_config = Path.home() / ".condarc"
+        if old_config.exists():
+            logger.info("Found existing .condarc file, backing it up")
+            os.rename(old_config, Path.home() / ".condarc.bak")
+        else:
+            logger.debug("No existing .condarc file found")
+
+        mirror_urls = _CONDA_MIRROR_URLS[mirror]
+        for url in mirror_urls:
+            logger.debug(f"Adding mirror: {url}")
+            os.system(f"conda config --add channels {url}")
+        os.system("conda config --set show_channel_urls yes")
+        logger.info("Conda mirror set successfully")
+    else:
+        logger.error(f"Invalid mirror: {mirror}")
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description="Setup Conda environment for SFI")
+    parser.add_argument(
+        "mirror",
+        type=str,
+        choices=["tsinghua", "ustc", "bsfu", "aliyun"],
+        nargs="?",
+        default="tsinghua",
+        help="Conda mirror to use",
+    )
+    parser.add_argument("-d", "--debug", help="Debug mode", action="store_true")
+
+    return parser.parse_args()
+
+
+def main():
+    args = parse_args()
+
+    if args.debug:
+        logger.setLevel(logging.DEBUG)
+
+    set_conda_mirror(args.mirror)
+
+
+if __name__ == "__main__":
+    main()

sfi/docscan/__init__.py

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

sfi/docscan/docscan_gui.py

@@ -86,7 +86,7 @@ def t(key: str, **kwargs) -> str:
             try:
                 from src.docscan.lang.eng import ENGLISH_DEFAULTS
             except ImportError:
-                ENGLISH_DEFAULTS = {}
+                ENGLISH_DEFAULTS = {}  # noqa: N806
 
         text = ENGLISH_DEFAULTS.get(key, key)
     else: