mergecraft 0.0.8

A command-line tool to merge files into a temporary file and open in VS Code. Designed to support AI-driven development.

mergecraft 🚀

mergecraft is a command-line tool engineered to assist development teams by merging files into a single temporary file and then opening it in Visual Studio Code. This tool is particularly useful in AI-driven development environments, where understanding the broader context of code changes is crucial.

🌟 Introduction to AI-Driven Development with mergecraft

In AI-driven development, tools like mergecraft play a pivotal role by reducing the cognitive load on developers. It enables them to focus more on refining the technology rather than getting bogged down with mundane tasks. By merging related files into a single view, mergecraft helps in providing a consolidated context, enhancing the capabilities of AI code assistants like StackSpot AI.

🚀 Benefits of Using mergecraft

• Enhanced Productivity: Speeds up the development process by merging files quickly and efficiently, allowing developers to see everything in one place.
• Reduced Errors: Minimizes the chance of overlooking context-related errors by providing a unified view of multiple files.
• Support for AI Code Assistants: Improves the effectiveness of AI-driven tools which rely on understanding code in context, aiding in intelligent code completion and error correction.

⚙️ Installation

Setting Up Your Environment

To set up the mergecraft tool, you can now install it directly from PyPI:

pip install mergecraft

⬆️ Upgrading mergecraft

To upgrade to the latest version of mergecraft, you can use the following command:

pip install --upgrade mergecraft

📦 Install Locally

Alternatively, if you need to install from the source for the latest features or development purposes:

# Clone the repository
git clone https://github.com/your-username/mergecraft.git
cd mergecraft

# Create and activate a virtual environment
python -m venv env
source env/Scripts/activate  # Windows
source env/bin/activate      # Unix/Mac

# Install dependencies
pip install -r requirements.txt

# Install mergecraft
pip install .

# Deactivate the virtual environment
deactivate

🛠 How to Use mergecraft

Once installed, you can use mergecraft from any terminal:

mergecraft [options]

📝 Command-line Options

• -e, --extensions: Specify which file extensions to include in the merge. Defaults to settings in mergecraft.config.yml.
• --path: Set the root path for searching files. Defaults to the current directory.
• --filter: Apply a regex filter to select files based on content or name.

⚙️ Configuration via mergecraft.config.yml

Configure mergecraft by editing the mergecraft.config.yml file, which allows you to specify extensions, and files or directories to skip:

extensions:
  - ".py"
  - ".txt"
skip_files:
  - ".gitignore"
  - "LICENSE"
  - "README.md"
  - "__init__.py"
  - "_*"
skip_directories:
  - "bin"
  - "obj"
  - ".git"

🎯 AI in Development: The Role of mergecraft

mergecraft supports AI-driven development by automating routine tasks like file merging, aiding in documentation, and streamlining code reviews. It helps bridge the gap between developers' needs for consistency and the requirements of fast-paced technology environments, making it an indispensable tool for modern development teams.

📜 License

mergecraft is released under the MIT License. See the LICENSE file for more details.