Skip to content

یک ابزار مبتنی بر پایتون برای تبدیل کل پوشه پروژه به یک فایل متنی (مناسب برای ارسال به LLMها) و بازسازی مجدد آن. (English: A Python-based tool to pack an entire project into a single text file for LLMs, and unpack it back.)

Notifications You must be signed in to change notification settings

hostadi/packapp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

Project Packer & Unpacker 📦

[English description below]

این پروژه شامل دو ابزار کاربردی با رابط گرافیکی (GUI) است که به زبان پایتون نوشته شده‌اند. هدف اصلی این ابزار، ساده‌سازی فرآیند اشتراک‌گذاری کد منبع پروژه‌های بزرگ است.

آیا تا به حال خواسته‌اید کل پروژه برنامه‌نویسی خود را برای تحلیل به ChatGPT، Claude یا Gemini بفرستید؟ آپلود تک‌تک فایل‌ها دشوار است. این ابزار کل پروژه شما را به یک فایل متنی (.txt) تبدیل می‌کند و همچنین قابلیت بازگرداندن (Unpack) آن را دارد.

🚀 ویژگی‌ها

📂 Pack (تجمیع کننده)

  • تبدیل پروژه به یک فایل: تمام فایل‌های متنی پروژه را در یک فایل .txt ذخیره می‌کند.
  • فیلتر هوشمند: فایل‌های باینری (عکس، exe و ...) و پوشه‌های سیستمی (مثل .git, node_modules, __pycache__) را به صورت خودکار نادیده می‌گیرد.
  • رابط کاربری ساده: امکان انتخاب پوشه و مدیریت لیست فایل‌های نادیده گرفته شده (Ignore List) از طریق GUI.
  • تشخیص خودکار: بررسی محتوای فایل برای اطمینان از متنی بودن آن.

♻️ Unpack (بازسازی کننده)

  • بازسازی ساختار: فایل متنی تولید شده را می‌خواند و ساختار پوشه‌ها و فایل‌های اصلی را دقیقاً بازسازی می‌کند.
  • ایمن: قبل از بازنویسی در پوشه‌ای که خالی نیست، هشدار می‌دهد.

🛠 پیش‌نیازها

برای اجرای این برنامه تنها به پایتون نیاز دارید. کتابخانه‌های استفاده شده (tkinter, os) به صورت پیش‌فرض در پایتون وجود دارند.

  • Python 3.x

computer: نحوه اجرا

۱. تجمیع پروژه (Pack)

فایل pack.py را اجرا کنید:

python pack.py




English Description
Project Packer & Unpacker helps you combine your entire coding project into a single text file. This is extremely useful for feeding your codebase into Large Language Models (LLMs) like ChatGPT or Claude for code review or debugging.

Features:
GUI Interface: Easy to use Tkinter interface.

Smart Ignore: Automatically skips .git, node_modules, and binary files.

Customizable: Add or remove folders from the ignore list easily.

Reversible: The unpack.py script reconstructs the original project directory from the text file.

Usage:
Run python pack.py to bundle your project. Run python unpack.py to restore a project from a bundle.

About

یک ابزار مبتنی بر پایتون برای تبدیل کل پوشه پروژه به یک فایل متنی (مناسب برای ارسال به LLMها) و بازسازی مجدد آن. (English: A Python-based tool to pack an entire project into a single text file for LLMs, and unpack it back.)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages