pysfi 0.1.12__py3-none-any.whl → 0.1.14__py3-none-any.whl

{pysfi-0.1.12.dist-info → pysfi-0.1.14.dist-info}/METADATA

@@ -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.14.dist-info/RECORD

@@ -0,0 +1,68 @@
+sfi/__init__.py,sha256=eGpIupcAG_5RqNCm908TwzDk-31Rhdn0iM-5Y2OwmIM,685
+sfi/cli.py,sha256=o-sFO6I3X3DMO2I_Gzc9LziWBdm2ruHXpjbraXGzZi0,933
+sfi/alarmclock/__init__.py,sha256=AUnUxITgFPYgSjn9ug2DEejrz5HDP56zZKYu-6JW1vY,72
+sfi/alarmclock/alarmclock.py,sha256=ixVkbg548smUivRsqyI3YSZ81BWIrKawnuezAp3BzyE,11635
+sfi/bumpversion/__init__.py,sha256=ExAxydqhwVCrA3YRid3JYult88HKsSTqYPt6996x0UU,122
+sfi/bumpversion/bumpversion.py,sha256=Uxj0S8ZGmIRhfCx2ziWkVe5gHv74r68UPkiYzZcAwxo,21288
+sfi/cleanbuild/__init__.py,sha256=_bXrBcQkHQTE2484-UMWAWz8kq-2Yjn9hleLcjF-pJg,98
+sfi/cleanbuild/cleanbuild.py,sha256=Ilk4zBE48y6tUC3C5qp1pXdQ6CF0NZlra4ZbdiU5s2k,5270
+sfi/condasetup/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+sfi/condasetup/condasetup.py,sha256=tuRzRi4NKmIfqN4Gq5w-VmY7BnleizPhAbYta8AzH4c,4976
+sfi/docdiff/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+sfi/docdiff/docdiff.py,sha256=YR8e-gkbvjH0Bjt5fVVW0-8b7lbinQs6TRo4B5XgEjE,7783
+sfi/docscan/__init__.py,sha256=eXv_iPeT_xOxv5lv4-axJQV28IISYYTqb6IRy3QTmIU,121
+sfi/docscan/docscan.py,sha256=hXSOrfMikyg-Zsi_mpZvn31ea1J0un90ftwpRoXxNdA,42765
+sfi/docscan/docscan_gui.py,sha256=KoXVHOQjUwtkxh5tI4V6mLBMl9PAP3Hp7zydJ_lppoQ,52345
+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=eOR6LCwYosO6qyThPNeSCNImiU19UTQaqNWTkFKHAfs,6227
+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=Rx8N9ZG2MrbzfiGAaZGEFlNGuOpP_gwNY5MmOSGTv3w,15198
+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=crbZ4qnq6BAAkba_dBVYVhI9hhd9yBQ7XlNsWIrAes8,18888
+sfi/llmserver/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+sfi/llmserver/llmserver.py,sha256=Fm4Go7wif4xMGomMFDsyJnYMafXsWemGkr-VfaeYa6w,13530
+sfi/makepython/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/makepython/makepython.py,sha256=GrzQTJyyB2PXugJK3yLxP1V5I_bSymW0qfkeqZvxRPA,43154
+sfi/pdfsplit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pdfsplit/pdfsplit.py,sha256=LOz7PuLlLBiXlFTjJej9G0UvJ03GZ9H-Gghy8ErvJzE,6576
+sfi/pyarchive/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+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=AJbMY4aHJq0YhyUXryBargNqCUTeSwaUuc3SiCcjcko,57685
+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=vDT_lVkq0eHeFCCR3pwjZGnF0EyQZDesM6ze--Tl194,22894
+sfi/pyprojectparse/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfi/pyprojectparse/pyprojectparse.py,sha256=qBHj8l-_ONxD4VA5KvCfXdvS3fbjfOls9gRX83I0TDE,30641
+sfi/pysourcepack/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+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
+pysfi-0.1.14.dist-info/METADATA,sha256=1fFxs9DSKrmVtp4oKAD5HWOQa9qV9hvxKSDyLNPTaKI,4198
+pysfi-0.1.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pysfi-0.1.14.dist-info/entry_points.txt,sha256=iPXOCvVm9O0_qaqFnlFFlwklWsK7K4LygikeAhnkf2I,1259
+pysfi-0.1.14.dist-info/RECORD,,

