filekits 0.1.0__tar.gz

filekits-0.1.0/LICENSE

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

filekits-0.1.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.1
+Name: filekits
+Version: 0.1.0
+Summary: Filekits for Python.
+Home-page: https://github.com/tinycen/filekits
+Author: tinycen
+Author-email: sky_ruocen@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# FileKits - Python文件处理工具包
+
+一个简洁高效的Python文件处理工具包，提供了文件读写、网络下载、文件夹操作等常用功能，让文件处理变得更加简单。
+
+## 🚀 功能特性
+
+- **文件读写**：支持txt、json、yaml、excel等多种格式的文件读写
+- **网络下载**：支持单文件和多文件下载，自动重试机制
+- **文件夹操作**：文件查找、文件夹清理等实用功能
+- **数据处理**：字典工具、pandas数据处理辅助功能
+
+## 📁 项目结构
+
+```
+filekits/
+├── __init__.py
+├── base_io/                 # 基础IO操作模块
+│   ├── __init__.py
+│   ├── load.py             # 文件读取功能
+│   ├── save.py             # 文件保存功能
+│   ├── folder.py           # 文件夹操作
+│   └── down_load.py        # 网络文件下载
+└── utils/                   # 工具模块
+    ├── __init__.py
+    ├── dict_util.py        # 字典处理工具
+    └── pd_util.py          # pandas数据处理工具
+```
+
+## 📦 安装/更新/卸载
+
+```bash
+pip install filekits
+```
+
+```bash
+pip install --upgrade filekits
+```
+
+```bash
+pip uninstall filekits
+```
+
+## 🛠️ 使用方法
+
+### 1. 文件读取
+
+#### 读取文本文件
+```python
+from filekits.base_io.load import load_txt
+
+# 读取txt文件为列表
+text_list = load_txt('example.txt')
+
+# 读取为字符串
+text_str = load_txt('example.txt', return_type="str")
+
+# 转换为小写列表
+lower_list = load_txt('example.txt', lower_list=1)
+```
+
+#### 读取JSON文件
+```python
+from filekits.base_io.load import load_json
+
+data = load_json('data.json')
+```
+
+#### 读取YAML文件
+```python
+from filekits.base_io.load import load_yaml
+
+config = load_yaml('config.yaml')
+```
+
+#### 读取Excel文件
+```python
+from filekits.base_io.load import load_excel
+
+# 读取为pandas DataFrame
+df = load_excel('data.xlsx', return_type="df")
+
+# 读取为openpyxl工作表
+wb, sheet, rows = load_excel('data.xlsx', return_type="sheet")
+```
+
+### 2. 文件保存
+
+#### 保存DataFrame
+```python
+from filekits.base_io.save import save_df
+import pandas as pd
+
+df = pd.DataFrame({'name': ['Alice', 'Bob'], 'age': [25, 30]})
+
+# 保存为Excel
+save_df(df, 'output.xlsx')
+
+# 保存为CSV
+save_df(df, 'output.csv')
+
+# 保存为JSON
+save_df(df, 'output.json')
+```
+
+#### 保存JSON文件
+```python
+from filekits.base_io.save import save_json
+
+data = {"name": "Alice", "age": 25}
+save_json(data, 'data.json')
+```
+
+#### 保存文本文件
+```python
+from filekits.base_io.save import save_txt
+
+my_list = ['line1', 'line2', 'line3']
+save_txt(my_list, 'output.txt')
+```
+
+### 3. 文件夹操作
+
+#### 查找文件
+```python
+from filekits.base_io.folder import find_files
+
+# 查找所有jpg文件
+jpg_files = find_files('/path/to/folder', '.jpg')
+
+# 查找包含特定名称的文件
+specific_files = find_files('/path/to/folder', '.txt', 'log')
+```
+
+#### 清空文件夹
+```python
+from filekits.base_io.folder import clear_folder
+
+# 清空并重新创建文件夹
+clear_folder('/path/to/clean')
+```
+
+### 4. 网络文件下载
+
+#### 单文件下载
+```python
+from filekits.base_io.down_load import download_file
+
+# 下载文件
+file_path = download_file('https://example.com/file.jpg', './downloads')
+
+# 自定义文件名
+file_path = download_file('https://example.com/file.jpg', './downloads', 'myfile.jpg')
+
+# 返回完整信息
+file_path, file_name = download_file('https://example.com/file.jpg', './downloads', return_type="both")
+```
+
+#### 批量下载
+```python
+from filekits.base_io.down_load import download_files
+
+urls = [
+    'https://example.com/image1.jpg',
+    'https://example.com/image2.jpg'
+]
+
+# 批量下载图片
+file_paths = download_files(urls, './images')
+
+# 只下载特定类型文件
+file_paths = download_files(urls, './downloads', extensions=['.jpg', '.png'])
+
+# 返回字典格式（包含URL信息）
+file_dicts = download_files(urls, './downloads', return_type="dict")
+```
+
+### 5. 工具函数
+
+#### 字典操作
+```python
+from filekits.utils.dict_util import remove_keys
+
+data = {"name": "Alice", "age": 25, "password": "secret"}
+clean_data = remove_keys(data, ["password"])
+# 结果: {"name": "Alice", "age": 25}
+```
+
+## ⚙️ 配置说明
+
+### 网络下载配置
+- 自动重试机制：使用`funcguard.tools.send_request`实现自动重试
+- User-Agent：内置浏览器User-Agent，避免被服务器拒绝
+- 特殊网站处理：针对阿里CDN等特定网站有优化处理
+
+### 文件格式支持
+- **文本文件**：.txt
+- **数据文件**：.json, .yaml, .yml
+- **表格文件**：.xlsx, .csv
+- **图片文件**：.jpg, .png, .gif, .bmp等（通过下载功能）
+
+## 📝 注意事项
+
+1. **编码问题**：所有文本操作默认使用UTF-8编码
+2. **文件存在检查**：下载文件时会自动检查文件是否已存在，避免重复下载
+3. **错误处理**：批量下载时支持失败跳过或抛出异常两种模式
+4. **路径处理**：使用绝对路径或相对路径均可，程序会自动处理
+
+## 📄 许可证
+
+MIT License - 详见LICENSE文件

filekits-0.1.0/README.md

@@ -0,0 +1,210 @@
+# FileKits - Python文件处理工具包
+
+一个简洁高效的Python文件处理工具包，提供了文件读写、网络下载、文件夹操作等常用功能，让文件处理变得更加简单。
+
+## 🚀 功能特性
+
+- **文件读写**：支持txt、json、yaml、excel等多种格式的文件读写
+- **网络下载**：支持单文件和多文件下载，自动重试机制
+- **文件夹操作**：文件查找、文件夹清理等实用功能
+- **数据处理**：字典工具、pandas数据处理辅助功能
+
+## 📁 项目结构
+
+```
+filekits/
+├── __init__.py
+├── base_io/                 # 基础IO操作模块
+│   ├── __init__.py
+│   ├── load.py             # 文件读取功能
+│   ├── save.py             # 文件保存功能
+│   ├── folder.py           # 文件夹操作
+│   └── down_load.py        # 网络文件下载
+└── utils/                   # 工具模块
+    ├── __init__.py
+    ├── dict_util.py        # 字典处理工具
+    └── pd_util.py          # pandas数据处理工具
+```
+
+## 📦 安装/更新/卸载
+
+```bash
+pip install filekits
+```
+
+```bash
+pip install --upgrade filekits
+```
+
+```bash
+pip uninstall filekits
+```
+
+## 🛠️ 使用方法
+
+### 1. 文件读取
+
+#### 读取文本文件
+```python
+from filekits.base_io.load import load_txt
+
+# 读取txt文件为列表
+text_list = load_txt('example.txt')
+
+# 读取为字符串
+text_str = load_txt('example.txt', return_type="str")
+
+# 转换为小写列表
+lower_list = load_txt('example.txt', lower_list=1)
+```
+
+#### 读取JSON文件
+```python
+from filekits.base_io.load import load_json
+
+data = load_json('data.json')
+```
+
+#### 读取YAML文件
+```python
+from filekits.base_io.load import load_yaml
+
+config = load_yaml('config.yaml')
+```
+
+#### 读取Excel文件
+```python
+from filekits.base_io.load import load_excel
+
+# 读取为pandas DataFrame
+df = load_excel('data.xlsx', return_type="df")
+
+# 读取为openpyxl工作表
+wb, sheet, rows = load_excel('data.xlsx', return_type="sheet")
+```
+
+### 2. 文件保存
+
+#### 保存DataFrame
+```python
+from filekits.base_io.save import save_df
+import pandas as pd
+
+df = pd.DataFrame({'name': ['Alice', 'Bob'], 'age': [25, 30]})
+
+# 保存为Excel
+save_df(df, 'output.xlsx')
+
+# 保存为CSV
+save_df(df, 'output.csv')
+
+# 保存为JSON
+save_df(df, 'output.json')
+```
+
+#### 保存JSON文件
+```python
+from filekits.base_io.save import save_json
+
+data = {"name": "Alice", "age": 25}
+save_json(data, 'data.json')
+```
+
+#### 保存文本文件
+```python
+from filekits.base_io.save import save_txt
+
+my_list = ['line1', 'line2', 'line3']
+save_txt(my_list, 'output.txt')
+```
+
+### 3. 文件夹操作
+
+#### 查找文件
+```python
+from filekits.base_io.folder import find_files
+
+# 查找所有jpg文件
+jpg_files = find_files('/path/to/folder', '.jpg')
+
+# 查找包含特定名称的文件
+specific_files = find_files('/path/to/folder', '.txt', 'log')
+```
+
+#### 清空文件夹
+```python
+from filekits.base_io.folder import clear_folder
+
+# 清空并重新创建文件夹
+clear_folder('/path/to/clean')
+```
+
+### 4. 网络文件下载
+
+#### 单文件下载
+```python
+from filekits.base_io.down_load import download_file
+
+# 下载文件
+file_path = download_file('https://example.com/file.jpg', './downloads')
+
+# 自定义文件名
+file_path = download_file('https://example.com/file.jpg', './downloads', 'myfile.jpg')
+
+# 返回完整信息
+file_path, file_name = download_file('https://example.com/file.jpg', './downloads', return_type="both")
+```
+
+#### 批量下载
+```python
+from filekits.base_io.down_load import download_files
+
+urls = [
+    'https://example.com/image1.jpg',
+    'https://example.com/image2.jpg'
+]
+
+# 批量下载图片
+file_paths = download_files(urls, './images')
+
+# 只下载特定类型文件
+file_paths = download_files(urls, './downloads', extensions=['.jpg', '.png'])
+
+# 返回字典格式（包含URL信息）
+file_dicts = download_files(urls, './downloads', return_type="dict")
+```
+
+### 5. 工具函数
+
+#### 字典操作
+```python
+from filekits.utils.dict_util import remove_keys
+
+data = {"name": "Alice", "age": 25, "password": "secret"}
+clean_data = remove_keys(data, ["password"])
+# 结果: {"name": "Alice", "age": 25}
+```
+
+## ⚙️ 配置说明
+
+### 网络下载配置
+- 自动重试机制：使用`funcguard.tools.send_request`实现自动重试
+- User-Agent：内置浏览器User-Agent，避免被服务器拒绝
+- 特殊网站处理：针对阿里CDN等特定网站有优化处理
+
+### 文件格式支持
+- **文本文件**：.txt
+- **数据文件**：.json, .yaml, .yml
+- **表格文件**：.xlsx, .csv
+- **图片文件**：.jpg, .png, .gif, .bmp等（通过下载功能）
+
+## 📝 注意事项
+
+1. **编码问题**：所有文本操作默认使用UTF-8编码
+2. **文件存在检查**：下载文件时会自动检查文件是否已存在，避免重复下载
+3. **错误处理**：批量下载时支持失败跳过或抛出异常两种模式
+4. **路径处理**：使用绝对路径或相对路径均可，程序会自动处理
+
+## 📄 许可证
+
+MIT License - 详见LICENSE文件

