first commit

example_usage.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+文件重命名工具使用示例
+"""
+
+from file_renamer import FileRenamer
+
+
+def main():
+    """使用示例"""
+    # 创建重命名工具实例
+    renamer = FileRenamer()
+    
+    # 设置要处理的目录
+    directory = "./test_files"  # 请修改为实际的目录路径
+    
+    print("文件重命名工具使用示例")
+    print("=" * 30)
+    
+    # 1. 简单字符串替换
+    print("1. 简单字符串替换:")
+    print("将目录中所有文件名中的 'old' 替换为 'new'")
+    count = renamer.simple_rename(directory, "old", "new", preview=True)
+    print(f"预览模式下将重命名 {count} 个文件")
+    
+    # 2. 正则表达式替换
+    print("\n2. 正则表达式替换:")
+    print("将文件名中的数字替换为 # 符号")
+    count = renamer.regex_rename(directory, r"\d+", "#", preview=True)
+    print(f"预览模式下将重命名 {count} 个文件")
+    
+    # 3. 添加前缀
+    print("\n3. 添加前缀:")
+    print("为所有文件添加 'PREFIX_' 前缀")
+    count = renamer.add_prefix(directory, "PREFIX_", preview=True)
+    print(f"预览模式下将重命名 {count} 个文件")
+    
+    # 4. 添加后缀
+    print("\n4. 添加后缀:")
+    print("为所有文件添加 '_SUFFIX' 后缀")
+    count = renamer.add_suffix(directory, "_SUFFIX", preview=True)
+    print(f"预览模式下将重命名 {count} 个文件")
+    
+    # 5. 自动编号
+    print("\n5. 自动编号:")
+    print("为文件添加编号")
+    count = renamer.enumerate_files(directory, prefix="FILE_", start_number=1, digits=3, preview=True)
+    print(f"预览模式下将重命名 {count} 个文件")
+    
+    # 6. 大小写转换
+    print("\n6. 大小写转换:")
+    print("将所有文件名转换为小写")
+    count = renamer.change_case(directory, "lower", preview=True)
+    print(f"预览模式下将重命名 {count} 个文件")
+    
+    print("\n" + "=" * 30)
+    print("如需实际执行重命名，请将 preview 参数设为 False")
+
+
+if __name__ == "__main__":
+    main()