{pysfi-0.1.12.dist-info → pysfi-0.1.14.dist-info}/entry_points.txt

@@ -8,9 +8,11 @@ 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
+makepython = sfi.makepython.makepython:main
 mkp = sfi.makepython.makepython:main
 pdfsplit = sfi.pdfsplit.pdfsplit:main
 pyarchive = sfi.pyarchive.pyarchive:main
@@ -19,6 +21,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,20 @@
-"""Single File commands for Interactive python."""
+"""Single File commands for Interactive python.
 
-__version__ = "0.1.12"
+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__"]

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.12"
+from __future__ import annotations
+
+__version__ = "0.1.14"

sfi/bumpversion/bumpversion.py

@@ -11,6 +11,7 @@ import sys
 from dataclasses import dataclass
 from enum import Enum
 from pathlib import Path
+from re import Pattern
 from typing import Final
 
 try:
@@ -21,7 +22,8 @@ except ImportError:
 logging.basicConfig(level=logging.INFO, format="%(message)s")
 logger = logging.getLogger(__name__)
 
-VERSION_PATTERN: Final = re.compile(
+# Semantic versioning regex pattern
+VERSION_PATTERN: Final[Pattern[str]] = re.compile(
     r"(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?"
 )
 
@@ -69,7 +71,12 @@ class Version:
             buildmetadata=match.group("buildmetadata"),
         )
 
-    def bump(self, part: VersionPart, reset_prerelease: bool = True, prerelease: str | None = None) -> Version:
+    def bump(
+        self,
+        part: VersionPart,
+        reset_prerelease: bool = True,
+        prerelease: str | None = None,
+    ) -> Version:
         """Return a new version with specified part bumped."""
         # Determine the new prerelease value
         new_prerelease = None
@@ -121,7 +128,9 @@ class FileParser:
     """Parser for different file formats to extract and update version numbers."""
 
     @staticmethod
-    def _write_with_original_line_ending(file_path: Path, content: str, original_content: str) -> None:
+    def _write_with_original_line_ending(
+        file_path: Path, content: str, original_content: str
+    ) -> None:
         """Write content to file while preserving original line ending style.
 
         Args:
@@ -167,7 +176,9 @@ class FileParser:
         new_content = re.sub(pattern, new_version_str, content)
 
         # Write back preserving original line endings
-        FileParser._write_with_original_line_ending(file_path, new_content, original_bytes.decode("utf-8"))
+        FileParser._write_with_original_line_ending(
+            file_path, new_content, original_bytes.decode("utf-8")
+        )
 
     @staticmethod
     def parse_init_py(file_path: Path) -> tuple[Version, list[str]]:
@@ -285,7 +296,9 @@ class BumpversionManager:
             if projects_file.exists():
                 with projects_file.open("r", encoding="utf-8") as f:
                     projects_data = json.load(f)
-                self.subproject_paths = {self.root_path / p for p in projects_data.get("subprojects", [])}
+                self.subproject_paths = {
+                    self.root_path / p for p in projects_data.get("subprojects", [])
+                }
         except Exception:
             pass
 
@@ -313,10 +326,17 @@ class BumpversionManager:
         # Filter out unwanted directories
         excluded_dirs = {"__pycache__", ".venv", "venv", "env", ".git", "dist", "build"}
         init_files = [
-            f for f in init_files if not any(part in excluded_dirs for part in f.parts) and "tests" not in f.parts
+            f
+            for f in init_files
+            if not any(part in excluded_dirs for part in f.parts)
+            and "tests" not in f.parts
         ]
         # Exclude files inside subprojects defined in projects.json
-        init_files = [f for f in init_files if not any(str(f).startswith(str(sp)) for sp in self.subproject_paths)]
+        init_files = [
+            f
+            for f in init_files
+            if not any(str(f).startswith(str(sp)) for sp in self.subproject_paths)
+        ]
         detected_files.extend(init_files)
         for f in init_files:
             logger.info(f"Found: {f}")
