file-org-kit 1.0.0__tar.gz

file_org_kit-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BoiledSaltedDuck
+
+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.

file_org_kit-1.0.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: file-org-kit
+Version: 1.0.0
+Summary: 文件智能分类整理工具 - 按类型或日期自动归档文件，告别杂乱下载目录
+Author-email: BoiledSaltedDuck <tools@office-tools.pro>
+License: MIT
+Keywords: file,organize,organizer,分类,整理,归档
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# file-org-kit 文件智能分类整理工具
+
+[![PyPI version](https://img.shields.io/pypi/v/file-org-kit)](https://pypi.org/project/file-org-kit/)
+[![Downloads](https://img.shields.io/pypi/dm/file-org-kit)](https://pypi.org/project/file-org-kit/)
+[![License](https://img.shields.io/pypi/l/file-org-kit)](https://github.com/BoiledSaltedDuck/file-org-kit/blob/main/LICENSE)
+
+## 安装
+
+```bash
+pip install file-org-kit
+```
+
+## 用法
+
+```bash
+# 按文件类型分类
+file-org ./下载/ type ./整理后/
+
+# 按修改日期分类
+file-org ./桌面/ date
+```
+
+## 按类型分类 (type)
+
+自动识别以下文件类型并分类到对应目录：
+
+| 类别 | 支持的扩展名 |
+|------|------------|
+| 图片 | jpg, png, gif, webp, svg, bmp, tiff... |
+| 文档 | pdf, doc, xls, ppt, txt, md, csv... |
+| 压缩包 | zip, rar, 7z, tar, gz, bz2... |
+| 视频 | mp4, avi, mkv, mov, flv... |
+| 音频 | mp3, wav, flac, aac, ogg... |
+| 代码 | py, js, java, go, rs, cpp, rb... |
+| 网页 | html, css, scss... |
+| 配置 | json, xml, yaml, toml, ini... |
+| 可执行 | exe, msi, apk, deb, rpm... |
+| 字体 | ttf, otf, woff... |
+
+## 按日期分类 (date)
+
+按文件的最后修改时间，自动以 `年-月` 格式分目录归档。
+
+## 特点
+
+- 零配置，安装即用
+- 自动处理重名文件（添加编号后缀）
+- 安全移动，非复制
+- 纯 Python，零依赖
+
+## 支持
+
+如果 file-org-kit 帮到了您，欢迎打赏支持：
+
+```
+USDT (TRC20): TMPQygMkv42QPeyYnkxMkPwsqs7udbD2Aa
+```
+
+您的支持是开源项目持续发展的动力 ❤️

file_org_kit-1.0.0/README.md

@@ -0,0 +1,59 @@
+# file-org-kit 文件智能分类整理工具
+
+[![PyPI version](https://img.shields.io/pypi/v/file-org-kit)](https://pypi.org/project/file-org-kit/)
+[![Downloads](https://img.shields.io/pypi/dm/file-org-kit)](https://pypi.org/project/file-org-kit/)
+[![License](https://img.shields.io/pypi/l/file-org-kit)](https://github.com/BoiledSaltedDuck/file-org-kit/blob/main/LICENSE)
+
+## 安装
+
+```bash
+pip install file-org-kit
+```
+
+## 用法
+
+```bash
+# 按文件类型分类
+file-org ./下载/ type ./整理后/
+
+# 按修改日期分类
+file-org ./桌面/ date
+```
+
+## 按类型分类 (type)
+
+自动识别以下文件类型并分类到对应目录：
+
+| 类别 | 支持的扩展名 |
+|------|------------|
+| 图片 | jpg, png, gif, webp, svg, bmp, tiff... |
+| 文档 | pdf, doc, xls, ppt, txt, md, csv... |
+| 压缩包 | zip, rar, 7z, tar, gz, bz2... |
+| 视频 | mp4, avi, mkv, mov, flv... |
+| 音频 | mp3, wav, flac, aac, ogg... |
+| 代码 | py, js, java, go, rs, cpp, rb... |
+| 网页 | html, css, scss... |
+| 配置 | json, xml, yaml, toml, ini... |
+| 可执行 | exe, msi, apk, deb, rpm... |
+| 字体 | ttf, otf, woff... |
+
+## 按日期分类 (date)
+
+按文件的最后修改时间，自动以 `年-月` 格式分目录归档。
+
+## 特点
+
+- 零配置，安装即用
+- 自动处理重名文件（添加编号后缀）
+- 安全移动，非复制
+- 纯 Python，零依赖
+
+## 支持
+
+如果 file-org-kit 帮到了您，欢迎打赏支持：
+
+```
+USDT (TRC20): TMPQygMkv42QPeyYnkxMkPwsqs7udbD2Aa
+```
+
+您的支持是开源项目持续发展的动力 ❤️

file_org_kit-1.0.0/file_org/__init__.py

@@ -0,0 +1,4 @@
+"""file-org-kit - 文件智能分类整理工具"""
+
+__version__ = "1.0.0"
+from . import organizer

file_org_kit-1.0.0/file_org/organizer.py

@@ -0,0 +1,134 @@
+#!/usr/bin/env python3
+"""
+file-org-kit - 文件智能分类整理工具
+功能：按扩展名/文件类型自动将文件分类到对应目录
+用法：file-org [输入目录] [模式] [输出目录(可选)]
+      file-org ./下载/ type ./整理后/
+      file-org ./桌面/ date
+"""
+import sys
+import shutil
+from pathlib import Path
+from datetime import datetime
+
+# 文件类型分类规则
+FILE_CATEGORIES = {
+    "图片": ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.webp', '.svg', '.ico', '.tiff', '.tif', '.psd', '.raw'],
+    "文档": ['.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx', '.txt', '.md', '.csv', '.odt', '.odp', '.ods'],
+    "压缩包": ['.zip', '.rar', '.7z', '.tar', '.gz', '.bz2', '.xz', '.zst', '.iso'],
+    "视频": ['.mp4', '.avi', '.mkv', '.mov', '.wmv', '.flv', '.webm', '.m4v', '.mpg', '.mpeg'],
+    "音频": ['.mp3', '.wav', '.flac', '.aac', '.ogg', '.wma', '.m4a', '.opus'],
+    "代码": ['.py', '.js', '.ts', '.java', '.cpp', '.c', '.h', '.hpp', '.go', '.rs', '.rb', '.php', '.swift', '.kt', '.scala', '.sh', '.bash', '.zsh', '.sql', '.r', '.pl'],
+    "网页": ['.html', '.htm', '.css', '.scss', '.less', '.jsx', '.tsx', '.vue', '.svelte'],
+    "配置文件": ['.json', '.xml', '.yaml', '.yml', '.toml', '.ini', '.cfg', '.conf', '.env', '.properties'],
+    "可执行文件": ['.exe', '.msi', '.appimage', '.deb', '.rpm', '.dmg', '.apk'],
+    "字体": ['.ttf', '.otf', '.woff', '.woff2', '.eot'],
+}
+
+def _get_category(ext):
+    """根据扩展名返回文件类别"""
+    ext = ext.lower()
+    for category, exts in FILE_CATEGORIES.items():
+        if ext in exts:
+            return category
+    return "其他"
+
+def _get_month_dir(date_obj):
+    """根据日期返回月份目录名，如 2026-06"""
+    return date_obj.strftime("%Y-%m")
+
+def org_by_type(input_dir, output_dir):
+    """按类型分类"""
+    src_path = Path(input_dir)
+    dst_path = Path(output_dir)
+    return _organize_files(src_path, dst_path, "type")
+
+def org_by_date(input_dir, output_dir):
+    """按日期分类"""
+    src_path = Path(input_dir)
+    dst_path = Path(output_dir)
+    return _organize_files(src_path, dst_path, "date")
+
+def _organize_files(src_path, dst_path, mode):
+    if not src_path.exists():
+        print(f"错误：目录 {src_path} 不存在")
+        return False
+
+    files = [f for f in src_path.iterdir() if f.is_file()]
+    if not files:
+        print(f"目录 {src_path} 中没有文件")
+        return False
+
+    print(f"找到 {len(files)} 个文件")
+    moved = 0
+
+    for f in sorted(files):
+        try:
+            if mode == "type":
+                cat = _get_category(f.suffix)
+                target_dir = dst_path / cat
+            elif mode == "date":
+                mtime = datetime.fromtimestamp(f.stat().st_mtime)
+                target_dir = dst_path / _get_month_dir(mtime)
+            else:
+                return False
+
+            target_dir.mkdir(parents=True, exist_ok=True)
+            target_path = target_dir / f.name
+
+            # 处理重名
+            counter = 1
+            while target_path.exists():
+                stem = f.stem
+                target_path = target_dir / f"{stem}_{counter}{f.suffix}"
+                counter += 1
+
+            shutil.move(str(f), str(target_path))
+            print(f"  ✓ {f.name} → {target_dir.name}/")
+            moved += 1
+
+        except Exception as e:
+            print(f"  ✗ {f.name} 移动失败: {e}")
+
+    print(f"\n完成！成功整理 {moved}/{len(files)} 个文件到 {dst_path}")
+    _show_promotion()
+    return moved > 0
+
+def _show_promotion():
+    print("\n" + "=" * 55)
+    print("  🔧 file-org-kit - 文件智能分类整理工具")
+    print("  📦 pip install file-org-kit")
+    print("  ☕ 如果帮到了您，欢迎打赏支持:")
+    print("     USDT(TRC20): TMPQygMkv42QPeyYnkxMkPwsqs7udbD2Aa")
+    print("  ⭐ https://github.com/BoiledSaltedDuck/file-org-kit")
+    print("=" * 55)
+
+def main():
+    if len(sys.argv) < 3:
+        print("用法: file-org [输入目录] [模式] [输出目录(可选)]")
+        print("模式:")
+        print("  type   - 按文件类型分类（图片、文档、视频等）")
+        print("  date   - 按修改日期分类（按年月分目录）")
+        print("示例: file-org ./下载/ type ./整理后/")
+        print("      file-org ./桌面/ date")
+        sys.exit(1)
+
+    input_dir = sys.argv[1]
+    mode = sys.argv[2].lower()
+
+    if mode not in ("type", "date"):
+        print(f"错误：不支持的模式 '{mode}'，仅支持 type 和 date")
+        sys.exit(1)
+
+    output_dir = sys.argv[3] if len(sys.argv) > 3 else f"{input_dir.rstrip('/')}_整理后"
+
+    if mode == "type":
+        success = org_by_type(input_dir, output_dir)
+    else:
+        success = org_by_date(input_dir, output_dir)
+
+    sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()

file_org_kit-1.0.0/file_org_kit.egg-info/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: file-org-kit
+Version: 1.0.0
+Summary: 文件智能分类整理工具 - 按类型或日期自动归档文件，告别杂乱下载目录
+Author-email: BoiledSaltedDuck <tools@office-tools.pro>
+License: MIT
+Keywords: file,organize,organizer,分类,整理,归档
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# file-org-kit 文件智能分类整理工具
+
+[![PyPI version](https://img.shields.io/pypi/v/file-org-kit)](https://pypi.org/project/file-org-kit/)
+[![Downloads](https://img.shields.io/pypi/dm/file-org-kit)](https://pypi.org/project/file-org-kit/)
+[![License](https://img.shields.io/pypi/l/file-org-kit)](https://github.com/BoiledSaltedDuck/file-org-kit/blob/main/LICENSE)
+
+## 安装
+
+```bash
+pip install file-org-kit
+```
+
+## 用法
+
+```bash
+# 按文件类型分类
+file-org ./下载/ type ./整理后/
+
+# 按修改日期分类
+file-org ./桌面/ date
+```
+
+## 按类型分类 (type)
+
+自动识别以下文件类型并分类到对应目录：
+
+| 类别 | 支持的扩展名 |
+|------|------------|
+| 图片 | jpg, png, gif, webp, svg, bmp, tiff... |
+| 文档 | pdf, doc, xls, ppt, txt, md, csv... |
+| 压缩包 | zip, rar, 7z, tar, gz, bz2... |
+| 视频 | mp4, avi, mkv, mov, flv... |
+| 音频 | mp3, wav, flac, aac, ogg... |
+| 代码 | py, js, java, go, rs, cpp, rb... |
+| 网页 | html, css, scss... |
+| 配置 | json, xml, yaml, toml, ini... |
+| 可执行 | exe, msi, apk, deb, rpm... |
+| 字体 | ttf, otf, woff... |
+
+## 按日期分类 (date)
+
+按文件的最后修改时间，自动以 `年-月` 格式分目录归档。
+
+## 特点
+
+- 零配置，安装即用
+- 自动处理重名文件（添加编号后缀）
+- 安全移动，非复制
+- 纯 Python，零依赖
+
+## 支持
+
+如果 file-org-kit 帮到了您，欢迎打赏支持：
+
+```
+USDT (TRC20): TMPQygMkv42QPeyYnkxMkPwsqs7udbD2Aa
+```
+
+您的支持是开源项目持续发展的动力 ❤️

file_org_kit-1.0.0/file_org_kit.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+file_org/__init__.py
+file_org/organizer.py
+file_org_kit.egg-info/PKG-INFO
+file_org_kit.egg-info/SOURCES.txt
+file_org_kit.egg-info/dependency_links.txt
+file_org_kit.egg-info/entry_points.txt
+file_org_kit.egg-info/top_level.txt

file_org_kit-1.0.0/file_org_kit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

file_org_kit-1.0.0/file_org_kit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+file-org = file_org.organizer:main

file_org_kit-1.0.0/file_org_kit.egg-info/top_level.txt

@@ -0,0 +1 @@
+file_org

file_org_kit-1.0.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "file-org-kit"
+version = "1.0.0"
+description = "文件智能分类整理工具 - 按类型或日期自动归档文件，告别杂乱下载目录"
+readme = "README.md"
+authors = [
+    {name = "BoiledSaltedDuck", email = "tools@office-tools.pro"}
+]
+license = {text = "MIT"}
+keywords = ["file", "organize", "organizer", "分类", "整理", "归档"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: System :: Filesystems",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.7"
+dependencies = []
+
+[project.scripts]
+file-org = "file_org.organizer:main"
+
+[tool.setuptools.packages.find]
+include = ["file_org*"]

file_org_kit-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+