pyutilscripts 0.1.0b1__py3-none-any.whl

pyutilscripts/__init__.py

@@ -0,0 +1,12 @@
+"""
+PyUtilScripts 是一个基于 Python 的通用小工具集合，目标是提供编写通用任务的辅助工具。
+"""
+
+__version__ = "0.1.0"
+__status__  = "beta1"
+__author__  = "zero <zero.kwok@foxmail.com>"
+
+projectName    = 'PyUtilScripts'
+projectHome    = 'https://github.com/ZeroKwok/pyutilscripts.git'
+projectVersion = f'{__version__} {__status__}'.strip()
+projectAuthor  = __author__

pyutilscripts/fcopy.py

@@ -0,0 +1,116 @@
+#! python
+# -*- coding: utf-8 -*-
+#
+# This file is part of the PyUtilScripts project.
+# Copyright (c) 2020-2025 zero <zero.kwok@foxmail.com>
+#
+# For the full copyright and license information, please view the LICENSE
+# file that was distributed with this source code.
+#
+# ###
+#
+# 1. 以tree -aif命令输出的内容作为文件清单(如下).
+# 2. 通过脚本将(directory)原目录下的匹配文件, 拷贝到(output)目标目录.
+#
+# 语法如下
+# fcopy.py [-l,--list FILE] [-d,--directory DIRECTORY] <-o,--output DIRECTORY>
+#
+# CMD
+# python fcopy.py -l ../fcopy.list -d . -o "\\192.168.1.230\2024-01-26 1625"
+
+import os
+import shlex
+import sys
+import stat
+import shutil
+import filecmp
+import argparse
+import traceback
+from   termcolor import cprint
+
+def copy_files(source_directory, target_directory, manifest, report:dict):
+    for file in manifest:
+        source = os.path.normpath(os.path.join(source_directory, file))
+        target = os.path.normpath(os.path.join(target_directory, file))
+
+        try:
+            fs = os.stat(source)
+            if fs.st_mode & stat.S_IFDIR:
+                continue
+        except FileNotFoundError:
+            cprint(f'Failed: SourceFileNotFound -> {source}', 'red', file=sys.stderr)
+            report[0].setdefault('SourceFileNotFound', []).append(source)
+            continue
+        
+        if os.path.exists(target):
+            if filecmp.cmp(source, target):
+                print(f'Skip: SameFile -> {source} -> {target}')
+                report[1].setdefault('SkipSameFile', []).append(source)
+                continue
+            else:
+                print(f'Update: {source} -> {target}')
+                report[1].setdefault('Update', []).append(source)
+        else:
+            print(f'Copy: {source} -> {target}')
+            report[1].setdefault('Copy', []).append(source)
+            os.makedirs(os.path.dirname(target), exist_ok=True)
+        shutil.copy2(source, target)
+
+def read_file_list(file_path):
+    with open(file_path, 'r') as file:
+        return [line.strip() for line in file.readlines() if not line[0].isdigit()]
+
+def main(sequence = None):
+    try:
+        parser = argparse.ArgumentParser(description='Copy files from source directory to target directory.')
+        parser.add_argument('-l', '--list', default='fcopy.list', help='File containing the list of files to copy.')
+        parser.add_argument('-d', '--directory', default='.', help='Source directory where the files are located.')
+        parser.add_argument('-o', '--output', required=True, help='Target directory where the files will be copied.')
+        parser.add_argument('-v', '--verbose', action='store_true', default=False)
+
+        while True:
+            try:
+                args = parser.parse_args(shlex.split(sequence, posix=False) if sequence else None)
+                break
+            except SystemExit:
+                sequence = input('$ Please enter parameters:\n')
+                continue
+
+        for key in args.__dict__:
+            if type(args.__dict__[key]) == str:
+                args.__dict__[key] = args.__dict__[key].strip(' \'"')
+
+        if not args.list or not args.directory or not args.output:
+            print("Error: Please provide the required arguments.")
+            parser.print_help()
+            return
+
+        report = { 0 : {}, 1 : {} }
+        manifest = read_file_list(args.list)
+        copy_files(args.directory, args.output, manifest, report)
+
+        failed = {}
+        success = {}
+        for key in report[0]:
+            failed[key] = failed.setdefault(key, 0) + len(report[0][key])
+        for key in report[1]:
+            success[key] = success.setdefault(key, 0) + len(report[1][key])
+        failed  = [f'{i}: {failed[i]}' for i in failed]
+        success = [f'{i}: {success[i]}' for i in success]
+        
+        print()
+        if args.verbose:
+            print()
+            for key in report[0]:
+                for f in report[0][key]:
+                    cprint(f'{key}: {f}', 'red')
+            if 'Update' in report[1]:
+                for f in report[1]['Update']:
+                    cprint(f'{key}: {f}', 'green')
+        cprint(f'{", ".join(success)} {", ".join(failed)}', 'yellow' if failed else 'green')
+    except:
+        traceback.print_exc()
+
+
+if __name__ == "__main__":
+    main()

