cm-filekit 1.0.0__tar.gz

cm_filekit-1.0.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: cm_filekit
+Version: 1.0.0
+Summary: 计算概论C课程文件夹扫描、统计、整理和安全读写工具
+Author: Chen Mo
+Author-email: chenmoemail@126.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-python
+Dynamic: summary
+
+# cm_filekit
+
+《计算概论C》文件与目录任务工具库，适合文件读写和异常处理之后使用。
+
+```bash
+pip install cm_filekit
+```
+
+```python
+import cm_filekit
+
+print(cm_filekit.count_by_extension('.'))
+print(cm_filekit.find_large_files('.', min_mb=20))
+
+report = cm_filekit.make_file_report('.')
+print(report)
+
+moves = cm_filekit.organize_by_extension('.', dry_run=True)
+cm_filekit.write_csv('整理预览.csv', moves, header=['原文件', '新位置'])
+```
+
+这个库不替代 `open()`、循环和路径知识，而是把真实文件夹任务做得更容易上手。

cm_filekit-1.0.0/README.md

@@ -0,0 +1,22 @@
+# cm_filekit
+
+《计算概论C》文件与目录任务工具库，适合文件读写和异常处理之后使用。
+
+```bash
+pip install cm_filekit
+```
+
+```python
+import cm_filekit
+
+print(cm_filekit.count_by_extension('.'))
+print(cm_filekit.find_large_files('.', min_mb=20))
+
+report = cm_filekit.make_file_report('.')
+print(report)
+
+moves = cm_filekit.organize_by_extension('.', dry_run=True)
+cm_filekit.write_csv('整理预览.csv', moves, header=['原文件', '新位置'])
+```
+
+这个库不替代 `open()`、循环和路径知识，而是把真实文件夹任务做得更容易上手。

cm_filekit-1.0.0/cm_filekit/__init__.py

@@ -0,0 +1,28 @@
+"""cm_filekit - 文件夹扫描、统计、整理和安全读写工具。"""
+
+from .core import (
+    scan_files,
+    count_by_extension,
+    make_file_report,
+    find_empty_files,
+    find_large_files,
+    preview_rename,
+    organize_by_extension,
+    read_text_smart,
+    write_text,
+    write_csv,
+)
+
+__version__ = '1.0.0'
+__all__ = [
+    'scan_files',
+    'count_by_extension',
+    'make_file_report',
+    'find_empty_files',
+    'find_large_files',
+    'preview_rename',
+    'organize_by_extension',
+    'read_text_smart',
+    'write_text',
+    'write_csv',
+]

cm_filekit-1.0.0/cm_filekit/core.py