filekits-0.1.0/filekits/base_io/down_load.py

@@ -0,0 +1,148 @@
+import os
+from funcguard.tools import send_request
+
+
+# 下载网络文件
+def download_file(url, download_dir, file_name="", return_type="name"):
+    """
+    使用 send_request 自动重试功能下载网络文件
+    
+    Args:
+        url: 文件URL
+        download_dir: 下载目录
+        file_name: 自定义文件名（可选，如果不提供则从URL提取）
+        return_type: 返回类型，可选值：
+            - "name": 仅返回文件名（默认）
+            - "path": 仅返回完整路径
+            - "both": 返回(路径, 文件名)元组
+    
+    Returns:
+        根据return_type参数返回：
+            - "name": 文件名
+            - "path": 完整路径
+            - "both": (路径, 文件名)元组
+        示例用法：
+            file_path, file_name = download_file(url, download_dir, return_type="both")
+    """
+    # 生成文件名
+    if file_name == "":
+        file_name = url.split("/")[-1]
+    else:
+        # 如果提供了自定义文件名但没有扩展名，从URL获取扩展名
+        if '.' not in file_name:
+            file_extension = url.split(".")[-1] if '.' in url.split("/")[-1] else ""
+            if file_extension:
+                file_name = f"{file_name}.{file_extension}"
+
+    file_path = os.path.join(download_dir, file_name)
+
+    # 检查文件是否已经存在
+    if os.path.exists(file_path):
+        print(f"文件 {file_name} 已经存在，跳过下载")
+    else:
+        # 设置请求头
+        headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
+        }
+        
+        # 使用 send_request 自动重试下载
+        try:
+            # 为阿里cdn添加特殊处理
+            if "https://cbu01.alicdn.com" in url:
+                response = send_request( method='GET', url=url, headers=headers, stream=True )
+            else:
+                response = send_request( method='GET', url=url, stream=True )
+            
+            # 以二进制模式写入文件
+            with open(file_path, 'wb') as file:
+                for chunk in response.iter_content(1024):
+                    if chunk:  # 过滤掉空chunk
+                        file.write(chunk)
+                        
+        except Exception as e:
+            print(f"文件下载失败, url： {url} \n Reason：{e}")
+            raise e  # 重新抛出异常，让调用者处理
+
+    if return_type == "name":
+        return file_name
+    elif return_type == "path":
+        return file_path
+    elif return_type == "both":
+        return file_path, file_name
+    else:
+        raise ValueError("return_type 参数错误，请传入 'name'、'path' 或 'both'")
+
+
+# 批量下载文件(单线程)，默认下载图片
+def download_files(files, output_folder, return_type="list", extensions=None, on_fail_action="skip"):
+    """
+    批量下载文件
+    
+    Args:
+        files: 文件URL列表
+        output_folder: 下载目录
+        return_type: 返回类型，"list"或"dict"
+        extensions: 允许的文件扩展名列表，None表示允许所有类型
+        on_fail_action: 失败次数过多时的行为，可选值：
+            - "skip": 跳过并结束整个循环（默认）
+            - "raise": 抛出异常，报出错误
+    
+    Returns:
+        根据return_type参数返回文件路径列表或字典列表
+        
+    Raises:
+        RuntimeError: 当on_fail_action="raise"且下载失败次数过多时抛出
+    """
+    if extensions is None:
+        extensions = []
+
+    files_path = []
+    i = 0  # 将i移到循环外部
+    download_fail_count = 0  # 将失败计数器也移到外部，按整个批次计算
+    failed_urls = []  # 记录失败的URL
+    
+    for url in files:
+        # 提取文件扩展名
+        ext = os.path.splitext(url)[1]
+
+        # 判断是否允许该扩展名
+        if extensions and ext.lower() not in extensions:
+            print(f"跳过不支持的文件类型: {url}")
+            continue
+
+        # 替换文件类型后缀，避免后面重复拼接形成.jpg.jpg的情况
+        file_name = url.split("/")[-1].replace(ext, "")
+
+        # 如果文件名太短，加前缀防止重命名冲突
+        if len(file_name) < 7:
+            file_name = f"{i}_{file_name}"
+            i += 1
+
+        try:
+            file_path = download_file(url, output_folder, file_name, return_type="path")
+        except Exception as e:
+            print(f"文件下载失败，已跳过：{url}")
+            download_fail_count += 1
+            failed_urls.append(url)
+            
+            if download_fail_count > 3:
+                error_msg = f"文件下载失败次数过多，已失败 {download_fail_count} 个文件。失败的URL: {failed_urls}"
+                
+                if on_fail_action == "raise":
+                    raise RuntimeError(error_msg)
+                elif on_fail_action == "skip":
+                    print(error_msg + "，已跳过剩余文件")
+                    break  # 终止整个循环
+                else:
+                    raise ValueError("on_fail_action 参数错误，请传入 'skip' 或 'raise'")
+            
+            continue
+
+        if return_type == "list":
+            files_path.append(file_path)
+        elif return_type == "dict":
+            files_path.append({"path": file_path, "url": url})
+        else:
+            raise ValueError("return_type 参数错误，请传入 'list' 或 'dict'")
+
+    return files_path

