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

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

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

{pysfi-0.1.13.dist-info → pysfi-0.1.15.dist-info}/RECORD

@@ -1,43 +1,45 @@
-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/__init__.py,sha256=TVJQhNdT9_xTAmwbMdf5rw-JogSq0EdM2iR-igNIHLk,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=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/bumpversion/__init__.py,sha256=yAaQaGUKnwPERhTaS4XXANQc9AT31nseY2dKomRPRmU,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=v7sLqtKfRfuxZ4bAKVvR5FBc_SX44W9MOBL_vmmAuss,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=5FARcsB2Rlz2uTBxeYYjbIEJb9l1cyXj9WSoNKvSrRo,6068
+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=rR6f5bMg-HoKMvSyu2rWfDbx0kmo6F6e1dg5z3710Wo,15129
+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=N4h0RwdpVZdZM3qDWbL34hLGpQ3XuPkP_F8kyhhM8ZI,18855
-sfi/llmserver/__init__.py,sha256=a99mtb8qROZYvqLuhmlasVCgbmAL9nzVzOJFrVSWLGE,3
+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=srinUE1Yr6zF-NjiUFVC1sUrpy8fYpDnCs7p648jWqc,23278
+sfi/makepython/makepython.py,sha256=GrzQTJyyB2PXugJK3yLxP1V5I_bSymW0qfkeqZvxRPA,43154
+sfi/pdfcrypt/__init__.py,sha256=cKY_rosu4Qo0QvJF5d_vFgvMMcH14JH6uElOMRXo654,565
+sfi/pdfcrypt/pdfcrypt.py,sha256=s7LMABQt4gW8UabuwdKdy_hgmSa8ZDePFrtab3tEkEA,13236
 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/pdfsplit/pdfsplit.py,sha256=LOz7PuLlLBiXlFTjJej9G0UvJ03GZ9H-Gghy8ErvJzE,6576
+sfi/pyarchive/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+sfi/pyarchive/pyarchive.py,sha256=ne8FZh79_0ZtIWCG6Ddg9uUF6JxTvFsvfilOLl4wYmI,38280
 sfi/pyembedinstall/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sfi/pyembedinstall/pyembedinstall.py,sha256=LHnuvr63DXuntdS6a_7uQynOfarK-30WBUerSzawSHE,24171
+sfi/pyembedinstall/pyembedinstall.py,sha256=1XOTR6Mg2YtP_-t9jRjiNGSSTw5TklDO60XPc3I9TL0,24158
 sfi/pylibpack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sfi/pylibpack/pylibpack.py,sha256=qK6J2_0VLMWQsKjcZ5njsvfqCnMRmGx8RweH2olhWTo,57818
+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
@@ -45,13 +47,13 @@ sfi/pylibpack/rules/pyside2.json,sha256=uSSteT-3wDohWwQ36Z5mSOaSbxrR4565In4uZj_e
 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/pyloadergen/pyloadergen.py,sha256=NiQGk4I5LMNvEaMc9aasXKHGNSg127AcUR5hmDPm6sQ,45801
 sfi/pypack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sfi/pypack/pypack.py,sha256=3LTCZMk8TqYhJbGv9AMLbe_Vi6bV7-cQUuHrWWO7QZU,22385
+sfi/pypack/pypack.py,sha256=v2qdSGL4cANO28mbaJSGbThiyJG33djsTcVy9RlwDgc,23031
 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/pyprojectparse/pyprojectparse.py,sha256=XPY1E3mW6qkvuAlGBK8fpTfPQJYkWpQFcYZTZ4IlROk,29784
+sfi/pysourcepack/__init__.py,sha256=4W8VliAYUP1KY2gLJ_YDy2TmcXYVm-PY7XikQD_bFwA,2
+sfi/pysourcepack/pysourcepack.py,sha256=HNhO0Ry3kAzZJ5-bXlxn81jrh_GdjKzWFOyz7SQhN1Q,12158
 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