@@ -0,0 +1,97 @@
+import csv
+import shutil
+from collections import Counter
+from pathlib import Path
+
+
+def scan_files(folder, recursive=True):
+    """扫描文件夹，返回文件路径字符串列表。"""
+    root = Path(folder)
+    pattern = '**/*' if recursive else '*'
+    return [str(path) for path in root.glob(pattern) if path.is_file()]
+
+
+def count_by_extension(folder, recursive=True):
+    """统计文件夹中各类扩展名数量。"""
+    files = scan_files(folder, recursive=recursive)
+    counter = Counter(Path(file).suffix.lower() or '[无扩展名]' for file in files)
+    return dict(sorted(counter.items()))
+
+
+def make_file_report(folder, recursive=True):
+    """生成文件夹概览报告。"""
+    files = [Path(file) for file in scan_files(folder, recursive=recursive)]
+    total_size = sum(file.stat().st_size for file in files)
+    return {
+        'folder': str(Path(folder)),
+        'file_count': len(files),
+        'total_size_bytes': total_size,
+        'extensions': count_by_extension(folder, recursive=recursive),
+    }
+
+
+def find_empty_files(folder, recursive=True):
+    """查找大小为 0 的空文件。"""
+    return [file for file in scan_files(folder, recursive=recursive) if Path(file).stat().st_size == 0]
+
+
+def find_large_files(folder, min_mb=10, recursive=True):
+    """查找大于 min_mb MB 的文件。"""
+    limit = min_mb * 1024 * 1024
+    return [file for file in scan_files(folder, recursive=recursive) if Path(file).stat().st_size >= limit]
+
+
+def preview_rename(files, prefix='', start=1, width=2):
+    """预览批量重命名结果，不真正改名。"""
+    result = []
+    for index, file in enumerate(files, start=start):
+        path = Path(file)
+        new_name = f'{prefix}{index:0{width}d}{path.suffix}'
+        result.append((str(path), str(path.with_name(new_name))))
+    return result
+
+
+def organize_by_extension(folder, target_folder=None, recursive=False, dry_run=True):
+    """按扩展名整理文件。dry_run=True 时只预览，不移动文件。"""
+    root = Path(folder)
+    target = Path(target_folder) if target_folder else root / '整理结果'
+    moves = []
+    for file in [Path(p) for p in scan_files(root, recursive=recursive)]:
+        ext = file.suffix.lower().lstrip('.') or '无扩展名'
+        new_path = target / ext / file.name
+        moves.append((str(file), str(new_path)))
+        if not dry_run:
+            new_path.parent.mkdir(parents=True, exist_ok=True)
+            shutil.move(str(file), str(new_path))
+    return moves
+
+
+def read_text_smart(filename):
+    """尝试用常见编码读取文本，减少中文乱码。"""
+    path = Path(filename)
+    for encoding in ('utf-8', 'utf-8-sig', 'gbk', 'gb18030'):
+        try:
+            return path.read_text(encoding=encoding)
+        except UnicodeDecodeError:
+            continue
+    return path.read_text(encoding='utf-8', errors='ignore')
+
+
+def write_text(filename, text):
+    """用 UTF-8 写入文本，自动创建父目录。"""
+    path = Path(filename)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(str(text), encoding='utf-8')
+    return str(path)
+
+
+def write_csv(filename, rows, header=None):
+    """写入 CSV 文件，适合 Excel 打开。"""
+    path = Path(filename)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    with path.open('w', encoding='utf-8-sig', newline='') as f:
+        writer = csv.writer(f)
+        if header:
+            writer.writerow(header)
+        writer.writerows(rows)
+    return str(path)

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

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: cm_filekit
+Version: 1.0.0
+Summary: 计算概论C课程文件夹扫描、统计、整理和安全读写工具
+Author: Chen Mo
+Author-email: chenmoemail@126.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Intended Audience :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-python
+Dynamic: summary
+
+# cm_filekit
+
+《计算概论C》文件与目录任务工具库，适合文件读写和异常处理之后使用。
+
+```bash
+pip install cm_filekit
+```
+
+```python
+import cm_filekit
+
+print(cm_filekit.count_by_extension('.'))
+print(cm_filekit.find_large_files('.', min_mb=20))
+
+report = cm_filekit.make_file_report('.')
+print(report)
+
+moves = cm_filekit.organize_by_extension('.', dry_run=True)
+cm_filekit.write_csv('整理预览.csv', moves, header=['原文件', '新位置'])
+```
+
+这个库不替代 `open()`、循环和路径知识，而是把真实文件夹任务做得更容易上手。

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

@@ -0,0 +1,8 @@
+README.md
+setup.py
+cm_filekit/__init__.py
+cm_filekit/core.py
+cm_filekit.egg-info/PKG-INFO
+cm_filekit.egg-info/SOURCES.txt
+cm_filekit.egg-info/dependency_links.txt
+cm_filekit.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+cm_filekit

cm_filekit-1.0.0/setup.cfg

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

cm_filekit-1.0.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='cm_filekit',
+    version='1.0.0',
+    author='Chen Mo',
+    author_email='chenmoemail@126.com',
+    description='计算概论C课程文件夹扫描、统计、整理和安全读写工具',
+    long_description=open('README.md', encoding='utf-8').read(),
+    long_description_content_type='text/markdown',
+    packages=find_packages(),
+    python_requires='>=3.8',
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Natural Language :: Chinese (Simplified)',
+        'Intended Audience :: Education',
+    ],
+)