filekits-0.1.0/filekits/base_io/folder.py

@@ -0,0 +1,26 @@
+import os
+import shutil
+
+# 遍历文件夹地址，返回指定类型或包含指定名称的文件列表
+def find_files( folder_path , extension , filename_match = "" ) :
+    file_list = [ ]
+    # 遍历目录
+    for root , dirs , files in os.walk( folder_path ) :
+        # 遍历文件，检查文件扩展名
+        for filename in files :
+            if filename.endswith( extension ) :
+                if filename_match == "" :
+                    file_list.append( os.path.join( root , filename ) )
+                else :
+                    if filename_match in filename :
+                        file_list.append( os.path.join( root , filename ) )
+    return file_list
+
+
+# 清空指定文件夹
+def clear_folder( folder_path ) :
+    # 检测文件夹是否存在，如果不存在就创建
+    if not os.path.exists( folder_path ) :
+        os.makedirs( folder_path )
+    shutil.rmtree( folder_path )
+    os.mkdir( folder_path )

filekits-0.1.0/filekits/base_io/load.py

@@ -0,0 +1,67 @@
+import json
+import yaml
+import base64
+import openpyxl
+import pandas as pd
+
+# 读取txt文档，返回列表
+def load_txt(file_path, lower_list=0, return_type="list"):
+    f = open(file_path, "r", encoding='utf-8')
+    text = f.read()
+    f.close()
+    if return_type == "str":
+        return text
+    else:
+        my_list = text.split("\n")
+        if lower_list == 1:  # 转换为小写
+            new_list = [word.lower() for word in my_list]
+            return new_list
+        else:
+            return my_list
+
+
+# 读取yaml文件
+def load_yaml(file_path):
+    with open(file_path, 'r', encoding='utf-8') as f:
+        data = yaml.safe_load(f)
+    return data
+
+
+# 读取Excel文件，返回pandas.DataFrame 或者 sheet
+def load_excel(file_path, return_type, sheet_name=None, skiprows=0, header=0):
+    '''
+    for i in range (2 , num+1) :  # 第1行是 标题，所以从第2行开始
+        sku = sheet.cell (i , 2).value
+    '''
+    if return_type == "sheet":
+        wb = openpyxl.load_workbook(file_path)
+        sheet = wb.active
+        if sheet is not None:
+            num = sheet.max_row
+        else:
+            num = 0
+        print("共有行：{}".format(num))
+        return wb, sheet, num
+    elif return_type == "df":
+        if sheet_name is None:
+            sheet_name = 0
+        df = pd.read_excel(file_path, sheet_name=sheet_name, header=header,
+                            skiprows=skiprows if skiprows != 0 else None)
+        return df
+    else:
+        raise ValueError("return_type参数错误！")
+
+
+# 读取json文件，返回字典
+def load_json(file_path):
+    with open(file_path, 'r', encoding='utf-8') as f:
+        data = json.load(f)
+    return data
+
+
+# 读取任意文件转为 base64 编码
+def load_base64(file_path):
+    with open(file_path, "rb") as file:
+        file_data = file.read()
+    base64_data = base64.b64encode(file_data).decode('utf-8')
+    return base64_data

filekits-0.1.0/filekits/base_io/save.py

@@ -0,0 +1,31 @@
+import json
+import pandas as pd
+
+# 将列表转为df并保存为指定格式的文件
+def save_df( merged_list , output_path ) :
+    df = pd.DataFrame( merged_list )
+    if ".xlsx" in output_path :
+        df.to_excel( output_path , index = False )
+    elif ".csv" in output_path :
+        df.to_csv( output_path , index = False )
+    elif ".json" in output_path :
+        df.to_json( output_path , orient = 'records' , force_ascii = False , indent = 4 )
+    else :
+        raise ValueError( "请输入正确的文件名后缀，支持 .xlsx、.csv 和 .json " )
+    return
+
+# 字典保存为json文件
+def save_json( data_dict, output_file = 'output.json' ) :
+    # 将字典转换为JSON格式字符串
+    json_str = json.dumps( data_dict, ensure_ascii = False, indent = 4 )
+    # 打开文件，以写入模式打开
+    with open( output_file, 'w', encoding = 'utf-8' ) as f :
+        # 将JSON字符串写入文件
+        f.write( json_str )
+
+
+# 列表保存为txt文件
+def save_txt( merged_list , output_file = 'output.txt' ) :
+    with open( output_file , 'w' , encoding = 'utf-8' ) as f :
+        for item in merged_list :
+            f.write( str( item ) + '\n' )