@@ -442,7 +462,9 @@ class BumpversionManager:
         except (subprocess.CalledProcessError, FileNotFoundError):
             return False
 
-    def _git_commit(self, version: Version, message: str | None, files: list[Path]) -> None:
+    def _git_commit(
+        self, version: Version, message: str | None, files: list[Path]
+    ) -> None:
         """Commit version changes to git."""
         commit_message = message or f"chore: bump version to {version}"
 
@@ -458,7 +480,9 @@ class BumpversionManager:
         tag_name = f"v{version}"
 
         try:
-            subprocess.run(["git", "tag", "-a", tag_name, "-m", f"Version {version}"], check=True)
+            subprocess.run(
+                ["git", "tag", "-a", tag_name, "-m", f"Version {version}"], check=True
+            )
             logger.info(f"Git tag created: {tag_name}")
         except subprocess.CalledProcessError as e:
             logger.error(f"Git tag failed: {e}")
@@ -466,14 +490,39 @@ class BumpversionManager:
 
 def main() -> None:
     """Main entry point for bumpversion command."""
-    parser = argparse.ArgumentParser(prog="bumpversion", description="Automated version number management tool")
-    parser.add_argument("part", type=str, choices=["major", "minor", "patch"], help="Version part to bump")
-    parser.add_argument("--files", "-f", type=str, nargs="*", help="Specific files to update (default: auto-detect)")
-    parser.add_argument("--prerelease", "-p", type=str, help="Set prerelease tag (e.g., alpha, beta, rc1)")
-    parser.add_argument("--commit", "-c", action="store_true", help="Commit changes to git")
+    parser = argparse.ArgumentParser(
+        prog="bumpversion", description="Automated version number management tool"
+    )
+    parser.add_argument(
+        "part",
+        type=str,
+        choices=["major", "minor", "patch"],
+        help="Version part to bump",
+    )
+    parser.add_argument(
+        "--files",
+        "-f",
+        type=str,
+        nargs="*",
+        help="Specific files to update (default: auto-detect)",
+    )
+    parser.add_argument(
+        "--prerelease",
+        "-p",
+        type=str,
+        help="Set prerelease tag (e.g., alpha, beta, rc1)",
+    )
+    parser.add_argument(
+        "--commit", "-c", action="store_true", help="Commit changes to git"
+    )
     parser.add_argument("--tag", "-t", action="store_true", help="Create git tag")
     parser.add_argument("--message", "-m", type=str, help="Custom commit message")
-    parser.add_argument("--dry-run", "-n", action="store_true", help="Show what would be done without making changes")
+    parser.add_argument(
+        "--dry-run",
+        "-n",
+        action="store_true",
+        help="Show what would be done without making changes",
+    )
     parser.add_argument("--debug", "-d", action="store_true", help="Enable debug mode")
     args = parser.parse_args()
 

sfi/cleanbuild/__init__.py

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

sfi/cleanbuild/cleanbuild.py

@@ -13,6 +13,10 @@ from concurrent.futures import ThreadPoolExecutor, as_completed
 from dataclasses import dataclass, field
 from functools import cached_property
 from pathlib import Path
+from typing import Final
+
+# Folders to clean
+_BUILD_FOLDERS: Final[tuple[str, ...]] = ("build", "dist", ".venv", "node_modules")
 
 
 logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
@@ -20,7 +24,7 @@ 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:

sfi/cli.py

@@ -1,11 +1,32 @@
+from __future__ import annotations
+
 import argparse
 
-from sfi import __version__ as VERSION  # noqa: N812
+from sfi import __version__ as VERSION
+
+
+def main() -> None:
+    """Main entry point for the pysfi CLI tool.
 
+    Parses command line arguments and handles version printing.
 
-def main():
-    parser = argparse.ArgumentParser()
+    This is the central entry point for all pysfi subcommands.
+    Currently supports:
+    - Version information display
+
+    Future enhancements will include routing to specific
+    module commands based on subcommands.
+    """
+    parser = argparse.ArgumentParser(
+        prog="pysfi",
+        description="Python Single File Interactive - A collection of Python utility tools",
+        epilog="Use 'pysfi <command> --help' for more information on a specific command",
+    )
     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 @@
+