vaultex 0.1.0__tar.gz

vaultex-0.1.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: vaultex
+Version: 0.1.0
+Summary: Extract and merge files from a folder with precision — a lightweight GUI tool for developers and LLM workflows.
+Author-email: Ian Gong <gongzhijie535@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/gongzhijie535-ctrl/vaultex
+Project-URL: Repository, https://github.com/gongzhijie535-ctrl/vaultex
+Project-URL: Issues, https://github.com/gongzhijie535-ctrl/vaultex
+Keywords: file,extract,merge,llm,gradio,code,tools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: gradio>=4.0
+
+# 🔐 Vaultex
+
+> Extract what you need. Nothing more.
+
+Vaultex is a lightweight GUI tool that lets you **scan a folder and merge all matching files into a single text output** — ready to paste into an LLM, a doc, or anywhere you need a full-project snapshot.
+
+The idea is simple: when you're working with a codebase or a collection of files, you often need to quickly gather *specific types* of files across nested folders. Vaultex gives you precise control over what gets included, what gets skipped, and how the result is organized — all through a clean interface.
+
+---
+
+## ✨ Features
+
+- 📂 **Folder picker** — browse or paste a path directly
+- 📄 **File type selector** — pick from common extensions or add your own
+- 🎯 **Whitelist / blacklist filtering** — specify exactly which folders and files to include or exclude
+- 📦 **File size limit** — skip files that are too large
+- 🔁 **Recursive or flat mode** — go deep or stay shallow
+- 🔃 **Sort options** — by path, filename, or last modified time
+- 🔍 **Preview before extracting** — scan first, extract when ready
+- 💾 **Save to file** — optionally write the merged output back to disk
+- 🤖 **Token estimator** — rough count to check if output fits your LLM context window
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install vaultex
+```
+
+Then launch:
+
+```bash
+vaultex
+```
+
+Or run directly from source:
+
+```bash
+git clone https://github.com/gongzhijie535-ctrl/vaultex
+cd vaultex
+pip install -e .
+python -m vaultex
+```
+
+---
+
+## 🖥️ Usage
+
+1. Select a folder using the **📂 picker** or paste a path
+2. Check the file types you want (`.py`, `.md`, `.json`, etc.)
+3. Expand **Filter Options** to narrow down by folder or filename
+4. Click **🔍 Preview** to confirm the file list
+5. Click **🚀 Extract** to merge and view the output
+
+---
+
+## 📁 Project Structure
+
+```
+vaultex/
+├── __init__.py
+├── __main__.py       # entry point: python -m vaultex
+├── core.py           # file collection + merging logic
+└── app.py            # Gradio UI
+```
+
+---
+
+## 📦 Requirements
+
+- Python ≥ 3.10
+- gradio
+
+---
+
+## 👤 Author
+
+**Ian Gong (龚智杰)**
+📧 gongzhijie535@gmail.com
+🐙 [@gongzhijie535-ctrl](https://github.com/gongzhijie535-ctrl)
+
+---
+
+## 📄 License
+
+MIT

vaultex-0.1.0/README.md

@@ -0,0 +1,87 @@
+# 🔐 Vaultex
+
+> Extract what you need. Nothing more.
+
+Vaultex is a lightweight GUI tool that lets you **scan a folder and merge all matching files into a single text output** — ready to paste into an LLM, a doc, or anywhere you need a full-project snapshot.
+
+The idea is simple: when you're working with a codebase or a collection of files, you often need to quickly gather *specific types* of files across nested folders. Vaultex gives you precise control over what gets included, what gets skipped, and how the result is organized — all through a clean interface.
+
+---
+
+## ✨ Features
+
+- 📂 **Folder picker** — browse or paste a path directly
+- 📄 **File type selector** — pick from common extensions or add your own
+- 🎯 **Whitelist / blacklist filtering** — specify exactly which folders and files to include or exclude
+- 📦 **File size limit** — skip files that are too large
+- 🔁 **Recursive or flat mode** — go deep or stay shallow
+- 🔃 **Sort options** — by path, filename, or last modified time
+- 🔍 **Preview before extracting** — scan first, extract when ready
+- 💾 **Save to file** — optionally write the merged output back to disk
+- 🤖 **Token estimator** — rough count to check if output fits your LLM context window
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install vaultex
+```
+
+Then launch:
+
+```bash
+vaultex
+```
+
+Or run directly from source:
+
+```bash
+git clone https://github.com/gongzhijie535-ctrl/vaultex
+cd vaultex
+pip install -e .
+python -m vaultex
+```
+
+---
+
+## 🖥️ Usage
+
+1. Select a folder using the **📂 picker** or paste a path
+2. Check the file types you want (`.py`, `.md`, `.json`, etc.)
+3. Expand **Filter Options** to narrow down by folder or filename
+4. Click **🔍 Preview** to confirm the file list
+5. Click **🚀 Extract** to merge and view the output
+
+---
+
+## 📁 Project Structure
+
+```
+vaultex/
+├── __init__.py
+├── __main__.py       # entry point: python -m vaultex
+├── core.py           # file collection + merging logic
+└── app.py            # Gradio UI
+```
+
+---
+
+## 📦 Requirements
+
+- Python ≥ 3.10
+- gradio
+
+---
+
+## 👤 Author
+
+**Ian Gong (龚智杰)**
+📧 gongzhijie535@gmail.com
+🐙 [@gongzhijie535-ctrl](https://github.com/gongzhijie535-ctrl)
+
+---
+
+## 📄 License
+
+MIT

vaultex-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vaultex"
+version = "0.1.0"
+description = "Extract and merge files from a folder with precision — a lightweight GUI tool for developers and LLM workflows."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Ian Gong", email = "gongzhijie535@gmail.com" }
+]
+keywords = ["file", "extract", "merge", "llm", "gradio", "code", "tools"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "gradio>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/gongzhijie535-ctrl/vaultex"
+Repository = "https://github.com/gongzhijie535-ctrl/vaultex"
+Issues = "https://github.com/gongzhijie535-ctrl/vaultex"
+
+[project.scripts]
+vaultex = "vaultex.app:launch"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["vaultex*"]

vaultex-0.1.0/setup.cfg

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

vaultex-0.1.0/setup.py

@@ -0,0 +1,3 @@
+from setuptools import setup
+
+setup()

vaultex-0.1.0/vaultex/__init__.py

@@ -0,0 +1,4 @@
+from vaultex.core import extract, DEFAULT_EXTENSIONS
+
+__version__ = "0.1.0"
+__all__ = ["extract", "DEFAULT_EXTENSIONS"]

vaultex-0.1.0/vaultex/__main__.py

@@ -0,0 +1,4 @@
+from vaultex.app import launch
+
+if __name__ == "__main__":
+    launch()

vaultex-0.1.0/vaultex/app.py

@@ -0,0 +1,343 @@
+import os
+import gradio as gr
+from vaultex.core import extract, DEFAULT_EXTENSIONS
+
+
+def pick_folder():
+    try:
+        import tkinter as tk
+        from tkinter import filedialog
+        root = tk.Tk()
+        root.withdraw()
+        root.wm_attributes("-topmost", True)
+        folder = filedialog.askdirectory(title="选择文件夹")
+        root.destroy()
+        return folder or ""
+    except Exception as e:
+        return f"⚠️ 无法打开选择窗口：{e}"
+
+
+def _merge_extensions(selected, custom_str):
+    exts = set(selected or [])
+    for line in custom_str.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        if not line.startswith("."):
+            line = "." + line
+        exts.add(line.lower())
+    return list(exts)
+
+
+def _parse_lines(raw: str) -> list:
+    return [s.strip() for s in raw.splitlines() if s.strip()]
+
+
+def _parse_keyword_files(raw: str) -> set:
+    return {s.strip().lower() for s in raw.splitlines() if s.strip()}
+
+
+def _build_common_args(folder_path, selected_extensions, custom_extensions_str,
+                       recursive, only_folders_str, skip_folders_str,
+                       keyword_files_str, skip_files_str, max_file_kb):
+    folder_path   = folder_path.strip()
+    extensions    = _merge_extensions(selected_extensions, custom_extensions_str)
+    only_folders  = _parse_lines(only_folders_str)
+    skip_folders  = _parse_lines(skip_folders_str)
+    keyword_files = _parse_keyword_files(keyword_files_str)
+    skip_files    = _parse_lines(skip_files_str)
+    max_kb        = int(max_file_kb) if str(max_file_kb).strip().isdigit() else 0
+    return folder_path, extensions, only_folders, skip_folders, keyword_files, skip_files, max_kb
+
+
+def run_scan(folder_path, selected_extensions, custom_extensions_str,
+             recursive, only_folders_str, skip_folders_str,
+             keyword_files_str, skip_files_str, max_file_kb):
+
+    folder_path, extensions, only_folders, skip_folders, keyword_files, skip_files, max_kb = _build_common_args(
+        folder_path, selected_extensions, custom_extensions_str,
+        recursive, only_folders_str, skip_folders_str,
+        keyword_files_str, skip_files_str, max_file_kb
+    )
+
+    if not folder_path:
+        return "⚠️ 请输入文件夹路径"
+    if not os.path.isdir(folder_path):
+        return "⚠️ 路径不存在或不是文件夹"
+    if not extensions:
+        return "⚠️ 请至少选择或填写一种文件类型"
+
+    from vaultex.core import _collect_files
+    file_list = _collect_files(
+        folder_path, extensions, recursive,
+        skip_folders, skip_files, only_folders, max_kb, keyword_files
+    )
+    file_list.sort()
+
+    if not file_list:
+        return "⚠️ 没有找到符合条件的文件"
+
+    lines = [f"🔍 扫描完成，共找到 {len(file_list)} 个文件：", ""]
+    for i, f in enumerate(file_list, 1):
+        rel  = os.path.relpath(f, folder_path)
+        size = os.path.getsize(f) / 1024
+        lines.append(f"  {i:>3}. {rel}  ({size:.1f} KB)")
+
+    return "\n".join(lines)
+
+
+def run_extract(folder_path, selected_extensions, custom_extensions_str,
+                recursive, separator, only_folders_str, skip_folders_str,
+                keyword_files_str, skip_files_str, max_file_kb,
+                sort_by, save_to_file, output_filename):
+
+    folder_path, extensions, only_folders, skip_folders, keyword_files, skip_files, max_kb = _build_common_args(
+        folder_path, selected_extensions, custom_extensions_str,
+        recursive, only_folders_str, skip_folders_str,
+        keyword_files_str, skip_files_str, max_file_kb
+    )
+
+    if not folder_path:
+        return "⚠️ 请输入文件夹路径", "未选择文件夹"
+    if not os.path.isdir(folder_path):
+        return "⚠️ 路径不存在或不是文件夹", "路径无效"
+    if not extensions:
+        return "⚠️ 请至少选择或填写一种文件类型", "未选择文件类型"
+
+    separator_str = separator.strip() if separator.strip() else "=" * 60
+
+    merged, file_list, stats = extract(
+        folder_path=folder_path,
+        extensions=extensions,
+        recursive=recursive,
+        separator=separator_str,
+        skip_folders=skip_folders,
+        skip_files=skip_files,
+        only_folders=only_folders,
+        max_file_kb=max_kb,
+        sort_by=sort_by,
+        keyword_files=keyword_files,
+    )
+
+    if not file_list:
+        return "⚠️ 没有找到符合条件的文件", "0 个文件"
+
+    saved_msg = ""
+    if save_to_file:
+        out_name = output_filename.strip() or "代码汇总.txt"
+        if not out_name.endswith(".txt"):
+            out_name += ".txt"
+        out_path = os.path.join(folder_path, out_name)
+        try:
+            with open(out_path, "w", encoding="utf-8") as f:
+                f.write(merged)
+            saved_msg = f"\n💾 已保存到：{out_path}"
+        except Exception as e:
+            saved_msg = f"\n⚠️ 保存失败：{e}"
+
+    summary_lines = [
+        f"✅ 共提取 {stats['file_count']} 个文件",
+        f"📊 总字符数：{stats['char_count']:,}",
+        f"🤖 估算 Token：{stats['token_est']:,}  （字符数 ÷ 4，英文准 / 中文偏低）",
+        "",
+        "📋 文件清单：",
+    ]
+    for f in file_list:
+        summary_lines.append(f"  • {os.path.relpath(f, folder_path)}")
+    if saved_msg:
+        summary_lines.append(saved_msg)
+
+    return merged, "\n".join(summary_lines)
+
+
+HELP_TEXT = """
+## 📖 用法说明
+
+**基本流程**
+1. 点击 `📂 选择` 按钮选择目标文件夹，或直接粘贴路径
+2. 勾选需要的文件类型（也可在下方自定义）
+3. 按需展开「过滤条件」和「输出设置」填写参数
+4. 点 `🔍 预览文件列表` 确认文件范围
+5. 确认无误后点 `🚀 开始提取`
+
+---
+
+**过滤功能说明**
+
+| 功能 | 说明 |
+|------|------|
+| ✅ 指定文件夹 | 只在这些文件夹里查找，每行一个，留空 = 不限制 |
+| ⛔ 跳过文件夹 | 排除这些文件夹，每行一个 |
+| ✅ 指定文件名 | 精确匹配完整文件名（含后缀），每行一个，留空 = 不限制 |
+| ⛔ 跳过文件名 | 排除这些文件，每行一个完整文件名（含后缀） |
+| 📦 文件大小上限 | 跳过超过指定 KB 的文件，0 = 不限制 |
+| 🔁 递归模式 | 勾选则进入所有子文件夹，取消则只读当前层 |
+
+---
+
+**Token 估算说明**
+
+- 纯英文代码：误差较小
+- 含中文注释：实际 Token 会更高
+
+主流模型上下文参考：GPT-4o ≈ 128K，Claude ≈ 200K，Gemini 1.5 Pro ≈ 1M
+""".strip()
+
+
+def launch():
+    with gr.Blocks(title="Vaultex") as demo:
+
+        gr.Markdown("# 🔐 Vaultex\n### 从文件夹中提取并合并文本文件内容")
+
+        with gr.Tabs():
+
+            # ── Tab 1：主界面 ────────────────────────────────────
+            with gr.Tab("🚀 提取"):
+                with gr.Row():
+
+                    # 左栏：配置
+                    with gr.Column(scale=1, min_width=340):
+
+                        # 路径
+                        with gr.Row():
+                            folder_input = gr.Textbox(
+                                label="📁 文件夹路径",
+                                placeholder="手动输入或点右侧按钮选择",
+                                lines=1,
+                                scale=5
+                            )
+                            pick_btn = gr.Button("📂 选择", scale=1, min_width=60)
+                        pick_btn.click(fn=pick_folder, inputs=[], outputs=[folder_input])
+
+                        # 文件类型
+                        with gr.Accordion("📄 文件类型", open=True):
+                            ext_selector = gr.CheckboxGroup(
+                                choices=DEFAULT_EXTENSIONS,
+                                value=[".txt", ".md", ".py", ".js", ".json"],
+                                label="勾选类型"
+                            )
+                            custom_ext_input = gr.Textbox(
+                                label="➕ 自定义类型（每行一个）",
+                                placeholder=".vue\n.svelte\n.lock",
+                                lines=2
+                            )
+
+                        # 过滤条件（默认折叠）
+                        with gr.Accordion("🔽 过滤条件", open=False):
+
+                            gr.Markdown("**📂 文件夹**")
+                            with gr.Row():
+                                only_folders_input = gr.Textbox(
+                                    label="✅ 指定文件夹（只看这些）",
+                                    placeholder="src\nlib\nutils",
+                                    lines=4
+                                )
+                                skip_folders_input = gr.Textbox(
+                                    label="⛔ 跳过文件夹（排除这些）",
+                                    placeholder="__pycache__\n.git\nnode_modules",
+                                    lines=4
+                                )
+
+                            gr.Markdown("**📄 文件**")
+                            with gr.Row():
+                                keyword_files_input = gr.Textbox(
+                                    label="✅ 指定文件名（只要这些，含后缀）",
+                                    placeholder="model.py\nconfig.json",
+                                    lines=4
+                                )
+                                skip_files_input = gr.Textbox(
+                                    label="⛔ 跳过文件名（排除这些，含后缀）",
+                                    placeholder="setup.py\nconfig.py",
+                                    lines=4
+                                )
+
+                            max_kb_input = gr.Number(
+                                label="📦 文件大小上限（KB，0 = 不限）",
+                                value=0,
+                                precision=0
+                            )
+
+                        # 输出设置（默认折叠）
+                        with gr.Accordion("💾 输出设置", open=False):
+                            with gr.Row():
+                                recursive_toggle = gr.Checkbox(
+                                    label="🔁 包含子文件夹",
+                                    value=True,
+                                    scale=1
+                                )
+                                sort_selector = gr.Radio(
+                                    choices=[("路径", "path"), ("文件名", "name"), ("修改时间", "mtime")],
+                                    value="path",
+                                    label="🔃 排序方式",
+                                    scale=2
+                                )
+                            separator_input = gr.Textbox(
+                                label="✂️ 文件分隔符",
+                                value="=" * 60,
+                                lines=1
+                            )
+                            save_toggle = gr.Checkbox(
+                                label="💾 同时保存到文件",
+                                value=False
+                            )
+                            output_filename_input = gr.Textbox(
+                                label="📄 输出文件名",
+                                value="代码汇总.txt",
+                                lines=1
+                            )
+
+                        # 按钮
+                        with gr.Row():
+                            scan_btn    = gr.Button("🔍 预览文件列表", variant="secondary", scale=1)
+                            extract_btn = gr.Button("🚀 开始提取",     variant="primary",   scale=1)
+
+                    # 右栏：输出
+                    with gr.Column(scale=2):
+                        scan_output = gr.Textbox(
+                            label="🔍 文件列表预览",
+                            lines=8,
+                            interactive=False
+                        )
+                        summary_output = gr.Textbox(
+                            label="📋 提取摘要",
+                            lines=8,
+                            interactive=False
+                        )
+                        result_output = gr.Textbox(
+                            label="📝 合并内容",
+                            lines=18,
+                            interactive=False
+                        )
+
+            # ── Tab 2：用法说明 ──────────────────────────────────
+            with gr.Tab("📖 用法说明"):
+                gr.Markdown(HELP_TEXT)
+
+        # 事件绑定
+        scan_btn.click(
+            fn=run_scan,
+            inputs=[
+                folder_input, ext_selector, custom_ext_input,
+                recursive_toggle, only_folders_input, skip_folders_input,
+                keyword_files_input, skip_files_input, max_kb_input
+            ],
+            outputs=[scan_output]
+        )
+
+        extract_btn.click(
+            fn=run_extract,
+            inputs=[
+                folder_input, ext_selector, custom_ext_input,
+                recursive_toggle, separator_input,
+                only_folders_input, skip_folders_input,
+                keyword_files_input, skip_files_input, max_kb_input,
+                sort_selector, save_toggle, output_filename_input
+            ],
+            outputs=[result_output, summary_output]
+        )
+
+    demo.launch(theme=gr.themes.Soft())
+
+
+if __name__ == "__main__":
+    launch()

vaultex-0.1.0/vaultex/core.py

@@ -0,0 +1,152 @@
+import os
+
+DEFAULT_EXTENSIONS = [
+    ".py", ".js", ".ts", ".jsx", ".tsx",
+    ".html", ".css", ".scss",
+    ".json", ".yaml", ".yml", ".toml", ".ini", ".env",
+    ".md", ".txt", ".rst", ".csv", ".xml",
+    ".sh", ".bat", ".ps1",
+    ".c", ".cpp", ".h", ".java", ".go", ".rs",
+]
+
+
+def extract(
+    folder_path: str,
+    extensions: list,
+    recursive: bool = True,
+    separator: str = "=" * 60,
+    skip_folders: list = None,
+    skip_files: list = None,
+    only_folders: list = None,
+    max_file_kb: int = 0,
+    sort_by: str = "path",
+    keyword_files: set = None,
+) -> tuple[str, list, dict]:
+
+    skip_folders  = skip_folders or []
+    skip_files    = skip_files or []
+    only_folders  = only_folders or []
+    keyword_files = keyword_files or set()
+
+    file_list = _collect_files(
+        folder_path, extensions, recursive,
+        skip_folders, skip_files, only_folders, max_file_kb, keyword_files
+    )
+
+    if sort_by == "name":
+        file_list.sort(key=lambda p: os.path.basename(p).lower())
+    elif sort_by == "mtime":
+        file_list.sort(key=lambda p: os.path.getmtime(p), reverse=True)
+    else:
+        file_list.sort()
+
+    if not file_list:
+        return "", [], {}
+
+    lines = []
+    total = len(file_list)
+
+    lines.append("📁 代码汇总报告")
+    lines.append(f"根目录：{folder_path}")
+    lines.append(f"共读取：{total} 个文件")
+    lines.append(separator)
+    lines.append("")
+
+    lines.append("📋 文件目录索引")
+    lines.append("-" * 40)
+    for i, filepath in enumerate(file_list, 1):
+        rel = os.path.relpath(filepath, folder_path)
+        size_kb = os.path.getsize(filepath) / 1024
+        lines.append(f"  {i:>3}. {rel}  ({size_kb:.1f} KB)")
+    lines.append("")
+    lines.append("")
+
+    for i, filepath in enumerate(file_list, 1):
+        rel = os.path.relpath(filepath, folder_path)
+        lines.append(separator)
+        lines.append(f"# 文件 {i}/{total}：{rel}")
+        lines.append(separator)
+        lines.append("")
+        content = _read_file(filepath)
+        lines.append(content)
+        lines.append("")
+        lines.append("")
+
+    merged = "\n".join(lines)
+
+    char_count = sum(len(_read_file(f)) for f in file_list)
+    stats = {
+        "file_count": total,
+        "char_count": char_count,
+        "token_est":  char_count // 4,
+    }
+
+    return merged, file_list, stats
+
+
+def _collect_files(folder, extensions, recursive, skip_folders, skip_files,
+                   only_folders, max_file_kb, keyword_files=None):
+    collected = []
+    keyword_files = keyword_files or set()
+
+    if recursive:
+        for root, dirs, files in os.walk(folder):
+            # 指定文件夹：当前层级的文件夹名必须在列表里
+            if only_folders:
+                dirs[:] = [
+                    d for d in dirs
+                    if d in only_folders and d not in skip_folders and not d.startswith(".")
+                ]
+            else:
+                dirs[:] = [
+                    d for d in dirs
+                    if d not in skip_folders and not d.startswith(".")
+                ]
+
+            # 指定文件夹时，根目录本身的文件也要判断是否在指定范围内
+            # 根目录直接收录，子目录只收录在 only_folders 里的
+            rel_root = os.path.relpath(root, folder)
+            if only_folders and rel_root != ".":
+                top_dir = rel_root.split(os.sep)[0]
+                if top_dir not in only_folders:
+                    continue
+
+            for file in files:
+                full_path = os.path.join(root, file)
+                if not _passes_filters(file, extensions, skip_files, max_file_kb, keyword_files, full_path):
+                    continue
+                collected.append(full_path)
+    else:
+        for item in os.listdir(folder):
+            full_path = os.path.join(folder, item)
+            if not os.path.isfile(full_path):
+                continue
+            if not _passes_filters(item, extensions, skip_files, max_file_kb, keyword_files, full_path):
+                continue
+            collected.append(full_path)
+
+    return collected
+
+
+def _passes_filters(filename, extensions, skip_files, max_file_kb, keyword_files, full_path):
+    if filename in skip_files:
+        return False
+    if not any(filename.endswith(ext) for ext in extensions):
+        return False
+    if max_file_kb > 0 and os.path.getsize(full_path) / 1024 > max_file_kb:
+        return False
+    if keyword_files and filename.lower() not in keyword_files:
+        return False
+    return True
+
+
+def _read_file(filepath):
+    for encoding in ("utf-8", "gbk", "latin-1"):
+        try:
+            with open(filepath, "r", encoding=encoding) as f:
+                return f.read()
+        except UnicodeDecodeError:
+            continue
+        except Exception as e:
+            return f"⚠️ 读取失败：{e}"
+    return "⚠️ 读取失败：所有编码均无法解析"

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

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: vaultex
+Version: 0.1.0
+Summary: Extract and merge files from a folder with precision — a lightweight GUI tool for developers and LLM workflows.
+Author-email: Ian Gong <gongzhijie535@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/gongzhijie535-ctrl/vaultex
+Project-URL: Repository, https://github.com/gongzhijie535-ctrl/vaultex
+Project-URL: Issues, https://github.com/gongzhijie535-ctrl/vaultex
+Keywords: file,extract,merge,llm,gradio,code,tools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: gradio>=4.0
+
+# 🔐 Vaultex
+
+> Extract what you need. Nothing more.
+
+Vaultex is a lightweight GUI tool that lets you **scan a folder and merge all matching files into a single text output** — ready to paste into an LLM, a doc, or anywhere you need a full-project snapshot.
+
+The idea is simple: when you're working with a codebase or a collection of files, you often need to quickly gather *specific types* of files across nested folders. Vaultex gives you precise control over what gets included, what gets skipped, and how the result is organized — all through a clean interface.
+
+---
+
+## ✨ Features
+
+- 📂 **Folder picker** — browse or paste a path directly
+- 📄 **File type selector** — pick from common extensions or add your own
+- 🎯 **Whitelist / blacklist filtering** — specify exactly which folders and files to include or exclude
+- 📦 **File size limit** — skip files that are too large
+- 🔁 **Recursive or flat mode** — go deep or stay shallow
+- 🔃 **Sort options** — by path, filename, or last modified time
+- 🔍 **Preview before extracting** — scan first, extract when ready
+- 💾 **Save to file** — optionally write the merged output back to disk
+- 🤖 **Token estimator** — rough count to check if output fits your LLM context window
+
+---
+
+## 🚀 Installation
+
+```bash
+pip install vaultex
+```
+
+Then launch:
+
+```bash
+vaultex
+```
+
+Or run directly from source:
+
+```bash
+git clone https://github.com/gongzhijie535-ctrl/vaultex
+cd vaultex
+pip install -e .
+python -m vaultex
+```
+
+---
+
+## 🖥️ Usage
+
+1. Select a folder using the **📂 picker** or paste a path
+2. Check the file types you want (`.py`, `.md`, `.json`, etc.)
+3. Expand **Filter Options** to narrow down by folder or filename
+4. Click **🔍 Preview** to confirm the file list
+5. Click **🚀 Extract** to merge and view the output
+
+---
+
+## 📁 Project Structure
+
+```
+vaultex/
+├── __init__.py
+├── __main__.py       # entry point: python -m vaultex
+├── core.py           # file collection + merging logic
+└── app.py            # Gradio UI
+```
+
+---
+
+## 📦 Requirements
+
+- Python ≥ 3.10
+- gradio
+
+---
+
+## 👤 Author
+
+**Ian Gong (龚智杰)**
+📧 gongzhijie535@gmail.com
+🐙 [@gongzhijie535-ctrl](https://github.com/gongzhijie535-ctrl)
+
+---
+
+## 📄 License
+
+MIT

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

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+setup.py
+vaultex/__init__.py
+vaultex/__main__.py
+vaultex/app.py
+vaultex/core.py
+vaultex.egg-info/PKG-INFO
+vaultex.egg-info/SOURCES.txt
+vaultex.egg-info/dependency_links.txt
+vaultex.egg-info/entry_points.txt
+vaultex.egg-info/requires.txt
+vaultex.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

vaultex-0.1.0/vaultex.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+vaultex = vaultex.app:launch

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

@@ -0,0 +1 @@
+gradio>=4.0

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

@@ -0,0 +1 @@
+vaultex