filekits-0.1.0/filekits/utils/dict_util.py

@@ -0,0 +1,15 @@
+# 从字典中移除指定的键
+def remove_keys(data: dict, keys_to_remove: list) -> dict:
+    """从字典中移除指定的键列表
+    
+    Args:
+        data: 要处理的字典
+        keys_to_remove: 需要移除的键列表
+        
+    Returns:
+        处理后的字典
+    """
+    for key in keys_to_remove:
+        if key in data:
+            del data[key]
+    return data

filekits-0.1.0/filekits.egg-info/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.1
+Name: filekits
+Version: 0.1.0
+Summary: Filekits for Python.
+Home-page: https://github.com/tinycen/filekits
+Author: tinycen
+Author-email: sky_ruocen@qq.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# FileKits - Python文件处理工具包
+
+一个简洁高效的Python文件处理工具包，提供了文件读写、网络下载、文件夹操作等常用功能，让文件处理变得更加简单。
+
+## 🚀 功能特性
+
+- **文件读写**：支持txt、json、yaml、excel等多种格式的文件读写
+- **网络下载**：支持单文件和多文件下载，自动重试机制
+- **文件夹操作**：文件查找、文件夹清理等实用功能
+- **数据处理**：字典工具、pandas数据处理辅助功能
+
+## 📁 项目结构
+
+```
+filekits/
+├── __init__.py
+├── base_io/                 # 基础IO操作模块
+│   ├── __init__.py
+│   ├── load.py             # 文件读取功能
+│   ├── save.py             # 文件保存功能
+│   ├── folder.py           # 文件夹操作
+│   └── down_load.py        # 网络文件下载
+└── utils/                   # 工具模块
+    ├── __init__.py
+    ├── dict_util.py        # 字典处理工具
+    └── pd_util.py          # pandas数据处理工具
+```
+
+## 📦 安装/更新/卸载
+
+```bash
+pip install filekits
+```
+
+```bash
+pip install --upgrade filekits
+```
+
+```bash
+pip uninstall filekits
+```
+
+## 🛠️ 使用方法
+
+### 1. 文件读取
+
+#### 读取文本文件
+```python
+from filekits.base_io.load import load_txt
+
+# 读取txt文件为列表
+text_list = load_txt('example.txt')
+
+# 读取为字符串
+text_str = load_txt('example.txt', return_type="str")
+
+# 转换为小写列表
+lower_list = load_txt('example.txt', lower_list=1)
+```
+
+#### 读取JSON文件
+```python
+from filekits.base_io.load import load_json
+
+data = load_json('data.json')
+```
+
+#### 读取YAML文件
+```python
+from filekits.base_io.load import load_yaml
+
+config = load_yaml('config.yaml')
+```
+
+#### 读取Excel文件
+```python
+from filekits.base_io.load import load_excel
+
+# 读取为pandas DataFrame
+df = load_excel('data.xlsx', return_type="df")
+
+# 读取为openpyxl工作表
+wb, sheet, rows = load_excel('data.xlsx', return_type="sheet")
+```
+
+### 2. 文件保存
+
+#### 保存DataFrame
+```python
+from filekits.base_io.save import save_df
+import pandas as pd
+
+df = pd.DataFrame({'name': ['Alice', 'Bob'], 'age': [25, 30]})
+
+# 保存为Excel
+save_df(df, 'output.xlsx')
+
+# 保存为CSV
+save_df(df, 'output.csv')
+
+# 保存为JSON
+save_df(df, 'output.json')
+```
+
+#### 保存JSON文件
+```python
+from filekits.base_io.save import save_json
+
+data = {"name": "Alice", "age": 25}
+save_json(data, 'data.json')
+```
+
+#### 保存文本文件
+```python
+from filekits.base_io.save import save_txt
+
+my_list = ['line1', 'line2', 'line3']
+save_txt(my_list, 'output.txt')
+```
+
+### 3. 文件夹操作
+
+#### 查找文件
+```python
+from filekits.base_io.folder import find_files
+
+# 查找所有jpg文件
+jpg_files = find_files('/path/to/folder', '.jpg')
+
+# 查找包含特定名称的文件
+specific_files = find_files('/path/to/folder', '.txt', 'log')
+```
+
+#### 清空文件夹
+```python
+from filekits.base_io.folder import clear_folder
+
+# 清空并重新创建文件夹
+clear_folder('/path/to/clean')
+```
+
+### 4. 网络文件下载
+
+#### 单文件下载
+```python
+from filekits.base_io.down_load import download_file
+
+# 下载文件
+file_path = download_file('https://example.com/file.jpg', './downloads')
+
+# 自定义文件名
+file_path = download_file('https://example.com/file.jpg', './downloads', 'myfile.jpg')
+
+# 返回完整信息
+file_path, file_name = download_file('https://example.com/file.jpg', './downloads', return_type="both")
+```
+
+#### 批量下载
+```python
+from filekits.base_io.down_load import download_files
+
+urls = [
+    'https://example.com/image1.jpg',
+    'https://example.com/image2.jpg'
+]
+
+# 批量下载图片
+file_paths = download_files(urls, './images')
+
+# 只下载特定类型文件
+file_paths = download_files(urls, './downloads', extensions=['.jpg', '.png'])
+
+# 返回字典格式（包含URL信息）
+file_dicts = download_files(urls, './downloads', return_type="dict")
+```
+
+### 5. 工具函数
+
+#### 字典操作
+```python
+from filekits.utils.dict_util import remove_keys
+
+data = {"name": "Alice", "age": 25, "password": "secret"}
+clean_data = remove_keys(data, ["password"])
+# 结果: {"name": "Alice", "age": 25}
+```
+
+## ⚙️ 配置说明
+
+### 网络下载配置
+- 自动重试机制：使用`funcguard.tools.send_request`实现自动重试
+- User-Agent：内置浏览器User-Agent，避免被服务器拒绝
+- 特殊网站处理：针对阿里CDN等特定网站有优化处理
+
+### 文件格式支持
+- **文本文件**：.txt
+- **数据文件**：.json, .yaml, .yml
+- **表格文件**：.xlsx, .csv
+- **图片文件**：.jpg, .png, .gif, .bmp等（通过下载功能）
+
+## 📝 注意事项
+
+1. **编码问题**：所有文本操作默认使用UTF-8编码
+2. **文件存在检查**：下载文件时会自动检查文件是否已存在，避免重复下载
+3. **错误处理**：批量下载时支持失败跳过或抛出异常两种模式
+4. **路径处理**：使用绝对路径或相对路径均可，程序会自动处理
+
+## 📄 许可证
+
+MIT License - 详见LICENSE文件

