SourceCraft Project Bundler

A zero-footprint, stateless desktop utility designed to scan, parse, and bundle complex directories or selected source files into unified, clean documents (Markdown, Plain Text, or JSON). Optimized for compiling large codebases, nested repositories, or single source files into easily parsable structures for LLM indexing, auditing, or archiving.

🚀 Key Features

• Dynamic .gitignore Parsing
  Automatically discovers and parses standard .gitignore glob patterns inside your target directory. Converts them to compiled regular expressions on-the-fly to filter dependencies, temporary caches, and non-source files automatically.
• Flexible Source Target Selection
  Supports selecting an entire folder (recursively scanning all subdirectories), a single file, or multiple files simultaneously.
• Automatic Binary Asset Detection
  Inspects initial file byte chunks for null bytes (\x00) to safely bypass compiled binaries, images, and archives, preventing output bundle text corruption.
• Non-Blocking Multi-Threaded Engine
  Decoupled file scanning and processing executes inside an asynchronous threading.Thread. This prevents the GUI from hanging or freezing when traversing heavy repositories.
• Dark AMOLED & High-Contrast RGB Neon Interface
  Styled with a pure #000000 AMOLED background, high-contrast white text, and sharp RGB neon borders (Cyan, Purple, Pink) for maximum visual legibility.
• Windows OS Immersive Title Bar
  Directly invokes Windows Desktop Window Manager (DWM) APIs to render the OS window title bar in pure AMOLED black with crisp white caption text.

🛠️ Project Structure

SOURCECRAFT-PROJECT-BUNDLER/
├── main.py                # Primary application entrypoint
├── build.py               # Automated compiler & auto-cleanup script
├── .gitignore             # Prunes build directories from Git tracking
├── README.md              # Technical documentation and guide
└── src/
    ├── __init__.py        # Python package marker
    ├── app.py             # Main GUI application window class
    ├── components.py      # RGB UI components & filter modal dialog
    ├── config.py          # Theme palette tokens & DWM titlebar API
    ├── engine.py          # Multi-target compilation engine
    └── gitignore.py       # Dynamic .gitignore glob parser

🏃 Run Guide (Without Compiling)

The application utilizes Python standard library components and can be launched directly with zero external dependencies.

Windows Command Prompt (CMD):

python main.py

Windows PowerShell:

python .\main.py

Linux / macOS Terminal:

python3 main.py

📦 Compiling to Standalone Binary (SourceCraft.exe)

You can compile this project into a standalone, single-file Windows executable (SourceCraft.exe) with automated cleanup of temporary build artifacts.

1. Install PyInstaller:

   pip install pyinstaller

2. Run the automated build script:

   python build.py

3. Locate your executable at dist/SourceCraft.exe. All temporary build/ directories, .spec files, and __pycache__ artifacts are automatically deleted upon completion.

⚙️ Supported Export Layouts

• Markdown (.md): Separates code files with headers and clean code-block wrappers matching file extensions (e.g., python or cs). Ideal for LLM prompt injections.
• Plain Text (.txt): Bundles entries with clean structural horizontal separation boundaries.
• JSON (.json): Formats files into structured key-value arrays along with processing metadata parameters.