py2ls 0.1.4.2__py3-none-any.whl → 0.1.4.5__py3-none-any.whl

py2ls/.git/COMMIT_EDITMSG

@@ -1,3 +1 @@
-Update netfinder.py
-
-new features: iframe, disable_image, capabilities
+update xample_imgsets

py2ls/.git/FETCH_HEAD

@@ -1 +1 @@
-48a88fc5806305d0bb0755ee6801161b79696972		branch 'main' of https://github.com/Jianfengliu0413/py2ls
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f		branch 'main' of https://github.com/Jianfengliu0413/py2ls

py2ls/.git/logs/HEAD

@@ -6,3 +6,9 @@ d9c2403fd166ce791b4e9d0c6792ed8342c71fcd 14449a0e6ba4ea2f1a73acf63ef91c9c6193f9e
 0b409e1bc918277010f5679b402d1d1dda53e15c 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718393734 +0200	commit: Update ips.py
 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f Jianfeng <Jianfeng.Liu0413@gmail.com> 1718491087 +0200	commit: Update netfinder.py
 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718526957 +0200	commit: Update netfinder.py
+48a88fc5806305d0bb0755ee6801161b79696972 cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d Jianfeng <Jianfeng.Liu0413@gmail.com> 1718553462 +0200	commit: new feature: display_thumbnail_figure
+cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d 6427a4edff08f93d98f511418423f09f2ab90bcd Jianfeng <Jianfeng.Liu0413@gmail.com> 1718555179 +0200	commit: listdir type
+6427a4edff08f93d98f511418423f09f2ab90bcd d9dfa5aee51e92a541b707e8e7baea6f06deff98 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718570098 +0200	commit: imgsets update
+d9dfa5aee51e92a541b707e8e7baea6f06deff98 e31356f90ea6dd0577b5e0b40b206319adcbf085 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718618413 +0200	commit: add thumbnail
+e31356f90ea6dd0577b5e0b40b206319adcbf085 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng <Jianfeng.Liu0413@gmail.com> 1718619568 +0200	commit: Update ips.py
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 627c81b23b4e56e87b042b650b0103653cc9e34a Jianfeng <Jianfeng.Liu0413@gmail.com> 1718698925 +0200	commit: update xample_imgsets

py2ls/.git/logs/refs/heads/main

@@ -6,3 +6,9 @@ d9c2403fd166ce791b4e9d0c6792ed8342c71fcd 14449a0e6ba4ea2f1a73acf63ef91c9c6193f9e
 0b409e1bc918277010f5679b402d1d1dda53e15c 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718393734 +0200	commit: Update ips.py
 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f Jianfeng <Jianfeng.Liu0413@gmail.com> 1718491087 +0200	commit: Update netfinder.py
 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718526957 +0200	commit: Update netfinder.py
+48a88fc5806305d0bb0755ee6801161b79696972 cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d Jianfeng <Jianfeng.Liu0413@gmail.com> 1718553462 +0200	commit: new feature: display_thumbnail_figure
+cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d 6427a4edff08f93d98f511418423f09f2ab90bcd Jianfeng <Jianfeng.Liu0413@gmail.com> 1718555179 +0200	commit: listdir type
+6427a4edff08f93d98f511418423f09f2ab90bcd d9dfa5aee51e92a541b707e8e7baea6f06deff98 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718570098 +0200	commit: imgsets update
+d9dfa5aee51e92a541b707e8e7baea6f06deff98 e31356f90ea6dd0577b5e0b40b206319adcbf085 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718618413 +0200	commit: add thumbnail
+e31356f90ea6dd0577b5e0b40b206319adcbf085 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng <Jianfeng.Liu0413@gmail.com> 1718619568 +0200	commit: Update ips.py
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 627c81b23b4e56e87b042b650b0103653cc9e34a Jianfeng <Jianfeng.Liu0413@gmail.com> 1718698925 +0200	commit: update xample_imgsets

py2ls/.git/logs/refs/remotes/origin/HEAD