filekits-0.1.0/filekits.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+setup.py
+filekits/__init__.py
+filekits.egg-info/PKG-INFO
+filekits.egg-info/SOURCES.txt
+filekits.egg-info/dependency_links.txt
+filekits.egg-info/not-zip-safe
+filekits.egg-info/requires.txt
+filekits.egg-info/top_level.txt
+filekits/base_io/__init__.py
+filekits/base_io/down_load.py
+filekits/base_io/folder.py
+filekits/base_io/load.py
+filekits/base_io/save.py
+filekits/utils/__init__.py
+filekits/utils/dict_util.py
+filekits/utils/pd_util.py

filekits-0.1.0/filekits.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

filekits-0.1.0/filekits.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

filekits-0.1.0/filekits.egg-info/requires.txt

@@ -0,0 +1,4 @@
+pandas
+openpyxl
+pyyaml
+funcguard

filekits-0.1.0/filekits.egg-info/top_level.txt

@@ -0,0 +1 @@
+filekits

filekits-0.1.0/setup.cfg

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

filekits-0.1.0/setup.py

@@ -0,0 +1,34 @@
+from setuptools import setup, find_packages
+
+# 读取README文件
+try:
+    with open('README.md', 'r', encoding='utf-8') as f:
+        long_description = f.read()
+except FileNotFoundError:
+    long_description = 'Filekits for Python.'
+
+setup(  
+    name='filekits',
+    version='0.1.0',
+    packages=find_packages(),
+    install_requires=[
+        'pandas',
+        'openpyxl',
+        'pyyaml',
+        'funcguard',
+    ],
+    author='tinycen',
+    author_email='sky_ruocen@qq.com',
+    description='Filekits for Python.',
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    url='https://github.com/tinycen/filekits',
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+    ],
+    python_requires='>=3.10',
+    include_package_data=True,
+    zip_safe=False,
+)