‏CodeWeaver: کل کدبیس تو یه فایل Markdown

CodeWeaver یه ابزار خط فرمان با زبان Go هست که کدبیس رو به یه فایل Markdown تبدیل می‌کنه. به صورت بازگشتی یه پوشه رو می‌گرده، یه نمای درختی از ساختار فایل‌ها می‌سازه و محتوای کامل هر فایل رو داخل بلوک کد می‌ذاره. زبان هر بلوک هم از پسوند فایل تشخیص داده می‌شه. سازنده‌ش می‌گه هدف اینه که به اشتراک گذاشتن کد، مستندسازی و دادن پروژه به ابزارهای هوش مصنوعی ساده‌تر بشه.

اجرای ساده‌ش فقط codeweaver هست که از پوشهٔ فعلی یه فایل codebase.md می‌سازه. با -input و -output پوشهٔ ورودی و اسم فایل خروجی عوض می‌شه. فلگ -clipboard هم خروجی رو مستقیم کپی می‌کنه تا بشه سریع تو یه چت‌بات paste کرد.

بخش مهمش فیلتر کردن فایل‌هاست. -ignore مثل یه لیست سیاه کار می‌کنه و هر مسیری که با یکی از regexها جور باشه رو کنار می‌ذاره. پیش‌فرضش .git.* هست. -include یه لیست سفیده، یعنی اگه استفاده‌ش کنی فقط مسیرهایی میان که حداقل با یکی از الگوها جور باشن. اگه هر دو رو با هم بدی، اول include لیست رو می‌سازه و بعد ignore از توش فیلتر می‌کنه. مثلاً این دستور فقط فایل‌های Go و Markdown رو میاره، به جز اونایی که vendor یا test تو مسیرشون دارن:

codeweaver -include="\.go$,\.md$" -ignore="vendor,test"

با -included-paths-file و -excluded-paths-file هم می‌شه لیست مسیرهای اومده و نیومده رو تو فایل جدا ذخیره کرد تا بفهمی دقیقاً چی وارد خروجی شده. نصبش با go install هست و Go 1.18 یا بالاتر لازم داره. فایل اجرایی آماده هم برای سیستم‌عامل‌های مختلف هست و مجوزش MIT هست. خود ریپو هم یه لیست بلند از ابزارهای مشابه مثل RepoMix، code2prompt، files-to-prompt و gitingest رو معرفی کرده.

نکات کلیدی:

• CodeWeaver با Go نوشته شده و Go 1.18 یا بالاتر لازم داره.
• خروجی پیش‌فرض فایل codebase.md هست.
• -ignore لیست سیاه و -include لیست سفیده و هر دو regex قبول می‌کنن.
• الگوی ignore پیش‌فرض .git.* هست.
• فلگ -clipboard خروجی رو مستقیم کپی می‌کنه.
• ابزارهای مشابه: RepoMix، code2prompt، files-to-prompt و gitingest.