@@ -9,3 +9,29 @@ d9c2403fd166ce791b4e9d0c6792ed8342c71fcd d9c2403fd166ce791b4e9d0c6792ed8342c71fc
 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718393737 +0200	remote set-head
 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718491090 +0200	remote set-head
 48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718526960 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718529062 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718531693 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718533521 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718535485 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718537443 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718539464 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718541421 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718543586 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718545544 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718547501 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718549457 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718551415 +0200	remote set-head
+48a88fc5806305d0bb0755ee6801161b79696972 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718553371 +0200	remote set-head
+cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718553465 +0200	remote set-head
+6427a4edff08f93d98f511418423f09f2ab90bcd 6427a4edff08f93d98f511418423f09f2ab90bcd Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718555183 +0200	remote set-head
+6427a4edff08f93d98f511418423f09f2ab90bcd 6427a4edff08f93d98f511418423f09f2ab90bcd Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718570095 +0200	remote set-head
+d9dfa5aee51e92a541b707e8e7baea6f06deff98 d9dfa5aee51e92a541b707e8e7baea6f06deff98 Jianfeng Liu <macjianfeng@jflmbp.speedport.ip> 1718570102 +0200	remote set-head
+e31356f90ea6dd0577b5e0b40b206319adcbf085 e31356f90ea6dd0577b5e0b40b206319adcbf085 Jianfeng Liu <macjianfeng@JFLMBP.local> 1718618416 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718619571 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718698084 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718699917 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718701729 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718703544 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718705358 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718707170 +0200	remote set-head
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng Liu <macjianfeng@JFLMBP.local> 1718708982 +0200	remote set-head

py2ls/.git/logs/refs/remotes/origin/main

@@ -6,3 +6,8 @@ d9c2403fd166ce791b4e9d0c6792ed8342c71fcd 14449a0e6ba4ea2f1a73acf63ef91c9c6193f9e
 0b409e1bc918277010f5679b402d1d1dda53e15c 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718393736 +0200	update by push
 6b7fde264d93a7a0986d394c46c7650d0ce2ab92 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f Jianfeng <Jianfeng.Liu0413@gmail.com> 1718491090 +0200	update by push
 3bbd972aa7ad680858f8dfbd0f7fcd97756f0d6f 48a88fc5806305d0bb0755ee6801161b79696972 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718526959 +0200	update by push
+48a88fc5806305d0bb0755ee6801161b79696972 cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d Jianfeng <Jianfeng.Liu0413@gmail.com> 1718553464 +0200	update by push
+cf0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d 6427a4edff08f93d98f511418423f09f2ab90bcd Jianfeng <Jianfeng.Liu0413@gmail.com> 1718555183 +0200	update by push
+6427a4edff08f93d98f511418423f09f2ab90bcd d9dfa5aee51e92a541b707e8e7baea6f06deff98 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718570102 +0200	update by push
+d9dfa5aee51e92a541b707e8e7baea6f06deff98 e31356f90ea6dd0577b5e0b40b206319adcbf085 Jianfeng <Jianfeng.Liu0413@gmail.com> 1718618415 +0200	update by push
+e31356f90ea6dd0577b5e0b40b206319adcbf085 1ab4585881a6a42889f01aa0cfe25fd5acfaf46f Jianfeng <Jianfeng.Liu0413@gmail.com> 1718619570 +0200	update by push

py2ls/.git/objects/62/d90ccf8cbefdc2e4fd475e7c6f4f76e9fdf801

@@ -0,0 +1,3 @@
+x
M��
+�0���S�]�����tMY�Kk���s��\��w~\�n��a�Y9����DP�\a�����$�p�8�,
+���#[Ԅ��2fJ�Y��݄�I#���RcGb����~�k"*���Z�'��/Y�n]-��v�)�6{m����]�J�

py2ls/.git/objects/cf/0c0d9c6fb09473aaeb7f7e2edbd770c3f2ef3d

@@ -0,0 +1 @@
+x
�NIj1�Y��{����4&�C�`�Qk,�4f�!������K-PU�Zk�,��F�����n&�MJd�u$7=eV�1�{ظu0>x�g�h5R��1[�RZ�d�a��u��Z���ʎF��RC��~�t�ic|�B�7;�] �B����O���~�~�klc���2�!^Q�

py2ls/.git/refs/heads/main

@@ -1 +1 @@
-48a88fc5806305d0bb0755ee6801161b79696972
+627c81b23b4e56e87b042b650b0103653cc9e34a

py2ls/.git/refs/remotes/origin/main

@@ -1 +1 @@
-48a88fc5806305d0bb0755ee6801161b79696972
+1ab4585881a6a42889f01aa0cfe25fd5acfaf46f

py2ls/__init__.py

@@ -7,11 +7,10 @@ from . import (
     correlators, 
     dbhandler, 
     freqanalysis, 
-    internet_finder, 
     ips, 
     netfinder, 
     sleep_events_detectors, 
     translator, 
-    version, 
     wb_detector, 
     )
+from .ips import *

py2ls/ips.py

@@ -3,7 +3,6 @@ import numpy as np
 import pandas as pd
 import json
 import matplotlib.pyplot as plt
-# from functools import partial
 import seaborn as sns
 import scienceplots
 import matplotlib
@@ -15,7 +14,7 @@ from scipy import stats
 import matplotlib.ticker as tck 
 from cycler import cycler
 import re
-from PIL import ImageEnhance, ImageOps,ImageFilter
+from PIL import Image,ImageEnhance, ImageOps,ImageFilter
 from rembg import remove,new_session
 from mpl_toolkits.mplot3d import Axes3D
 import docx
@@ -36,6 +35,8 @@ import time
 from box import Box, BoxList
 from numerizer import numerize
 from tqdm import tqdm
+import mimetypes
+from pprint import pp
 
 def str2num(s, *args):
     delimiter = None
@@ -778,14 +779,15 @@ def dir_name(fpath):
     return dirname(fpath)
 def basename(fpath):
     return os.path.basename(fpath)
+
 def listdir(
     rootdir,
     kind="folder",
     sort_by="name",
     ascending=True,
     contains=None,
-    orient = "list",
-    output='df'
+    orient="list",
+    output="df"
 ):
     def sort_kind(df, by="name", ascending=True):
         if df[by].dtype == 'object':  # Check if the column contains string values
@@ -801,6 +803,69 @@ def listdir(
         sorted_df = df.iloc[sorted_index].reset_index(drop=True)
         return sorted_df
 
+    def flist(fpath, filter="all"):
+        all_files = [os.path.join(fpath, f) for f in os.listdir(fpath) if os.path.isfile(os.path.join(fpath, f))]
+        if isinstance(filter, list):
+            filt_files = []
+            for filter_ in filter:
+                filt_files.extend(flist(fpath, filter_))
+            return filt_files
+        else:
+            if 'all' in filter.lower():
+                return all_files
+            else:
+                filt_files = [f for f in all_files if istype(f, filter)]
+                return filt_files
+
+    def istype(fpath, filter='img'):
+        """
+        Filters file paths based on the specified filter.
+        Args:
+            fpath (str): Path to the file.
+            filter (str): Filter of file to filter. Default is 'img' for images. Other options include 'doc' for documents,
+                        'zip' for ZIP archives, and 'other' for other types of files.
+        Returns:
+            bool: True if the file matches the filter, False otherwise.
+        """
+        if 'img' in filter.lower():
+            return is_image(fpath)
+        elif 'doc' in filter.lower():
+            return is_document(fpath)
+        elif 'zip' in filter.lower():
+            return is_zip(fpath)
+        else:
+            return False
+
+    def is_image(fpath):
+        mime_type, _ = mimetypes.guess_type(fpath)
+        if mime_type and mime_type.startswith('image'):
+            return True
+        else:
+            return False
+
+    def is_document(fpath):
+        mime_type, _ = mimetypes.guess_type(fpath)
+        if mime_type and (
+            mime_type.startswith('text/') or
+            mime_type == 'application/pdf' or
+            mime_type == 'application/msword' or
+            mime_type == 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' or
+            mime_type == 'application/vnd.ms-excel' or
+            mime_type == 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' or
+            mime_type == 'application/vnd.ms-powerpoint' or
+            mime_type == 'application/vnd.openxmlformats-officedocument.presentationml.presentation'
+        ):
+            return True
+        else:
+            return False
+
+    def is_zip(fpath):
+        mime_type, _ = mimetypes.guess_type(fpath)
+        if mime_type == 'application/zip':
+            return True
+        else:
+            return False
+
     if not kind.startswith("."):
         kind = "." + kind
 
@@ -814,7 +879,7 @@ def listdir(
             "path": [],
             "created_time": [],
             "modified_time": [],
-            "last_open_time":[],
+            "last_open_time": [],
             "size": [],
             "fname": [],
             "fpath": [],
@@ -828,16 +893,20 @@ def listdir(
             is_file = kind.lower() in file_extension.lower() and (
                 os.path.isfile(item_path)
             )
-            if not is_folder and not is_file:
-                continue
+            if kind in ['.doc','.img','.zip']: #选择大的类别
+                if kind != ".folder" and not istype(item_path, kind):
+                    continue
+            else: #精确到文件的后缀
+                if not is_folder and not is_file:
+                    continue
             f["name"].append(filename)
             f["length"].append(len(filename))
             f["path"].append(os.path.join(os.path.dirname(item_path), item))
-            fpath=os.path.join(os.path.dirname(item_path), item)
+            fpath = os.path.join(os.path.dirname(item_path), item)
             f["size"].append(round(os.path.getsize(fpath) / 1024 / 1024, 3))
-            f["created_time"].append(pd.to_datetime(os.path.getctime(item_path),unit='s'))
-            f["modified_time"].append(pd.to_datetime(os.path.getmtime(item_path),unit='s'))
-            f['last_open_time'].append(pd.to_datetime(os.path.getatime(item_path),unit='s'))
+            f["created_time"].append(pd.to_datetime(os.path.getctime(item_path), unit='s'))
+            f["modified_time"].append(pd.to_datetime(os.path.getmtime(item_path), unit='s'))
+            f['last_open_time'].append(pd.to_datetime(os.path.getatime(item_path), unit='s'))
             f["fname"].append(filename)  # will be removed
             f["fpath"].append(fpath)  # will be removed
             i += 1
@@ -850,32 +919,35 @@ def listdir(
             'The directory "{}" does NOT exist. Please check the directory "rootdir".'.format(
                 rootdir
             )
-        ) 
+        )
+
     f = pd.DataFrame(f)
+
     if contains is not None:
-        f = f[f["name"].str.contains(contains,case=False)]
+        f = f[f["name"].str.contains(contains, case=False)]
+
     if "nam" in sort_by.lower():
-        # f.sort_values(by="name", ascending=ascending, ignore_index=True, inplace=True)
-        f=sort_kind(f, by="name", ascending=ascending)
+        f = sort_kind(f, by="name", ascending=ascending)
     elif "crea" in sort_by.lower():
-        f=sort_kind(f, by="created_time", ascending=ascending)
+        f = sort_kind(f, by="created_time", ascending=ascending)
     elif "modi" in sort_by.lower():
-        f=sort_kind(f, by="modified_time", ascending=ascending)
+        f = sort_kind(f, by="modified_time", ascending=ascending)
     elif "s" in sort_by.lower() and "z" in sort_by.lower():
-        f=sort_kind(f, by="size", ascending=ascending)
+        f = sort_kind(f, by="size", ascending=ascending)
+
     if 'df' in output:
         return f
     else:
-        if 'l' in orient.lower(): # list # default
+        if 'l' in orient.lower():  # list # default
             res_output = Box(f.to_dict(orient="list"))
             return res_output
-        if 'd' in orient.lower(): # dict
+        if 'd' in orient.lower():  # dict
             return Box(f.to_dict(orient="dict"))
-        if 'r' in orient.lower(): # records
+        if 'r' in orient.lower():  # records
             return Box(f.to_dict(orient="records"))
-        if 'in' in orient.lower(): # records
+        if 'in' in orient.lower():  # records
             return Box(f.to_dict(orient="index"))
-        if 'se' in orient.lower(): # records
+        if 'se' in orient.lower():  # records
             return Box(f.to_dict(orient="series"))
 
 # Example usage:
@@ -2035,7 +2107,6 @@ def load_img(fpath):
         FileNotFoundError: If the specified file is not found.
         OSError: If the specified file cannot be opened or is not a valid image file.
     """
-    from PIL import Image
 
     try:
         img = Image.open(fpath)
@@ -2116,6 +2187,7 @@ def apply_filter(img, *args):
             raise ValueError(
                 f"Unsupported filter: {filter_name}, should be one of: {supported_filters}"
             )
+
     for arg in args:
         if isinstance(arg, str):
             filter_name = arg
@@ -2214,6 +2286,29 @@ def imgsets(
     Note:
         The "color" and "enhance" enhancements are not implemented in this function.
     """
+    supported_filters = [
+                "BLUR",
+                "CONTOUR",
+                "DETAIL",
+                "EDGE_ENHANCE",
+                "EDGE_ENHANCE_MORE",
+                "EMBOSS",
+                "FIND_EDGES",
+                "SHARPEN",
+                "SMOOTH",
+                "SMOOTH_MORE",
+                "MIN_FILTER",
+                "MAX_FILTER",
+                "MODE_FILTER",
+                "MULTIBAND_FILTER",
+                "GAUSSIAN_BLUR",
+                "BOX_BLUR",
+                "MEDIAN_FILTER",
+            ]
+    print("sets: a dict,'sharp:1.2','color','contrast:'auto' or 1.2','bright', 'crop: x_upperleft,y_upperleft, x_lowerright, y_lowerright','rotation','resize','rem or background'")
+    print(f"usage: filter_kws 'dict' below:")
+    pp([str(i).lower() for i in supported_filters])
+    print("\nlog:\n")
     def confirm_rembg_models(model_name):
         models_support = [
             "u2net",
@@ -2662,6 +2757,46 @@ def figsets(*args):
         plt.tight_layout()
         plt.gcf().align_labels()
 
+def thumbnail(dir_img_list,figsize=(10,10),dpi=100, dir_save=None, kind='.png'):
+    """
+    Display a thumbnail figure of all images in the specified directory.
+    Args:
+        dir_img_list (list): List of the Directory containing the images.
+    """
+    num_images = len(dir_img_list)
+    if not kind.startswith('.'):
+        kind='.'+kind
+
+    if num_images == 0:
+        print("No images found to display.")
+        return
+    grid_size = int(num_images ** 0.5) + 1 # Determine grid size
+    fig, axs = plt.subplots(grid_size, grid_size, figsize=figsize,dpi=dpi)
+    for ax, image_file in zip(axs.flatten(), dir_img_list):
+        try:
+            img = Image.open(image_file)
+            ax.imshow(img)
+            ax.axis('off')
+        except:
+            continue
+    # for ax in axs.flatten():
+    #     ax.axis('off')
+    [ax.axis("off") for ax in axs.flatten()]
+    plt.tight_layout()
+    if dir_save is None:
+        plt.show()
+    else:
+        if basename(dir_save):
+            fname= basename(dir_save) +kind
+        else:
+            fname= "_thumbnail_"+basename(dirname(dir_save)[:-1])+'.png'
+        if dirname(dir_img_list[0]) == dirname(dir_save):
+            figsave(dirname(dir_save[:-1]),fname)
+        else:
+            figsave(dirname(dir_save),fname)
+# usage:
+# fpath = "/Users/macjianfeng/Dropbox/github/python/py2ls/tests/xample_netfinder/images/"
+# thumbnail(listdir(fpath,'png').fpath.to_list(),dir_save=dirname(fpath))
 def read_mplstyle(style_file):
     # Load the style file
     plt.style.use(style_file)