py2ls 0.2.4.37__py3-none-any.whl → 0.2.4.40__py3-none-any.whl

py2ls/ips.py

@@ -26,6 +26,7 @@ import re
 import stat
 import platform
 
+
 # only for backup these scripts
 def backup(
     src="/Users/macjianfeng/Dropbox/github/python/py2ls/.venv/lib/python3.12/site-packages/py2ls/",
@@ -33,14 +34,16 @@ def backup(
     kind="py",
     overwrite=True,
     reverse=False,
-    verbose=False
-):  
+    verbose=False,
+):
     if reverse:
-        src, tar = tar,src
+        src, tar = tar, src
         print(f"reversed")
-    f = listdir(src, kind, verbose=verbose)
+    f = listdir(src, kind=kind, verbose=verbose)
     [copy(i, tar, overwrite=overwrite, verbose=verbose) for i in f.path]
-    print(f"all files are copied from {os.path.basename(src)} to {tar}") if verbose else None
+
+    print(f"backup '*.{kind}'...\nfrom {src} \nto {tar}")
+
 
 def run_once_within(duration=60, reverse=False):  # default 60s
     import time
@@ -804,14 +807,16 @@ def strcmp(
     return candidates[best_match_index], best_match_index
 
 
-def imgcmp(img: list, 
-           method:str ="knn", 
-           thr:float =0.75,
-           detector: str = "sift", 
-           plot_:bool =True, 
-           figsize=[12, 6],
-           grid_size=10,# only for grid detector
-           **kwargs):
+def imgcmp(
+    img: list,
+    method: str = "knn",
+    thr: float = 0.75,
+    detector: str = "sift",
+    plot_: bool = True,
+    figsize=[12, 6],
+    grid_size=10,  # only for grid detector
+    **kwargs,
+):
     """
     Compare two images using SSIM, Feature Matching (SIFT), or KNN Matching.
 
@@ -832,13 +837,13 @@ def imgcmp(img: list,
     from skimage.metrics import structural_similarity as ssim
 
     # Load images
-    if isinstance(img, list) and isinstance(img[0],str):
+    if isinstance(img, list) and isinstance(img[0], str):
         image1 = cv2.imread(img[0])
         image2 = cv2.imread(img[1])
-        bool_cvt=True
+        bool_cvt = True
     else:
-        image1, image2 = np.array(img[0]),np.array(img[1])
-        bool_cvt=False
+        image1, image2 = np.array(img[0]), np.array(img[1])
+        bool_cvt = False
 
     if image1 is None or image2 is None:
         raise ValueError("Could not load one or both images. Check file paths.")
@@ -873,7 +878,7 @@ def imgcmp(img: list,
     elif method in ["match", "knn"]:
         # Convert images to grayscale
         gray1 = cv2.cvtColor(image1, cv2.COLOR_BGR2GRAY)
-        gray2 = cv2.cvtColor(image2, cv2.COLOR_BGR2GRAY) 
+        gray2 = cv2.cvtColor(image2, cv2.COLOR_BGR2GRAY)
 
         if detector == "sift":
             # SIFT detector
@@ -888,11 +893,19 @@ def imgcmp(img: list,
 
             for i in range(0, gray1.shape[0], grid_size):
                 for j in range(0, gray1.shape[1], grid_size):
-                    patch1 = gray1[i:i + grid_size, j:j + grid_size]
-                    patch2 = gray2[i:i + grid_size, j:j + grid_size]
+                    patch1 = gray1[i : i + grid_size, j : j + grid_size]
+                    patch2 = gray2[i : i + grid_size, j : j + grid_size]
                     if patch1.size > 0 and patch2.size > 0:
-                        keypoints1.append(cv2.KeyPoint(j + grid_size // 2, i + grid_size // 2, grid_size))
-                        keypoints2.append(cv2.KeyPoint(j + grid_size // 2, i + grid_size // 2, grid_size))
+                        keypoints1.append(
+                            cv2.KeyPoint(
+                                j + grid_size // 2, i + grid_size // 2, grid_size
+                            )
+                        )
+                        keypoints2.append(
+                            cv2.KeyPoint(
+                                j + grid_size // 2, i + grid_size // 2, grid_size
+                            )
+                        )
                         descriptors1.append(np.mean(patch1))
                         descriptors2.append(np.mean(patch2))
 
@@ -903,12 +916,20 @@ def imgcmp(img: list,
             # Pixel-based direct comparison
             descriptors1 = gray1.flatten()
             descriptors2 = gray2.flatten()
-            keypoints1 = [cv2.KeyPoint(x, y, 1) for y in range(gray1.shape[0]) for x in range(gray1.shape[1])]
-            keypoints2 = [cv2.KeyPoint(x, y, 1) for y in range(gray2.shape[0]) for x in range(gray2.shape[1])]
+            keypoints1 = [
+                cv2.KeyPoint(x, y, 1)
+                for y in range(gray1.shape[0])
+                for x in range(gray1.shape[1])
+            ]
+            keypoints2 = [
+                cv2.KeyPoint(x, y, 1)
+                for y in range(gray2.shape[0])
+                for x in range(gray2.shape[1])
+            ]
 
         else:
             raise ValueError("Invalid detector. Use 'sift', 'grid', or 'pixel'.")
- 
+
         # Handle missing descriptors
         if descriptors1 is None or descriptors2 is None:
             raise ValueError("Failed to compute descriptors for one or both images.")
@@ -955,16 +976,26 @@ def imgcmp(img: list,
         # Apply the homography to image2
         try:
             # Calculate Homography using RANSAC
-            homography_matrix, mask = cv2.findHomography(src_pts, dst_pts, cv2.RANSAC, 5.0)
+            homography_matrix, mask = cv2.findHomography(
+                src_pts, dst_pts, cv2.RANSAC, 5.0
+            )
             h, w = image1.shape[:2]
             warped_image2 = cv2.warpPerspective(image2, homography_matrix, (w, h))
 
             # Plot result if needed
             if plot_:
                 fig, ax = plt.subplots(1, 2, figsize=figsize)
-                ax[0].imshow(cv2.cvtColor(image1, cv2.COLOR_BGR2RGB)) if bool_cvt else ax[0].imshow(image1)
+                (
+                    ax[0].imshow(cv2.cvtColor(image1, cv2.COLOR_BGR2RGB))
+                    if bool_cvt
+                    else ax[0].imshow(image1)
+                )
                 ax[0].set_title("Image 1")
-                ax[1].imshow(cv2.cvtColor(warped_image2, cv2.COLOR_BGR2RGB)) if bool_cvt else ax[1].imshow(warped_image2)
+                (
+                    ax[1].imshow(cv2.cvtColor(warped_image2, cv2.COLOR_BGR2RGB))
+                    if bool_cvt
+                    else ax[1].imshow(warped_image2)
+                )
                 ax[1].set_title("Warped Image 2")
                 plt.tight_layout()
                 plt.show()
@@ -977,8 +1008,14 @@ def imgcmp(img: list,
                 image1, keypoints1, image2, keypoints2, good_matches, None, flags=2
             )
             plt.figure(figsize=figsize)
-            plt.imshow(cv2.cvtColor(result, cv2.COLOR_BGR2RGB)) if bool_cvt else plt.imshow(result)
-            plt.title(f"Feature Matches ({len(good_matches)} matches, Score: {similarity_score:.4f})")
+            (
+                plt.imshow(cv2.cvtColor(result, cv2.COLOR_BGR2RGB))
+                if bool_cvt
+                else plt.imshow(result)
+            )
+            plt.title(
+                f"Feature Matches ({len(good_matches)} matches, Score: {similarity_score:.4f})"
+            )
             plt.axis("off")
             plt.show()
         # Identify unmatched keypoints
@@ -1021,9 +1058,17 @@ def imgcmp(img: list,
 
         if plot_:
             fig, ax = plt.subplots(1, 2, figsize=figsize)
-            ax[0].imshow(cv2.cvtColor(img1_unmatch, cv2.COLOR_BGR2RGB)) if bool_cvt else ax[0].imshow(img1_unmatch)
+            (
+                ax[0].imshow(cv2.cvtColor(img1_unmatch, cv2.COLOR_BGR2RGB))
+                if bool_cvt
+                else ax[0].imshow(img1_unmatch)
+            )
             ax[0].set_title("Unmatched Keypoints (Image 1)")
-            ax[1].imshow(cv2.cvtColor(img2_unmatch, cv2.COLOR_BGR2RGB)) if bool_cvt else ax[1].imshow(img2_unmatch)
+            (
+                ax[1].imshow(cv2.cvtColor(img2_unmatch, cv2.COLOR_BGR2RGB))
+                if bool_cvt
+                else ax[1].imshow(img2_unmatch)
+            )
             ax[1].set_title("Unmatched Keypoints (Image 2)")
             ax[0].axis("off")
             ax[1].axis("off")
@@ -1031,15 +1076,23 @@ def imgcmp(img: list,
             plt.show()
         if plot_:
             fig, ax = plt.subplots(1, 2, figsize=figsize)
-            ax[0].imshow(cv2.cvtColor(img1_match, cv2.COLOR_BGR2RGB)) if bool_cvt else ax[0].imshow(img1_match)
+            (
+                ax[0].imshow(cv2.cvtColor(img1_match, cv2.COLOR_BGR2RGB))
+                if bool_cvt
+                else ax[0].imshow(img1_match)
+            )
             ax[0].set_title("Matched Keypoints (Image 1)")
-            ax[1].imshow(cv2.cvtColor(img2_match, cv2.COLOR_BGR2RGB)) if bool_cvt else ax[1].imshow(img2_match)
+            (
+                ax[1].imshow(cv2.cvtColor(img2_match, cv2.COLOR_BGR2RGB))
+                if bool_cvt
+                else ax[1].imshow(img2_match)
+            )
             ax[1].set_title("Matched Keypoints (Image 2)")
             ax[0].axis("off")
             ax[1].axis("off")
             plt.tight_layout()
             plt.show()
-        return good_matches, similarity_score#, homography_matrix
+        return good_matches, similarity_score  # , homography_matrix
 
     else:
         raise ValueError("Invalid method. Use 'ssim', 'match', or 'knn'.")
@@ -1312,6 +1365,7 @@ def text2audio(
             print(f"Error opening file: {e}")
     print("done")
 
+
 def str2time(time_str, fmt="24"):
     """
     Convert a time string into the specified format.
@@ -2699,7 +2753,7 @@ def fload(fpath, kind=None, **kwargs):
     def load_excel(fpath, **kwargs):
         engine = kwargs.get("engine", "openpyxl")
         verbose = kwargs.pop("verbose", False)
-        password=kwargs.pop("password",None)
+        password = kwargs.pop("password", None)
 
         if not password:
             if run_once_within(reverse=True):
@@ -2712,12 +2766,12 @@ def fload(fpath, kind=None, **kwargs):
             except:
                 pass
             return df
-        #* needs a password?
-        import msoffcrypto # pip install msoffcrypto-tool
+        # * needs a password?
+        import msoffcrypto  # pip install msoffcrypto-tool
         from io import BytesIO
 
         # Open the encrypted Excel file
-        with open(fpath, 'rb') as f:
+        with open(fpath, "rb") as f:
             try:
                 office_file = msoffcrypto.OfficeFile(f)
                 office_file.load_key(password=password)  # Provide the password
@@ -3317,16 +3371,16 @@ def fsave(
         df = pd.DataFrame(data)
         df.to_csv(fpath, **kwargs_valid)
 
-
     def save_xlsx(fpath, data, password=None, **kwargs):
         import msoffcrypto
         from io import BytesIO
+
         verbose = kwargs.pop("verbose", False)
         sheet_name = kwargs.pop("sheet_name", "Sheet1")
-        
+
         if run_once_within(reverse=True):
             use_pd("to_excel", verbose=verbose)
-        
+
         if any(kwargs):
             format_excel(df=data, filename=fpath, **kwargs)
         else:
@@ -3351,10 +3405,16 @@ def fsave(
                 kwargs.pop(key, None)
 
             df = pd.DataFrame(data)
-            
+
             # Write to Excel without password first
             temp_file = BytesIO()
-            df.to_excel(temp_file, sheet_name=sheet_name, index=False, engine="xlsxwriter", **kwargs)
+            df.to_excel(
+                temp_file,
+                sheet_name=sheet_name,
+                index=False,
+                engine="xlsxwriter",
+                **kwargs,
+            )
 
             # If a password is provided, encrypt the file
             if password:
@@ -3363,19 +3423,22 @@ def fsave(
                 office_file.load_key(password=password)  # Provide the password
 
                 # Encrypt and save the file
-                with open(fpath, 'wb') as encrypted_file:
+                with open(fpath, "wb") as encrypted_file:
                     office_file.encrypt(encrypted_file)
             else:
                 # Save the file without encryption if no password is provided
                 try:
                     # Use ExcelWriter with append mode if the file exists
-                    with pd.ExcelWriter(fpath, engine="openpyxl", mode="a", if_sheet_exists="new") as writer:
-                        df.to_excel(writer, sheet_name=sheet_name, index=False, **kwargs)
+                    with pd.ExcelWriter(
+                        fpath, engine="openpyxl", mode="a", if_sheet_exists="new"
+                    ) as writer:
+                        df.to_excel(
+                            writer, sheet_name=sheet_name, index=False, **kwargs
+                        )
                 except FileNotFoundError:
                     # If file doesn't exist, create a new one
                     df.to_excel(fpath, sheet_name=sheet_name, index=False, **kwargs)
 
-
     def save_ipynb(fpath, data, **kwargs):
         # Split the content by code fences to distinguish between code and markdown
         import nbformat
@@ -3784,7 +3847,6 @@ def get_os(full=False, verbose=False):
     import subprocess
     from datetime import datetime, timedelta
 
-    
     def get_os_type():
         os_name = sys.platform
         if "dar" in os_name:
@@ -3797,8 +3859,10 @@ def get_os(full=False, verbose=False):
             else:
                 print(f"{os_name}, returned 'None'")
                 return None
+
     if not full:
         return get_os_type()
+
     def get_os_info():
         """Get the detailed OS name, version, and other platform-specific details."""
 
@@ -4451,16 +4515,30 @@ def listdir(
             return Box(f.to_dict(orient="series"))
 
 
-def listfunc(lib_name, opt="call"):
-    if opt == "call":
-        funcs = [func for func in dir(lib_name) if callable(getattr(lib_name, func))]
-    else:
-        funcs = dir(lib_name)
-    return funcs
+def listpkg(where="env", verbose=False):
+    """list all pacakages"""
 
+    def listfunc_(lib_name, opt="call"):
+        """list functions in specific lib"""
+        if opt == "call":
+            funcs = [
+                func
+                for func in dir(lib_name)
+                if callable(getattr(lib_name, func))
+                if not func.startswith("__")
+            ]
+        else:
+            funcs = dir(lib_name)
+        return funcs
 
-def func_list(lib_name, opt="call"):
-    return list_func(lib_name, opt=opt)
+    if any([i in where.lower() for i in ["all", "env"]]):
+        import pkg_resources
+
+        lst_pkg = [pkg.key for pkg in pkg_resources.working_set]
+    else:
+        lst_pkg = listfunc_(where)
+    print(lst_pkg) if verbose else None
+    return lst_pkg
 
 
 def copy(src, dst, overwrite=False, verbose=True):
@@ -4839,7 +4917,8 @@ def is_image(fpath):
         bool: True if the file is a recognized image, False otherwise.
     """
     from PIL import Image
-    if isinstance(fpath,str):
+
+    if isinstance(fpath, str):
         import mimetypes
 
         # Known image MIME types
@@ -4896,6 +4975,7 @@ def is_image(fpath):
 
     return False
 
+
 def is_video(fpath):
     """
     Determine if a given file is a video based on MIME type and file extension.
@@ -5205,7 +5285,14 @@ def str2list(str_):
     [l.append(x) for x in str_]
     return l
 
-def str2words(content, method="combined", custom_dict=None, sym_spell_params=None, use_threading=True):
+
+def str2words(
+    content,
+    method="combined",
+    custom_dict=None,
+    sym_spell_params=None,
+    use_threading=True,
+):
     """
     Ultimate text correction function supporting multiple methods,
     lists or strings, and domain-specific corrections.
@@ -5241,7 +5328,7 @@ def str2words(content, method="combined", custom_dict=None, sym_spell_params=Non
         """Segment concatenated words into separate words."""
         segmented = sym_spell.word_segmentation(text)
         return segmented.corrected_string
-    
+
     @lru_cache(maxsize=1000)  # Cache results for repeated corrections
     def advanced_correction(word, sym_spell):
         """Correct a single word using SymSpell."""
@@ -5251,6 +5338,7 @@ def str2words(content, method="combined", custom_dict=None, sym_spell_params=Non
     def apply_custom_corrections(word, custom_dict):
         """Apply domain-specific corrections using a custom dictionary."""
         return custom_dict.get(word.lower(), word)
+
     def preserve_case(original_word, corrected_word):
         """
         Preserve the case of the original word in the corrected word.
@@ -5261,6 +5349,7 @@ def str2words(content, method="combined", custom_dict=None, sym_spell_params=Non
             return corrected_word.capitalize()
         else:
             return corrected_word.lower()
+
     def process_string(text, method, sym_spell=None, custom_dict=None):
         """
         Process a single string for spelling corrections.
@@ -5298,13 +5387,21 @@ def str2words(content, method="combined", custom_dict=None, sym_spell_params=Non
     if isinstance(content, list):
         if use_threading:
             with ThreadPoolExecutor() as executor:
-                corrected_content = list(executor.map(lambda x: process_string(x, method, sym_spell, custom_dict), content))
+                corrected_content = list(
+                    executor.map(
+                        lambda x: process_string(x, method, sym_spell, custom_dict),
+                        content,
+                    )
+                )
             return corrected_content
         else:
-            return [process_string(item, method, sym_spell, custom_dict) for item in content]
+            return [
+                process_string(item, method, sym_spell, custom_dict) for item in content
+            ]
     else:
         return process_string(content, method, sym_spell, custom_dict)
 
+
 def load_img(fpath):
     """
     Load an image from the specified file path.
@@ -5327,7 +5424,7 @@ def load_img(fpath):
         raise OSError(f"Unable to open file '{fpath}' or it is not a valid image file.")
 
 
-def apply_filter(img, *args,verbose=True):
+def apply_filter(img, *args, verbose=True):
     # def apply_filter(img, filter_name, filter_value=None):
     """
     Apply the specified filter to the image.
@@ -5341,7 +5438,13 @@ def apply_filter(img, *args,verbose=True):
     from PIL import ImageFilter
 
     def correct_filter_name(filter_name):
-        if all(["b" in filter_name.lower(),"ur" in filter_name.lower(), "box" not in filter_name.lower()]):
+        if all(
+            [
+                "b" in filter_name.lower(),
+                "ur" in filter_name.lower(),
+                "box" not in filter_name.lower(),
+            ]
+        ):
             return "BLUR"
         elif "cont" in filter_name.lower():
             return "Contour"
@@ -5409,7 +5512,7 @@ def apply_filter(img, *args,verbose=True):
         else:
             filter_value = arg
     if verbose:
-        print(f'processing {filter_name}')
+        print(f"processing {filter_name}")
     filter_name = filter_name.upper()  # Ensure filter name is uppercase
 
     # Supported filters
@@ -5470,8 +5573,8 @@ def detect_angle(image, by="median", template=None):
     import cv2
 
     # Convert to grayscale
-    if np.array(image).shape[-1]>3:
-        image=np.array(image)[:,:,:3]
+    if np.array(image).shape[-1] > 3:
+        image = np.array(image)[:, :, :3]
     gray_image = rgb2gray(image)
 
     # Detect edges using Canny edge detector
@@ -5483,8 +5586,16 @@ def detect_angle(image, by="median", template=None):
     if not lines and any(["me" in by, "pca" in by]):
         print("No lines detected. Adjust the edge detection parameters.")
         return 0
-    methods=['mean','median','pca','gradient orientation','template matching','moments','fft']
-    by=strcmp(by, methods)[0]
+    methods = [
+        "mean",
+        "median",
+        "pca",
+        "gradient orientation",
+        "template matching",
+        "moments",
+        "fft",
+    ]
+    by = strcmp(by, methods)[0]
     # Hough Transform-based angle detection (Median/Mean)
     if "me" in by.lower():
         angles = []
@@ -5573,17 +5684,19 @@ def detect_angle(image, by="median", template=None):
         print(f"Unknown method {by}: supported methods: {methods}")
         return 0
 
-def imgsets(img, 
-            auto:bool=True,
-            size=None,
-            figsize=None,
-            dpi:int=200,
-            show_axis:bool=False,
-            plot_:bool=True,
-            verbose:bool=False,
-            model:str="isnet-general-use",
-            **kwargs,
-            ):
+
+def imgsets(
+    img,
+    auto: bool = True,
+    size=None,
+    figsize=None,
+    dpi: int = 200,
+    show_axis: bool = False,
+    plot_: bool = True,
+    verbose: bool = False,
+    model: str = "isnet-general-use",
+    **kwargs,
+):
     """
     Apply various enhancements and filters to an image using PIL's ImageEnhance and ImageFilter modules.
 
@@ -5619,7 +5732,8 @@ def imgsets(img,
     """
 
     import matplotlib.pyplot as plt
-    from PIL import ImageEnhance, ImageOps,Image
+    from PIL import ImageEnhance, ImageOps, Image
+
     supported_filters = [
         "BLUR",
         "CONTOUR",
@@ -5658,8 +5772,8 @@ def imgsets(img,
         "birefnet-cod": "concealed object detection (COD).",
         "birefnet-massive": "A pre-trained model with massive dataset.",
     }
-    models_support_rem=list(rem_models.keys())
-    str_usage="""
+    models_support_rem = list(rem_models.keys())
+    str_usage = """
     imgsets(dir_img, auto=1, color=1.5, plot_=0)
     imgsets(dir_img, color=2)
     imgsets(dir_img, pad=(300, 300), bgcolor=(73, 162, 127), plot_=0)
@@ -5674,8 +5788,11 @@ def imgsets(img,
     def gamma_correction(image, gamma=1.0, v_max=255):
         # adjust gama value
         inv_gamma = 1.0 / gamma
-        lut = [int((i / float(v_max)) ** inv_gamma * int(v_max)) for i in range(int(v_max))]
-        return lut #image.point(lut) 
+        lut = [
+            int((i / float(v_max)) ** inv_gamma * int(v_max)) for i in range(int(v_max))
+        ]
+        return lut  # image.point(lut)
+
     def auto_enhance(img):
         """
         Automatically enhances the image based on its characteristics, including brightness,
@@ -5690,6 +5807,7 @@ def imgsets(img,
         """
         from PIL import Image, ImageEnhance, ImageOps, ImageFilter
         import numpy as np
+
         # Determine the bit depth based on the image mode
         try:
             if img.mode in ["1", "L", "P", "RGB", "YCbCr", "LAB", "HSV"]:
@@ -5706,10 +5824,10 @@ def imgsets(img,
         # Initialize enhancement factors
         enhancements = {
             "brightness": 1.0,
-            "contrast": 0,# autocontrasted
+            "contrast": 0,  # autocontrasted
             "color": 1.35,
             "sharpness": 1.0,
-            "gamma": 1.0
+            "gamma": 1.0,
         }
 
         # Calculate brightness and contrast for each channel
@@ -5719,7 +5837,9 @@ def imgsets(img,
         for channel in range(num_channels):
             channel_histogram = img.split()[channel].histogram()
             total_pixels = sum(channel_histogram)
-            brightness = sum(i * w for i, w in enumerate(channel_histogram)) / total_pixels
+            brightness = (
+                sum(i * w for i, w in enumerate(channel_histogram)) / total_pixels
+            )
             channel_min, channel_max = img.split()[channel].getextrema()
             contrast = channel_max - channel_min
             # Adjust calculations based on bit depth
@@ -5752,7 +5872,9 @@ def imgsets(img,
         # Use edge detection to estimate sharpness need
         edges = img.filter(ImageFilter.FIND_EDGES).convert("L")
         avg_edge_intensity = np.mean(np.array(edges))
-        enhancements["sharpness"] = min(2.0, max(0.5, 1.0 + avg_edge_intensity / normalization_factor))
+        enhancements["sharpness"] = min(
+            2.0, max(0.5, 1.0 + avg_edge_intensity / normalization_factor)
+        )
         # img = sharpness_enhancer.enhance(enhancements["sharpness"])
 
         # # Apply gamma correction
@@ -5768,19 +5890,39 @@ def imgsets(img,
         # Return the enhancements and the enhanced image
         return enhancements
 
-
     # Load image if input is a file path
     if isinstance(img, str):
         img = load_img(img)
-    img_update = img.copy() 
+    img_update = img.copy()
 
     if auto:
         kwargs = {**auto_enhance(img_update), **kwargs}
-    params=["sharp","color","contrast","bright","crop","rotate",'size',"resize",
-            "thumbnail","cover","contain","filter","fit","pad",
-            "rem","rm","back","bg_color","cut","gamma","flip","booster"]
+    params = [
+        "sharp",
+        "color",
+        "contrast",
+        "bright",
+        "crop",
+        "rotate",
+        "size",
+        "resize",
+        "thumbnail",
+        "cover",
+        "contain",
+        "filter",
+        "fit",
+        "pad",
+        "rem",
+        "rm",
+        "back",
+        "bg_color",
+        "cut",
+        "gamma",
+        "flip",
+        "booster",
+    ]
     for k, value in kwargs.items():
-        k = strcmp(k, params)[0] # correct the param name
+        k = strcmp(k, params)[0]  # correct the param name
         if "shar" in k.lower():
             enhancer = ImageEnhance.Sharpness(img_update)
             img_update = enhancer.enhance(value)
@@ -5810,11 +5952,11 @@ def imgsets(img,
                 value = detect_angle(img_update, by=value)
                 print(f"rotated by {value}°")
             img_update = img_update.rotate(value)
-        elif 'flip' in k.lower():
-            if 'l' in value and 'r' in value:
+        elif "flip" in k.lower():
+            if "l" in value and "r" in value:
                 # left/right
                 img_update = img_update.transpose(Image.FLIP_LEFT_RIGHT)
-            elif any(['u' in value and'd' in value, 't' in value and 'b' in value]):
+            elif any(["u" in value and "d" in value, "t" in value and "b" in value]):
                 # up/down or top/bottom
                 img_update = img_update.transpose(Image.FLIP_TOP_BOTTOM)
         elif "si" in k.lower():
@@ -5828,12 +5970,14 @@ def imgsets(img,
             img_update = ImageOps.cover(img_update, size=value)
         elif "contain" in k.lower():
             img_update = ImageOps.contain(img_update, size=value)
-        elif "fi" in k.lower() and "t" in k.lower(): # filter
+        elif "fi" in k.lower() and "t" in k.lower():  # filter
             if isinstance(value, dict):
                 if verbose:
                     print(f"supported filter: {supported_filters}")
                 for filter_name, filter_value in value.items():
-                    img_update = apply_filter(img_update, filter_name, filter_value,verbose=verbose)
+                    img_update = apply_filter(
+                        img_update, filter_name, filter_value, verbose=verbose
+                    )
             else:
                 img_update = ImageOps.fit(img_update, size=value)
         elif "pad" in k.lower():
@@ -5842,11 +5986,12 @@ def imgsets(img,
             img_update = ImageOps.pad(img_update, size=value)
         elif "rem" in k.lower() or "rm" in k.lower() or "back" in k.lower():
             from rembg import remove, new_session
+
             if verbose:
                 preview(rem_models)
-            
+
             print(f"supported modles: {models_support_rem}")
-            model=strcmp(model, models_support_rem)[0]
+            model = strcmp(model, models_support_rem)[0]
             session = new_session(model)
             if isinstance(value, bool):
                 print(f"using model:{model}")
@@ -5854,21 +5999,25 @@ def imgsets(img,
             elif value and isinstance(value, (int, float, list)):
                 if verbose:
                     print("https://github.com/danielgatis/rembg/blob/main/USAGE.md")
-                    print(f"rm=True # using default setting;\nrm=(240,10,10)\n'foreground_threshold'(240) and 'background_threshold' (10) values used to determine foreground and background pixels. \nThe 'erode_structure_size'(10) parameter specifies the size of the erosion structure to be applied to the mask.")
+                    print(
+                        f"rm=True # using default setting;\nrm=(240,10,10)\n'foreground_threshold'(240) and 'background_threshold' (10) values used to determine foreground and background pixels. \nThe 'erode_structure_size'(10) parameter specifies the size of the erosion structure to be applied to the mask."
+                    )
                 if isinstance(value, int):
                     value = [value]
                 if len(value) < 2:
                     img_update = remove(
                         img_update,
                         alpha_matting=True,
-                        alpha_matting_background_threshold=value, session=session
+                        alpha_matting_background_threshold=value,
+                        session=session,
                     )
                 elif 2 <= len(value) < 3:
                     img_update = remove(
                         img_update,
                         alpha_matting=True,
                         alpha_matting_background_threshold=value[0],
-                        alpha_matting_foreground_threshold=value[1], session=session
+                        alpha_matting_foreground_threshold=value[1],
+                        session=session,
                     )
                 elif 3 <= len(value) < 4:
                     img_update = remove(
@@ -5876,7 +6025,8 @@ def imgsets(img,
                         alpha_matting=True,
                         alpha_matting_background_threshold=value[0],
                         alpha_matting_foreground_threshold=value[1],
-                        alpha_matting_erode_size=value[2], session=session
+                        alpha_matting_erode_size=value[2],
+                        session=session,
                     )
             elif isinstance(value, tuple):  # replace the background color
                 if len(value) == 3:
@@ -5885,7 +6035,10 @@ def imgsets(img,
             elif isinstance(value, str):
                 # use custom model
                 print(f"using model:{strcmp(value, models_support_rem)[0]}")
-                img_update = remove(img_update, session=new_session(strcmp(value, models_support_rem)[0]))
+                img_update = remove(
+                    img_update,
+                    session=new_session(strcmp(value, models_support_rem)[0]),
+                )
         elif "bg" in k.lower() and "color" in k.lower():
             from rembg import remove
 
@@ -5895,30 +6048,32 @@ def imgsets(img,
                 if len(value) == 3:
                     value += (255,)
                 img_update = remove(img_update, bgcolor=value)
-        elif 'boost' in k.lower():
+        elif "boost" in k.lower():
             import torch
             from realesrgan import RealESRGANer
+
             if verbose:
                 print("Applying Real-ESRGAN for image reconstruction...")
             if isinstance(value, bool):
-                scale=4
+                scale = 4
             elif isinstance(value, (float, int)):
-                scale=value
+                scale = value
             else:
-                scale=4
+                scale = 4
 
             # try:
             device = "cuda" if torch.cuda.is_available() else "cpu"
             dir_curr_script = os.path.dirname(os.path.abspath(__file__))
             model_path = dir_curr_script + "/data/RealESRGAN_x4plus.pth"
-            model_RealESRGAN = RealESRGANer(device=device, 
-                                            scale=scale, 
-                                            model_path=model_path,
-                                            model="RealESRGAN_x4plus"
-                                            )
+            model_RealESRGAN = RealESRGANer(
+                device=device,
+                scale=scale,
+                model_path=model_path,
+                model="RealESRGAN_x4plus",
+            )
             # https://github.com/xinntao/Real-ESRGAN?tab=readme-ov-file#python-script
 
-            img_update = model_RealESRGAN.enhance(np.array(img_update))[0] 
+            img_update = model_RealESRGAN.enhance(np.array(img_update))[0]
             # except Exception as e:
             #     print(f"Failed to apply Real-ESRGAN: {e}")
 
@@ -6175,6 +6330,7 @@ def format_excel(
     protect=None,  # dict
     number_format=None,  # dict: e.g., {1:"0.00", 2:"#,##0",3:"0%",4:"$#,##0.00"}
     data_validation=None,  # dict
+    apply_filter=True, # add filter 
     conditional_format=None,  # dict
     **kwargs,
 ):
@@ -6185,7 +6341,7 @@ def format_excel(
     from openpyxl.utils import get_column_letter
     from openpyxl.worksheet.datavalidation import DataValidation
     from openpyxl.comments import Comment
-    from openpyxl.formatting.rule import ColorScaleRule
+    from openpyxl.formatting.rule import ColorScaleRule, DataBarRule, IconSetRule,IconSet
 
     def convert_indices_to_range(row_slice, col_slice):
         """Convert numerical row and column slices to Excel-style range strings."""
@@ -6550,159 +6706,159 @@ def format_excel(
         filename = str(datetime.now().strftime("%y%m%d_%H.xlsx"))
     # !show usage:
     func_xample = """
-# Example usage
-data = {
-    "Header 1": [10, 2000000, 30],
-    "Header 2": [
-        40000,
-        '"start_color": "4F81BD", "end_color","start_color": "a1cd1e","start_color": "4F81BD", "end_color","start_color": "a1cd1e"',
-        60,
-    ],
-    "Header 3": [70, 80, 90],
-}
-df = pd.DataFrame(data)
-
-
-format_excel(
-    df,
-    filename="example.xlsx",
-    sheet_name="Sheet1",
-    cell=[
-        {
-            (slice(0, 1), slice(0, len(df.columns))): {
-                "font": {
-                    "name": "Calibri",  # Font name
-                    "size": 14,  # Font size
-                    "bold": True,  # Bold text
-                    "italic": False,  # Italic text
-                    "underline": "single",  # Underline (single, double)
-                    "color": "#FFFFFF",  # Font color
-                },
-                "fill": {
-                    "start_color": "a1cd1e",  # Starting color
-                    "end_color": "4F81BD",  # Ending color (useful for gradients)
-                    "fill_type": "solid",  # Fill type (solid, gradient, etc.)
-                },
-                "alignment": {
-                    "horizontal": "center",  # Horizontal alignment (left, center, right)
-                    "vertical": "center",  # Vertical alignment (top, center, bottom)
-                    "wrap_text": True,  # Wrap text in the cell
-                    "shrink_to_fit": True,  # Shrink text to fit within cell
-                    "text_rotation": 0,  # Text rotation angle
-                },
-                "border": {
-                    "left": "thin",
-                    "right": "thin",
-                    "top": "thin",
-                    "bottom": "thin",
-                    "color": "000000",  # Border color
-                },
+            # Example usage
+            data = {
+                "Header 1": [10, 2000000, 30],
+                "Header 2": [
+                    40000,
+                    '"start_color": "4F81BD", "end_color","start_color": "a1cd1e","start_color": "4F81BD", "end_color","start_color": "a1cd1e"',
+                    60,
+                ],
+                "Header 3": [70, 80, 90],
             }
-        },
-        {
-            (slice(0, 3), slice(1, 3)): {
-                "font": {
-                    "name": "Arial",  # Font name
-                    "size": 12,  # Font size
-                    "bold": False,  # Bold text
-                    "italic": True,  # Italic text
-                    "underline": None,  # No underline
-                    "color": "#000000",  # Font color
+            df = pd.DataFrame(data)
+
+
+            format_excel(
+                df,
+                filename="example.xlsx",
+                sheet_name="Sheet1",
+                cell=[
+                    {
+                        (slice(0, 1), slice(0, len(df.columns))): {
+                            "font": {
+                                "name": "Calibri",  # Font name
+                                "size": 14,  # Font size
+                                "bold": True,  # Bold text
+                                "italic": False,  # Italic text
+                                "underline": "single",  # Underline (single, double)
+                                "color": "#FFFFFF",  # Font color
+                            },
+                            "fill": {
+                                "start_color": "a1cd1e",  # Starting color
+                                "end_color": "4F81BD",  # Ending color (useful for gradients)
+                                "fill_type": "solid",  # Fill type (solid, gradient, etc.)
+                            },
+                            "alignment": {
+                                "horizontal": "center",  # Horizontal alignment (left, center, right)
+                                "vertical": "center",  # Vertical alignment (top, center, bottom)
+                                "wrap_text": True,  # Wrap text in the cell
+                                "shrink_to_fit": True,  # Shrink text to fit within cell
+                                "text_rotation": 0,  # Text rotation angle
+                            },
+                            "border": {
+                                "left": "thin",
+                                "right": "thin",
+                                "top": "thin",
+                                "bottom": "thin",
+                                "color": "000000",  # Border color
+                            },
+                        }
+                    },
+                    {
+                        (slice(0, 3), slice(1, 3)): {
+                            "font": {
+                                "name": "Arial",  # Font name
+                                "size": 12,  # Font size
+                                "bold": False,  # Bold text
+                                "italic": True,  # Italic text
+                                "underline": None,  # No underline
+                                "color": "#000000",  # Font color
+                            },
+                            "fill": {
+                                "start_color": "#c61313",  # Background color
+                                "end_color": "#490606",  # End color
+                                "fill_type": "solid",  # Fill type
+                            },
+                            "alignment": {
+                                "horizontal": "left",  # Horizontal alignment
+                                "vertical": "top",  # Vertical alignment
+                                "wrap_text": True,  # Enable text wrapping
+                                "shrink_to_fit": False,  # Disable shrink to fit
+                                "indent": 1,  # Indentation level
+                                "text_rotation": 0,  # Text rotation angle
+                            },
+                            "border": {
+                                "left": "thin",  # Left border style
+                                "right": "thin",  # Right border style
+                                "top": "thin",  # Top border style
+                                "bottom": "thin",  # Bottom border style
+                                "color": "000000",  # Border color
+                            },
+                        }
+                        # * border settings
+                        # "thin": Thin border line
+                        # "medium": Medium border line
+                        # "thick": Thick border line
+                        # "dotted": Dotted border line
+                        # "dashed": Dashed border line
+                        # "hair": Hairline border (very thin)
+                        # "mediumDashed": Medium dashed border line
+                        # "dashDot": Dash-dot border line
+                        # "dashDotDot": Dash-dot-dot border line
+                        # "slantDashDot": Slant dash-dot border line
+                    },
+                ],
+                width={2: 30},  # when it is None, it will automatic adjust width
+                height={2: 50, 3: 25},  # keys are columns
+                merge=(slice(0, 1), slice(1, 3)),
+                shade={
+                    (slice(1, 4), slice(1, 3)): {
+                        "bg_color": "FFFF00",  # Background color
+                        "pattern_type": "solid",  # Fill pattern (e.g., solid, darkGrid, lightGrid)
+                        "fg_color": "#0000FF",  # Foreground color, used in patterns
+                        "end_color": "0000FF",  # End color, useful for gradients
+                        "fill_type": "solid",  # Type of fill (solid, gradient, etc.)
+                    }
                 },
-                "fill": {
-                    "start_color": "#c61313",  # Background color
-                    "end_color": "#490606",  # End color
-                    "fill_type": "solid",  # Fill type
+                comment={(2, 4): "This is a comment"},
+                link={(2, 2): "https://example.com"},
+                protect={
+                    "password": "123",  # Password for sheet protection
+                    "sheet": False,  # True,  # Protect the sheet
+                    "objects": False,  # True,  # Protect objects
+                    "scenarios": False,  # True,  # Protect scenarios
+                    "formatCells": False,  # Disable formatting cells
+                    "formatColumns": False,  # Disable formatting columns
+                    "formatRows": False,  # Disable formatting rows
+                    "insertColumns": False,  # Disable inserting columns
+                    "insertRows": False,  # Disable inserting rows
+                    "deleteColumns": False,  # Disable deleting columns
+                    "deleteRows": False,  # Disable deleting rows
                 },
-                "alignment": {
-                    "horizontal": "left",  # Horizontal alignment
-                    "vertical": "top",  # Vertical alignment
-                    "wrap_text": True,  # Enable text wrapping
-                    "shrink_to_fit": False,  # Disable shrink to fit
-                    "indent": 1,  # Indentation level
-                    "text_rotation": 0,  # Text rotation angle
+                number_format={
+                    1: "0.00",  # Two decimal places for column index 1
+                    2: "#,##0",  # Thousands separator
+                    3: "0%",  # Percentage format
+                    4: "$#,##0.00",  # Currency format
                 },
-                "border": {
-                    "left": "thin",  # Left border style
-                    "right": "thin",  # Right border style
-                    "top": "thin",  # Top border style
-                    "bottom": "thin",  # Bottom border style
-                    "color": "000000",  # Border color
+                data_validation={
+                    (slice(1, 2), slice(2, 10)): {
+                        "type": "list",
+                        "formula1": '"Option1,Option2,Option3"',  # List of options
+                        "allow_blank": True,
+                        "showDropDown": True,
+                        "showErrorMessage": True,
+                        "errorTitle": "Invalid input",
+                        "error": "Please select a valid option.",
+                    }
                 },
-            }
-            # * border settings
-            # "thin": Thin border line
-            # "medium": Medium border line
-            # "thick": Thick border line
-            # "dotted": Dotted border line
-            # "dashed": Dashed border line
-            # "hair": Hairline border (very thin)
-            # "mediumDashed": Medium dashed border line
-            # "dashDot": Dash-dot border line
-            # "dashDotDot": Dash-dot-dot border line
-            # "slantDashDot": Slant dash-dot border line
-        },
-    ],
-    width={2: 30},  # when it is None, it will automatic adjust width
-    height={2: 50, 3: 25},  # keys are columns
-    merge=(slice(0, 1), slice(1, 3)),
-    shade={
-        (slice(1, 4), slice(1, 3)): {
-            "bg_color": "FFFF00",  # Background color
-            "pattern_type": "solid",  # Fill pattern (e.g., solid, darkGrid, lightGrid)
-            "fg_color": "#0000FF",  # Foreground color, used in patterns
-            "end_color": "0000FF",  # End color, useful for gradients
-            "fill_type": "solid",  # Type of fill (solid, gradient, etc.)
-        }
-    },
-    comment={(2, 4): "This is a comment"},
-    link={(2, 2): "https://example.com"},
-    protect={
-        "password": "123",  # Password for sheet protection
-        "sheet": False,  # True,  # Protect the sheet
-        "objects": False,  # True,  # Protect objects
-        "scenarios": False,  # True,  # Protect scenarios
-        "formatCells": False,  # Disable formatting cells
-        "formatColumns": False,  # Disable formatting columns
-        "formatRows": False,  # Disable formatting rows
-        "insertColumns": False,  # Disable inserting columns
-        "insertRows": False,  # Disable inserting rows
-        "deleteColumns": False,  # Disable deleting columns
-        "deleteRows": False,  # Disable deleting rows
-    },
-    number_format={
-        1: "0.00",  # Two decimal places for column index 1
-        2: "#,##0",  # Thousands separator
-        3: "0%",  # Percentage format
-        4: "$#,##0.00",  # Currency format
-    },
-    data_validation={
-        (slice(1, 2), slice(2, 10)): {
-            "type": "list",
-            "formula1": '"Option1,Option2,Option3"',  # List of options
-            "allow_blank": True,
-            "showDropDown": True,
-            "showErrorMessage": True,
-            "errorTitle": "Invalid input",
-            "error": "Please select a valid option.",
-        }
-    },
-    conditional_format={
-        (slice(1, 2), slice(2, 10)): [
-            {
-                "color_scale": {
-                    "start_type": "min",  # Type of start point (min, max, percent)
-                    "start_color": "#FF0000",  # Starting color
-                    "end_type": "max",  # End type (min, max, percent)
-                    "end_color": "00FF00",  # Ending color
-                    "mid_type": "percentile",  # Midpoint type (optional)
-                    "mid_value": 50,  # Midpoint value (optional)
-                    "mid_color": "FFFF00",  # Midpoint color (optional)
-                }
-            }
-        ]
-    },
-)
+                conditional_format={
+                    (slice(1, 2), slice(2, 10)): [
+                        {
+                            "color_scale": {
+                                "start_type": "min",  # Type of start point (min, max, percent)
+                                "start_color": "#FF0000",  # Starting color
+                                "end_type": "max",  # End type (min, max, percent)
+                                "end_color": "00FF00",  # Ending color
+                                "mid_type": "percentile",  # Midpoint type (optional)
+                                "mid_value": 50,  # Midpoint value (optional)
+                                "mid_color": "FFFF00",  # Midpoint color (optional)
+                            }
+                        }
+                    ]
+                },
+            )
             """
     if usage:
         print(func_xample)
@@ -6762,17 +6918,49 @@ format_excel(
             col_letter = get_column_letter(col_idx)
             for cell in ws[col_letter][1:]:  # Skip the header
                 cell.number_format = fmt
+    
+    if apply_filter:
+        if isinstance(apply_filter, bool):
+            # Default: Apply filter to the entire first row (header)
+            filter_range = f"A1:{get_column_letter(ws.max_column)}1"
+            ws.auto_filter.ref = filter_range
+            
+        elif isinstance(apply_filter, tuple):
+            row_slice, col_slice = apply_filter
+            
+            # Extract the start and end indices for rows and columns
+            start_row, end_row = row_slice.start, row_slice.stop
+            start_col_idx, end_col_idx = col_slice.start, col_slice.stop
+
+            # Ensure valid row and column indices
+            if start_row < 1: start_row = 1  # Row should not be less than 1
+            if end_row > ws.max_row: end_row = ws.max_row  # Ensure within sheet's row limits
+            if start_col_idx < 1: start_col_idx = 1  # Column should not be less than 1
+            if end_col_idx > ws.max_column: end_col_idx = ws.max_column  # Ensure within sheet's column limits
+            
+            # Get column letters based on indices
+            start_col = get_column_letter(start_col_idx)
+            end_col = get_column_letter(end_col_idx)
+
+            # Define the filter range based on specific rows and columns
+            filter_range = f"{start_col}{start_row}:{end_col}{end_row}"
 
+            # Apply the filter
+            ws.auto_filter.ref = filter_range
     # !widths
     if width is None:  # automatic adust width
         for col in ws.columns:
-            len_ = [len(str(cell.value)) for cell in col if cell.value]
-            if len_:
-                # scaling_factor = 1.2
-                max_length = max(len_)  # * scaling_factor
-                ws.column_dimensions[get_column_letter(col[0].column)].width = (
-                    max_length
-                )
+            max_length = 0
+            column = col[0].column_letter  # Get the column letter
+            for cell_ in col:
+                try:
+                    if cell_.value:
+                        max_length = max(max_length, len(str(cell_.value)))
+                except Exception:
+                    pass
+            adjusted_width = max_length + 2  # You can adjust the padding value as needed
+            ws.column_dimensions[column].width = adjusted_width
+
     else:
         for col_idx, width_ in width.items():
             col_letter = get_column_letter(col_idx)
@@ -6862,6 +7050,7 @@ format_excel(
         for indices, rules in conditional_format.items():
             cell_range = convert_indices_to_range(*indices)
             for rule in rules:
+                # Handle color scale
                 if "color_scale" in rule:
                     color_scale = rule["color_scale"]
                     start_color = hex2argb(color_scale.get("start_color", "FFFFFF"))
@@ -6880,6 +7069,32 @@ format_excel(
                         end_color=end_color,
                     )
                     ws.conditional_formatting.add(cell_range, color_scale_rule)
+                # Handle data bar
+                if "data_bar" in rule:
+                    data_bar = rule["data_bar"]
+                    bar_color = hex2argb(data_bar.get("color", "638EC6"))
+
+                    data_bar_rule = DataBarRule(
+                        start_type=data_bar.get("start_type", "min"),
+                        start_value=data_bar.get("start_value"),
+                        end_type=data_bar.get("end_type", "max"),
+                        end_value=data_bar.get("end_value"),
+                        color=bar_color,
+                        showValue=data_bar.get("show_value", True),
+                    )
+                    ws.conditional_formatting.add(cell_range, data_bar_rule)
+
+                # Handle icon set
+                if "icon_set" in rule:
+                    icon_set = rule["icon_set"]
+                    icon_set_rule = IconSet(
+                        iconSet=icon_set.get("iconSet", "3TrafficLights1"),  # Corrected
+                        showValue=icon_set.get("show_value", True),        # Corrected
+                        reverse=icon_set.get("reverse", False)            # Corrected
+                    )
+                    ws.conditional_formatting.add(cell_range, icon_set_rule)
+
+
     # Save the workbook
     wb.save(filename)
     print(f"Formatted Excel file saved as:\n{filename}")
@@ -10320,7 +10535,7 @@ def get_loc(input_data, user_agent="0413@mygmail.com)", verbose=True):
                 print(f"Could not find {input_data}.")
             return location
         except Exception as e:
-            print(f'Error: {e}')
+            print(f"Error: {e}")
             return
 
     # Case 2: Input is latitude and longitude (float or tuple)
@@ -10516,6 +10731,7 @@ def depass(encrypted_code: str, method: str = "AES", key: str = None):
     else:
         raise ValueError("Unsupported decryption method")
 
+
 def get_clip(dir_save=None):
     """
     Master function to extract content from the clipboard (text, URL, or image).
@@ -10537,6 +10753,7 @@ def get_clip(dir_save=None):
         import pyperclip
         from PIL import ImageGrab, Image
         import validators
+
         # 1. Check for text in the clipboard
         clipboard_content = pyperclip.paste()
         if clipboard_content:
@@ -10568,7 +10785,8 @@ def get_clip(dir_save=None):
         print(f"An error occurred: {e}")
         return result
 
-def keyboard(*args, action='press', n_click=1,interval=0,verbose=False,**kwargs):
+
+def keyboard(*args, action="press", n_click=1, interval=0, verbose=False, **kwargs):
     """
     Simulates keyboard input using pyautogui.
 
@@ -10583,45 +10801,231 @@ def keyboard(*args, action='press', n_click=1,interval=0,verbose=False,**kwargs)
     keyboard("command", "d", action="shorcut")
     """
     import pyautogui
-    input_key  = args
-
-    actions = ['press','keyDown','keyUp', 'hold','release', 'hotkey','shortcut']
-    action = strcmp(action,actions)[0]
-    keyboard_keys_=['\t', '\n', '\r', ' ', '!', '"', '#', '$', '%', '&', "'", '(',
-                    ')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7',
-                    '8', '9', ':', ';', '<', '=', '>', '?', '@', '[', '\\', ']', '^', '_', '`',
-                    'a', 'b', 'c', 'd', 'e','f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o',
-                    'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~',
-                    'accept', 'add', 'alt', 'altleft', 'altright', 'apps', 'backspace',
-                    'browserback', 'browserfavorites', 'browserforward', 'browserhome',
-                    'browserrefresh', 'browsersearch', 'browserstop', 'capslock', 'clear',
-                    'convert', 'ctrl', 'ctrlleft', 'ctrlright', 'decimal', 'del', 'delete',
-                    'divide', 'down', 'end', 'enter', 'esc', 'escape', 'execute', 'f1', 'f10',
-                    'f11', 'f12', 'f13', 'f14', 'f15', 'f16', 'f17', 'f18', 'f19', 'f2', 'f20',
-                    'f21', 'f22', 'f23', 'f24', 'f3', 'f4', 'f5', 'f6', 'f7', 'f8', 'f9',
-                    'final', 'fn', 'hanguel', 'hangul', 'hanja', 'help', 'home', 'insert', 'junja',
-                    'kana', 'kanji', 'launchapp1', 'launchapp2', 'launchmail',
-                    'launchmediaselect', 'left', 'modechange', 'multiply', 'nexttrack',
-                    'nonconvert', 'num0', 'num1', 'num2', 'num3', 'num4', 'num5', 'num6',
-                    'num7', 'num8', 'num9', 'numlock', 'pagedown', 'pageup', 'pause', 'pgdn',
-                    'pgup', 'playpause', 'prevtrack', 'print', 'printscreen', 'prntscrn',
-                    'prtsc', 'prtscr', 'return', 'right', 'scrolllock', 'select', 'separator',
-                    'shift', 'shiftleft', 'shiftright', 'sleep', 'space', 'stop', 'subtract', 'tab',
-                    'up', 'volumedown', 'volumemute', 'volumeup', 'win', 'winleft', 'winright', 'yen',
-                    'command', 'option', 'optionleft', 'optionright']
+
+    input_key = args
+
+    actions = ["press", "keyDown", "keyUp", "hold", "release", "hotkey", "shortcut"]
+    action = strcmp(action, actions)[0]
+    keyboard_keys_ = [
+        "\t",
+        "\n",
+        "\r",
+        " ",
+        "!",
+        '"',
+        "#",
+        "$",
+        "%",
+        "&",
+        "'",
+        "(",
+        ")",
+        "*",
+        "+",
+        ",",
+        "-",
+        ".",
+        "/",
+        "0",
+        "1",
+        "2",
+        "3",
+        "4",
+        "5",
+        "6",
+        "7",
+        "8",
+        "9",
+        ":",
+        ";",
+        "<",
+        "=",
+        ">",
+        "?",
+        "@",
+        "[",
+        "\\",
+        "]",
+        "^",
+        "_",
+        "`",
+        "a",
+        "b",
+        "c",
+        "d",
+        "e",
+        "f",
+        "g",
+        "h",
+        "i",
+        "j",
+        "k",
+        "l",
+        "m",
+        "n",
+        "o",
+        "p",
+        "q",
+        "r",
+        "s",
+        "t",
+        "u",
+        "v",
+        "w",
+        "x",
+        "y",
+        "z",
+        "{",
+        "|",
+        "}",
+        "~",
+        "accept",
+        "add",
+        "alt",
+        "altleft",
+        "altright",
+        "apps",
+        "backspace",
+        "browserback",
+        "browserfavorites",
+        "browserforward",
+        "browserhome",
+        "browserrefresh",
+        "browsersearch",
+        "browserstop",
+        "capslock",
+        "clear",
+        "convert",
+        "ctrl",
+        "ctrlleft",
+        "ctrlright",
+        "decimal",
+        "del",
+        "delete",
+        "divide",
+        "down",
+        "end",
+        "enter",
+        "esc",
+        "escape",
+        "execute",
+        "f1",
+        "f10",
+        "f11",
+        "f12",
+        "f13",
+        "f14",
+        "f15",
+        "f16",
+        "f17",
+        "f18",
+        "f19",
+        "f2",
+        "f20",
+        "f21",
+        "f22",
+        "f23",
+        "f24",
+        "f3",
+        "f4",
+        "f5",
+        "f6",
+        "f7",
+        "f8",
+        "f9",
+        "final",
+        "fn",
+        "hanguel",
+        "hangul",
+        "hanja",
+        "help",
+        "home",
+        "insert",
+        "junja",
+        "kana",
+        "kanji",
+        "launchapp1",
+        "launchapp2",
+        "launchmail",
+        "launchmediaselect",
+        "left",
+        "modechange",
+        "multiply",
+        "nexttrack",
+        "nonconvert",
+        "num0",
+        "num1",
+        "num2",
+        "num3",
+        "num4",
+        "num5",
+        "num6",
+        "num7",
+        "num8",
+        "num9",
+        "numlock",
+        "pagedown",
+        "pageup",
+        "pause",
+        "pgdn",
+        "pgup",
+        "playpause",
+        "prevtrack",
+        "print",
+        "printscreen",
+        "prntscrn",
+        "prtsc",
+        "prtscr",
+        "return",
+        "right",
+        "scrolllock",
+        "select",
+        "separator",
+        "shift",
+        "shiftleft",
+        "shiftright",
+        "sleep",
+        "space",
+        "stop",
+        "subtract",
+        "tab",
+        "up",
+        "volumedown",
+        "volumemute",
+        "volumeup",
+        "win",
+        "winleft",
+        "winright",
+        "yen",
+        "command",
+        "option",
+        "optionleft",
+        "optionright",
+    ]
     if verbose:
         print(f"supported keys: {keyboard_keys_}")
 
-    if action not in ['hotkey','shortcut']:
+    if action not in ["hotkey", "shortcut"]:
         if not isinstance(input_key, list):
-            input_key=list(input_key)
-        input_key = [strcmp(i, keyboard_keys_)[0] for i in input_key ]
+            input_key = list(input_key)
+        input_key = [strcmp(i, keyboard_keys_)[0] for i in input_key]
 
     # correct action
-    cmd_keys = ['command', 'option', 'optionleft', 'optionright','win', 'winleft', 'winright','ctrl', 'ctrlleft', 'ctrlright']
+    cmd_keys = [
+        "command",
+        "option",
+        "optionleft",
+        "optionright",
+        "win",
+        "winleft",
+        "winright",
+        "ctrl",
+        "ctrlleft",
+        "ctrlright",
+    ]
     try:
         if any([i in cmd_keys for i in input_key]):
-            action='hotkey'
+            action = "hotkey"
     except:
         pass
 
@@ -10633,23 +11037,24 @@ def keyboard(*args, action='press', n_click=1,interval=0,verbose=False,**kwargs)
             for key in input_key:
                 pyautogui.press(key)
                 pyautogui.sleep(interval)
-    elif action in ['keyDown','hold']:
+    elif action in ["keyDown", "hold"]:
         # pyautogui.keyDown(input_key)
         for _ in range(n_click):
             for key in input_key:
                 pyautogui.keyDown(key)
                 pyautogui.sleep(interval)
-        
-    elif action in ['keyUp','release']:
+
+    elif action in ["keyUp", "release"]:
         # pyautogui.keyUp(input_key)
         for _ in range(n_click):
             for key in input_key:
                 pyautogui.keyUp(key)
                 pyautogui.sleep(interval)
-        
-    elif action in ['hotkey','shortcut']:
+
+    elif action in ["hotkey", "shortcut"]:
         pyautogui.hotkey(input_key)
-    
+
+
 def mouse(
     *args,  # loc
     action: str = "move",
@@ -10657,7 +11062,7 @@ def mouse(
     loc_type: str = "absolute",  # 'absolute', 'relative'
     region: tuple = None,  # (tuple, optional): A region (x, y, width, height) to search for the image.
     image_path: str = None,
-    wait:float = 0,
+    wait: float = 0,
     text: str = None,
     confidence: float = 0.8,
     button: str = "left",
@@ -10666,6 +11071,8 @@ def mouse(
     scroll_amount: int = -500,
     fail_safe: bool = True,
     grayscale: bool = False,
+    n_try: int = 10,
+    verbose: bool = True,
     **kwargs,
 ):
     """
@@ -10692,6 +11099,9 @@ def mouse(
     import pyautogui
     import time
 
+    # import logging
+    # logging.basicConfig(level=logging.DEBUG, filename="debug.log")
+
     pyautogui.FAILSAFE = fail_safe  # Enable/disable fail-safe
     loc_type = "absolute" if "abs" in loc_type else "relative"
     if len(args) == 1:
@@ -10700,7 +11110,6 @@ def mouse(
             x_offset, y_offset = None, None
         else:
             x_offset, y_offset = args
-
     elif len(args) == 2:
         x_offset, y_offset = args
     elif len(args) == 3:
@@ -10725,59 +11134,62 @@ def mouse(
         "up",
         "hold",
         "press",
-        "release"
+        "release",
     ]
     action = strcmp(action, what_action)[0]
     # get the locations
     location = None
     if any([x_offset is None, y_offset is None]):
         if region is None:
-            w,h=pyautogui.size()
-            region=(0,0,w,h)
-            print(region)
-        try:
-            print(image_path)
-            location = pyautogui.locateOnScreen(
-                image_path, confidence=confidence, region=region, grayscale=grayscale
-            )
-            print(pyautogui.center(location))
-        except Exception as e:
-            location = None
+            w, h = pyautogui.size()
+            region = (0, 0, w, h)
+        retries = 0
+        while location is None and retries <= n_try:
+            try:
+                confidence_ = round(float(confidence - 0.05 * retries), 2)
+                location = pyautogui.locateOnScreen(
+                    image_path,
+                    confidence=confidence_,
+                    region=region,
+                    grayscale=grayscale,
+                )
+            except Exception as e:
+                if verbose:
+                    print(f"confidence={confidence_},{e}")
+                location = None
+            retries += 1
 
     # try:
     if location:
         x, y = pyautogui.center(location)
         x += x_offset if x_offset else 0
-        y += y_offset if y_offset else 0
-        x_offset, y_offset = x,y
-    print(action)
-    if action in ['locate']:
+        if x_offset is not None:
+            x += x_offset
+        if y_offset is not None:
+            y += y_offset
+        x_offset, y_offset = x, y
+    print(action) if verbose else None
+    if action in ["locate"]:
         x, y = pyautogui.position()
-    elif action in ["click", "double_click","triple_click"]:
-        # if location:
-        #     x, y = pyautogui.center(location)
-        #     x += x_offset
-        #     y += y_offset
-        #     pyautogui.moveTo(x, y, duration=duration) 
-        #     if action == "click":
-        #         pyautogui.click(x=x, y=y, clicks=n_click, interval=interval, button=button)
-        #     elif action == "double_click":
-        #         pyautogui.doubleClick(x=x, y=y, interval=interval, button=button)
-        #     elif action=='triple_click':
-        #         pyautogui.tripleClick(x=x,y=y,interval=interval,  button=button)
-        # else:
+    elif action in ["click", "double_click", "triple_click"]:
         if action == "click":
             pyautogui.moveTo(x_offset, y_offset, duration=duration)
             time.sleep(wait)
-            pyautogui.click(x=x_offset, y=y_offset, clicks=n_click, interval=interval, button=button)
+            pyautogui.click(
+                x=x_offset, y=y_offset, clicks=n_click, interval=interval, button=button
+            )
         elif action == "double_click":
             pyautogui.moveTo(x_offset, y_offset, duration=duration)
             time.sleep(wait)
-            pyautogui.doubleClick(x=x_offset, y=y_offset, interval=interval, button=button)
-        elif action=='triple_click':
+            pyautogui.doubleClick(
+                x=x_offset, y=y_offset, interval=interval, button=button
+            )
+        elif action == "triple_click":
             pyautogui.moveTo(x_offset, y_offset, duration=duration)
             time.sleep(wait)
-            pyautogui.tripleClick(x=x_offset, y=y_offset, interval=interval, button=button)
+            pyautogui.tripleClick(
+                x=x_offset, y=y_offset, interval=interval, button=button
+            )
 
     elif action in ["type", "write", "input"]:
         pyautogui.moveTo(x_offset, y_offset, duration=duration)
@@ -10785,7 +11197,7 @@ def mouse(
         if text is not None:
             pyautogui.typewrite(text, interval=interval)
         else:
-            raise ValueError("Text must be provided for the 'type' action.")
+            print("Text must be provided for the 'type' action.") if verbose else None
 
     elif action == "drag":
         if loc_type == "absolute":
@@ -10804,12 +11216,12 @@ def mouse(
         time.sleep(wait)
         pyautogui.scroll(scroll_amount)
 
-    elif action in ["down",'hold','press']:
+    elif action in ["down", "hold", "press"]:
         pyautogui.moveTo(x_offset, y_offset, duration=duration)
         time.sleep(wait)
         pyautogui.mouseDown(x_offset, y_offset, button=button, duration=duration)
 
-    elif action in ['up','release']:
+    elif action in ["up", "release"]:
         pyautogui.moveTo(x_offset, y_offset, duration=duration)
         time.sleep(wait)
         pyautogui.mouseUp(x_offset, y_offset, button=button, duration=duration)
@@ -10817,29 +11229,23 @@ def mouse(
     else:
         raise ValueError(f"Unsupported action: {action}")
 
-    # except pyautogui.ImageNotFoundException:
-    #     print(
-    #         "Image not found. Ensure the image is visible and parameters are correct."
-    #     )
-    # except Exception as e:
-    #     print(f"An error occurred: {e}")
-
-
 
 def py2installer(
-    script_path: str=None,
-    flatform:str="mingw64",
+    script_path: str = None,
+    flatform: str = "mingw64",
     output_dir: str = "dist",
     icon_path: str = None,
-    extra_data: list = None,
-    hidden_imports: list = None,
-    plugins:list=None,
+    include_data: list = None,
+    include_import: list = None,
+    exclude_import: list = None,
+    plugins: list = None,
     use_nuitka: bool = True,
-    onefile: bool = True,
     console: bool = True,
     clean_build: bool = False,
     additional_args: list = None,
     verbose: bool = True,
+    standalone: bool = True,
+    onefile: bool = False,
     use_docker: bool = False,
     docker_image: str = "python:3.12-slim",
 ):
@@ -10849,11 +11255,10 @@ def py2installer(
     script_path (str): Path to the Python script to package.
     output_dir (str): Directory where the executable will be stored.
     icon_path (str): Path to the .ico file for the executable icon.
-    extra_data (list): List of additional data files or directories in "source:dest" format.
-    hidden_imports (list): List of hidden imports to include.
+    include_data (list): List of additional data files or directories in "source:dest" format.
+    exclude_import (list): List of hidden imports to include.
     plugins (list): List of plugins imports to include.e.g., 'tk-inter'
     use_nuitka (bool): Whether to use Nuitka instead of PyInstaller.
-    onefile (bool): If True, produces a single executable file.
     console (bool): If False, hides the console window (GUI mode).
     clean_build (bool): If True, cleans previous build and dist directories.
     additional_args (list): Additional arguments for PyInstaller/Nuitka.
@@ -10870,15 +11275,16 @@ def py2installer(
     import sys
     import glob
     from pathlib import Path
+
     if run_once_within():
-        usage_str="""
-            # build locally 
+        usage_str = """
+            # build locally
             py2installer(
                 script_path="update_tab.py",
                 output_dir="dist",
                 icon_path="icon4app.ico",
-                extra_data=["dat/*.xlsx:dat"],
-                hidden_imports=["msoffcrypto", "tkinter", "pandas", "numpy"],
+                include_data=["dat/*.xlsx:dat"],
+                exclude_import=["msoffcrypto", "tkinter", "pandas", "numpy"],
                 onefile=True,
                 console=False,
                 clean_build=True,
@@ -10893,6 +11299,26 @@ def py2installer(
                 use_docker=True,
                 docker_image="python:3.12-slim"
             )
+            # 尽量不要使用--include-package,这可能导致冲突
+            py2installer(
+                script_path="update_tab.py",
+                # flatform=None,
+                output_dir="dist_simp_subprocess",
+                icon_path="icon4app.ico",
+                standalone=True,
+                onefile=False,
+                include_data=["dat/*.xlsx=dat"],
+                plugins=[
+                    "tk-inter",
+                ],
+                use_nuitka=True,
+                console=True,
+                clean_build=False,
+                verbose=0,
+            )
+            # 最终文件大小对比
+            900 MB: nuitka --mingw64 --standalone --windows-console-mode=attach --show-progress --output-dir=dist --macos-create-app-bundle --macos-app-icon=icon4app.ico --nofollow-import-to=timm,paddle,torch,torchmetrics,torchvision,tensorflow,tensorboard,tensorboardx,tensorboard-data-server,textblob,PIL,sklearn,scienceplots,scikit-image,scikit-learn,scikit-surprise,scipy,spikeinterface,spike-sort-lfpy,stanza,statsmodels,streamlit,streamlit-autorefresh,streamlit-folium,pkg2ls,plotly --include-package=msoffcrypto,tkinter,datetime,pandas,numpy --enable-plugin=tk-inter update_tab.py;
+            470 MB: nuitka --mingw64 --standalone --windows-console-mode=attach --show-progress --output-dir=dist_direct_nuitka --macos-create-app-bundle --macos-app-icon=icon4app.ico --enable-plugin=tk-inter update_taby ;
         """
         print(usage_str)
         if verbose:
@@ -10904,7 +11330,7 @@ def py2installer(
     if not script_path.exists():
         raise FileNotFoundError(f"Script '{script_path}' not found.")
 
-     # Clean build and dist directories if requested
+    # Clean build and dist directories if requested
     if clean_build:
         for folder in ["build", "dist"]:
             folder_path = Path(folder)
@@ -10914,12 +11340,13 @@ def py2installer(
         for folder in ["build", "dist"]:
             folder_path = Path(folder)
             folder_path.mkdir(parents=True, exist_ok=True)
-                
 
     if use_docker:
         # Ensure Docker is installed
         try:
-            subprocess.run(["docker", "--version"], check=True, capture_output=True, text=True)
+            subprocess.run(
+                ["docker", "--version"], check=True, capture_output=True, text=True
+            )
         except FileNotFoundError:
             raise EnvironmentError("Docker is not installed or not in the PATH.")
 
@@ -10931,11 +11358,16 @@ def py2installer(
             f"{dist_path}:/output:rw",
         ]
         docker_cmd = [
-            "docker", "run", "--rm",
-            "-v", volumes[0],
-            "-v", volumes[1],
+            "docker",
+            "run",
+            "--rm",
+            "-v",
+            volumes[0],
+            "-v",
+            volumes[1],
             docker_image,
-            "bash", "-c",
+            "bash",
+            "-c",
         ]
 
         # Build the packaging command inside the container
@@ -10947,11 +11379,11 @@ def py2installer(
         cmd.extend(["--distpath", "/output"])
         if icon_path:
             cmd.extend(["--icon", f"/app/{Path(icon_path).name}"])
-        if extra_data:
-            for data in extra_data:
+        if include_data:
+            for data in include_data:
                 cmd.extend(["--add-data", f"/app/{data}"])
-        if hidden_imports:
-            for hidden in hidden_imports:
+        if exclude_import:
+            for hidden in exclude_import:
                 cmd.extend(["--hidden-import", hidden])
         if additional_args:
             cmd.extend(additional_args)
@@ -10976,25 +11408,32 @@ def py2installer(
             raise
     else:
         # Handle local packaging (native build)
-        cmd = ["nuitka"]
-        cmd.append("--standalone")  # Make sure to use --standalone for independent environments
-        if 'min' in flatform.lower():
+        cmd = ["nuitka"] if use_nuitka else ["pyinstaller"]
+        if "min" in flatform.lower() and use_nuitka:
             cmd.append("--mingw64")
-        if onefile:
-            cmd.append("--onefile")
+        cmd.append("--standalone") if use_nuitka and standalone else None
+        cmd.append("--onefile") if onefile else None
         if not console:
-            # cmd.append("--windows-disable-console")  # Disabled based on your request
-            pass
+            cmd.append("--windows-console-mode=disable")
+        else:
+            cmd.append("--windows-console-mode=attach")
 
-        cmd.extend([f"--output-dir={output_dir}"])  # Correct the space issue here
+        cmd.extend(["--show-progress", f"--output-dir={output_dir}"])
         if icon_path:
             icon_path = Path(icon_path)
             if not icon_path.exists():
                 raise FileNotFoundError(f"Icon file '{icon_path}' not found.")
-            cmd.extend([f"--windows-icon-from-ico={icon_path}"])
+            if sys.platform == "darwin":  # macOS platform
+                cmd.extend(
+                    ["--macos-create-app-bundle", f"--macos-app-icon={icon_path}"]
+                )
+            elif sys.platform == "win32":  # Windows platform
+                cmd.extend([f"--windows-icon-from-ico={icon_path}"])
+            elif sys.platform == "linux":  # Linux platform
+                cmd.append("--linux-onefile")
 
-        if extra_data:
-            for data in extra_data:
+        if include_data:
+            for data in include_data:
                 if "*" in data:
                     matches = glob.glob(data.split(":")[0])
                     for match in matches:
@@ -11009,30 +11448,47 @@ def py2installer(
                     cmd.extend(
                         ["--include-data-file=" if use_nuitka else "--add-data", data]
                     )
-
-        if hidden_imports:
-            cmd.extend([f"--nofollow-import-to={','.join(hidden_imports)}"])
-
+        if exclude_import is not None:
+            if any(exclude_import):
+                cmd.extend([f"--nofollow-import-to={','.join(exclude_import)}"])
+        if include_import is not None:
+            if any(
+                include_import
+            ):  # are included in the final build. Some packages may require manual inclusion.
+                cmd.extend([f"--include-package={','.join(include_import)}"])
         if plugins:
             for plugin in plugins:
-                cmd.extend([f"--plugin-enable={plugin}"])
+                # Adds support for tkinter, ensuring it works correctly in the standalone build.
+                cmd.extend([f"--enable-plugin={plugin}"])
 
         if additional_args:
             cmd.extend(additional_args)
 
+        # # clean
+        # cmd.extend(
+        #     [   "--noinclude-numba-mode=nofollow", #Prevents the inclusion of the numba library and its dependencies, reducing the executable size.
+        #         "--noinclude-dask-mode=nofollow",#Excludes the dask library
+        #         "--noinclude-IPython-mode=nofollow",#Excludes the IPython library and its dependencies.
+        #         "--noinclude-unittest-mode=nofollow",#Excludes the unittest module (used for testing) from the build
+        #         "--noinclude-pytest-mode=nofollow",#Excludes the pytest library (used for testing) from the build.
+        #         "--noinclude-setuptools-mode=nofollow",#Excludes setuptools, which is not needed for the standalone executable.
+        #         "--lto=no",#Disables Link-Time Optimization (LTO), which reduces the compilation time but may slightly increase the size of the output.
+        #     ]
+        # )
+
+        if clean_build:
+            cmd.append(
+                "--remove-output"
+            )  # Removes intermediate files created during the build process, keeping only the final executable.
         # Add the script path (final positional argument)
         cmd.append(str(script_path))
-
         # Ensure Windows shell compatibility
         shell_flag = sys.platform.startswith("win")
-
-        # Run the command
-        if verbose:
-            print(f"Running command: {' '.join(cmd)}")
+        print(f"Running command: ⤵ \n{' '.join(cmd)}\n")
         try:
             result = subprocess.run(
                 cmd,
-                capture_output=not verbose,
+                capture_output=True,
                 text=True,
                 shell=shell_flag,
                 check=True,
@@ -11045,4 +11501,3 @@ def py2installer(
             raise
 
     print("\nPackaging complete. Check the output directory for the executable.")
-