pyutilscripts/forward_tcp.py

@@ -0,0 +1,91 @@
+#! python
+# -*- coding: utf-8 -*-
+#
+# This file is part of the PyUtilScripts project.
+# Copyright (c) 2020-2025 zero <zero.kwok@foxmail.com>
+#
+# For the full copyright and license information, please view the LICENSE
+# file that was distributed with this source code.
+
+import sys
+import time
+import socket
+import argparse
+import threading
+
+listen_host = "0.0.0.0"
+listen_port = 8081
+
+target_host = "127.0.0.1"
+target_port = 1081
+
+verbose = False
+
+def log(message):
+    """Log messages if verbose mode is enabled."""
+    if verbose:
+        print(message)
+
+def run():
+    threading.Thread(target=server, daemon=True).start()
+    try:
+        print(f"Press [Ctrl + C] to exit ...")
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:  
+        print(f"KeyboardInterrupt: Aborting ...") 
+
+def server(*settings):
+    try:
+        dock_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        dock_socket.bind((listen_host, listen_port)) # listen
+        dock_socket.listen(5)
+        log("*** listening on %s:%i" % ( listen_host, listen_port ))
+        while True:
+            client_socket, client_address = dock_socket.accept()
+            
+            log("*** from %s:%i to %s:%i" % ( client_address, listen_port, target_host, target_port ))
+            server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            server_socket.connect((target_host, target_port))
+            threading.Thread(target=forward, args=(client_socket, server_socket, f"client -> server, {client_address}" ), daemon=True).start()
+            threading.Thread(target=forward, args=(server_socket, client_socket, f"server -> client, {client_address}" ), daemon=True).start()
+    finally:
+        dock_socket.close()
+        time.sleep(1)
+        threading.Thread(target=server, daemon=True).start()
+
+def forward(source, destination, description):
+    data = ' '
+    try:
+        while data:
+            data = source.recv(4096)
+            log(f"*** {description}, data length: {len(data)}")
+            if data:
+                destination.sendall(data)
+            else:
+                source.shutdown(socket.SHUT_RD)
+                destination.shutdown(socket.SHUT_WR)
+    except socket.error as e:
+        print(f"*** {description} {e.strerror}")
+        source.shutdown(socket.SHUT_RD)
+        destination.shutdown(socket.SHUT_WR)
+
+def main():
+    parser = argparse.ArgumentParser(description='Forward TCP traffic from source to destination')  
+    parser.add_argument('--src', '-s', required=True, type=str, help='The source IP address and port to listen on (e.g. 0.0.0.0:8081)')
+    parser.add_argument('--dst', '-d', required=True, type=str, help='The destination IP address and port to forward traffic to (e.g. 127.0.0.1:1081)')
+    parser.add_argument('-v', '--verbose', action='store_true', help='Enable verbose output')
+    
+    args = parser.parse_args()
+
+    # 解析后的参数
+    listen_host = args.src.split(':')[0]
+    listen_port = int(args.src.split(':')[1])
+    target_host = args.dst.split(':')[0]
+    target_port = int(args.dst.split(':')[1])
+    verbose = args.verbose
+
+    run()
+
+if __name__ == '__main__':
+    main()

pyutilscripts/prunedirs.py

@@ -0,0 +1,55 @@
+#! python
+# -*- coding: utf-8 -*-
+#
+# This file is part of the PyUtilScripts project.
+# Copyright (c) 2020-2025 zero <zero.kwok@foxmail.com>
+#
+# For the full copyright and license information, please view the LICENSE
+# file that was distributed with this source code.
+
+# 删除空目录
+# 注意: -rl递归列出要删除的空目录时, 结果可能比实际的少
+#       因为可能出现子文件夹是空目录, 删除后父目录也可以删除的情况.
+
+import os
+import sys
+import argparse
+
+def DoRemoveEmpty(directory:str, args):
+    for f in os.listdir(directory):
+        t = os.path.join(directory, f)
+        if not os.path.isdir(t):
+            continue
+        
+        # 若是目录则先递归一次
+        if args.recursion:
+            DoRemoveEmpty(t, args)
+
+        # 再看是否为空目录
+        if len(os.listdir(t)) == 0:
+            if args.list:
+                print(f'To be removed: {t}')
+            else:
+                print(f'Removed: {t}')
+                os.rmdir(t)
+            args.count = args.count + 1
+            continue
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument('-l', '--list', action='store_true', help='it is listed but not deleted')
+    parser.add_argument('-d', '--directory', type=str, default=os.getcwd(), help='specifies the directory on which to perform this operation')
+    parser.add_argument('-r', '--recursion', action='store_true', help='recursive file directory')
+    args = parser.parse_args()
+
+    if not args.list:
+        opt = input('Do you want to remove an empty directory (Yes/No)?')
+        if opt.lower() != 'yes':
+            exit(0)
+
+    args.count = 0
+    DoRemoveEmpty(args.directory, args)
+    print(f'Total: {args.count}')
+
+if __name__ == "__main__":
+    main()