@@ -62,9 +64,7 @@ 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.15.dist-info/METADATA,sha256=LyUkSywzxLXVtmVvhzMuSKMxEo5EApdoyHk6q3eFcA0,4198
+pysfi-0.1.15.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pysfi-0.1.15.dist-info/entry_points.txt,sha256=j0zUSQnJ1YpYEKTK0oEICBjIyOAVZOd5Ss2_k0id530,1297
+pysfi-0.1.15.dist-info/RECORD,,

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

@@ -12,7 +12,9 @@ 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
+pdfcrypt = sfi.pdfcrypt.pdfcrypt:main
 pdfsplit = sfi.pdfsplit.pdfsplit:main
 pyarchive = sfi.pyarchive.pyarchive:main
 pyembedinstall = sfi.pyembedinstall.pyembedinstall:main

sfi/__init__.py

@@ -1,5 +1,20 @@
-"""Single File commands for Interactive python."""
-
-from __future__ import annotations
-
-__version__ = "0.1.13"
+"""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.15"
+__all__ = ["__version__"]

sfi/alarmclock/__init__.py

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

sfi/bumpversion/__init__.py

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

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

@@ -1,3 +1,3 @@
-"""Cleanbuild - Clean build artifacts and temporary files."""
-
-from __future__ import annotations
+"""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

@@ -2,15 +2,26 @@ 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.
+
+    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()
+    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",

sfi/condasetup/__init__.py

@@ -1 +1 @@
- 
+ 

sfi/condasetup/condasetup.py

@@ -3,92 +3,106 @@ from __future__ import annotations
 import argparse
 import logging
 import os
+import subprocess
 from pathlib import Path
+from typing import Final
 
 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/",
-        ]
-    ),
+
+# Conda mirror URLs
+_CONDA_MIRROR_URLS: Final[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:
+    """Set the Conda mirror for the given channel.
+
+    Args:
+        mirror: Mirror name (tsinghua, ustc, bsfu, or aliyun)
+    """
+    if mirror not in _CONDA_MIRROR_URLS:
         logger.error(f"Invalid mirror: {mirror}")
+        return
+
+    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}")
+        try:
+            subprocess.run(["conda", "config", "--add", "channels", url], check=True)
+        except subprocess.CalledProcessError as e:
+            logger.error(f"Failed to add mirror {url}: {e}")
+            return
+
+    try:
+        subprocess.run(
+            ["conda", "config", "--set", "show_channel_urls", "yes"], check=True
+        )
+        logger.info("Conda mirror set successfully")
+    except subprocess.CalledProcessError as e:
+        logger.error(f"Failed to set show_channel_urls: {e}")
+
 
+def parse_args() -> argparse.Namespace:
+    """Parse command line arguments.
 
-def parse_args():
+    Returns:
+        Parsed arguments
+    """
     parser = argparse.ArgumentParser(description="Setup Conda environment for SFI")
     parser.add_argument(
         "mirror",
@@ -103,7 +117,8 @@ def parse_args():
     return parser.parse_args()
 
 
-def main():
+def main() -> None:
+    """Main entry point for condasetup CLI."""
     args = parse_args()
 
     if args.debug:

sfi/docdiff/__init__.py

@@ -1 +1 @@
- 
+ 

sfi/docdiff/docdiff.py

@@ -10,9 +10,10 @@ import time
 from dataclasses import dataclass
 from functools import cached_property
 from pathlib import Path
-from typing import Any
+from typing import Any, Final
 
-CONFIG_FILE = Path.home() / ".pysfi" / "docdiff.json"
+# Configuration file path
+CONFIG_FILE: Final[Path] = Path.home() / ".pysfi" / "docdiff.json"
 
 logging.basicConfig(level=logging.INFO, format="%(message)s")
 logger = logging.getLogger(__name__)

sfi/docscan/__init__.py

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