pyutilscripts-0.1.0b1.dist-info/METADATA

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: pyutilscripts
+Version: 0.1.0b1
+Summary: PyUtilScripts 是一个基于 Python 的通用小工具集合，目标是提供编写通用任务的辅助工具。
+Author-email: Zero Kwok <zero.kwok@foxmail.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/ZeroKwok/pyutilscripts
+Project-URL: Issues, https://github.com/ZeroKwok/pyutilscripts/issues
+Keywords: tools
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: termcolor
+Dynamic: license-file
+
+# **PyUtilScripts**  
+
+`PyUtilScripts` 是一个基于 Python 的通用小工具集合，目标是提供编写通用任务的辅助工具。  
+
+## **📜 脚本列表**  
+
+| 脚本名称 | 功能描述 | 示例用法 |
+|----------|---------|---------|
+| [`fcopy.py`](fcopy.py) | 基于清单文件的复制工具 | `fcopy -l list.txt -s src_dir -d dest_dir` |
+| [`forward-tcp.py`](forward-tcp.py) | TCP 端口转发工具 | `forward-tcp -s 0.0.0.0:8081 -d 127.0.0.1:1081` |
+| [`prunedirs.py`](prunedirs.py) | 递归删除空目录 | `prunedirs /path/to/dir` |
+
+---
+
+## **⚙️ 安装与使用**  
+
+### **1. 克隆仓库**  
+
+```bash
+git clone https://github.com/ZeroKwok/PyUtilScripts.git
+cd PyUtilScripts
+```
+
+### **2. 直接运行（无需安装）**  
+
+所有脚本均可直接执行：  
+
+```bash
+python3 script_name.py [args]
+```

pyutilscripts-0.1.0b1.dist-info/RECORD

@@ -0,0 +1,10 @@
+pyutilscripts/__init__.py,sha256=inZvg58mvLd_5b4udszD3CEwCq3IOC6-MHDIIFsC7a0,406
+pyutilscripts/fcopy.py,sha256=mbzBZKoFdAoQ6jpmmcctjMfO1atzYaGA-y6MZBp2vFs,4433
+pyutilscripts/forward_tcp.py,sha256=ZI05AQ_hFFzuI8OigUD8MFBmdHgXPO63Qvtz36jr9KI,3263
+pyutilscripts/prunedirs.py,sha256=Wza7MfH6mqbC-VHHo_j7D1Svfpr7tx-QTTFluiob1wU,1830
+pyutilscripts-0.1.0b1.dist-info/licenses/LICENSE,sha256=qocFQjIOOjK3GfixkWhfONEEq5327ac3rYPx8FLebPE,1111
+pyutilscripts-0.1.0b1.dist-info/METADATA,sha256=8jEKh0TKGf2dqRSrEQiq5QNGEzucVNbOezDSYSflDxg,1928
+pyutilscripts-0.1.0b1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyutilscripts-0.1.0b1.dist-info/entry_points.txt,sha256=dHqHBHWojx-bkLpecsxkUZxh8pfAVvKVYIO2Xwh83Ao,137
+pyutilscripts-0.1.0b1.dist-info/top_level.txt,sha256=q1zRSvdJafzyewHd1b57EhgwB4_EzoMtMyOEMZzOKKs,14
+pyutilscripts-0.1.0b1.dist-info/RECORD,,

pyutilscripts-0.1.0b1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyutilscripts-0.1.0b1.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+fcopy = pyutilscripts.fcopy:main
+forward.tcp = pyutilscripts.forward_tcp:main
+prunedirs = pyutilscripts.prunedirs:main

pyutilscripts-0.1.0b1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-2025 Zero <zero.kwok@foxmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyutilscripts-0.1.0b1.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyutilscripts