BuildIt v1.0

BuildIt

Cross-Platform Build Automation

BuildIt is a simple and universal solution for automating build processes across multiple platforms, including Windows, GNU/Linux, Unix, and macOS. It reads a BuildFile that defines functions for each platform, and then executes the corresponding commands in a platform-specific manner.

Features

• Cross-Platform Support: Supports Windows, GNU/Linux, macOS and any Unix-like/based OS.
• Customizable Build Functions: Allows users to define platform-specific commands in a BuildFile.
• Temporary Script Execution: Creates temporary batch or shell scripts based on the platform to execute commands.

Prerequisites

• Rust: The Rust programming language is required to build the application.
• Supported OS: Windows, GNU/Linux, macOS, or any Unix-like/based OS.

Installation

Follow these steps to get BuildIt up and running on your system:

1. Clone the repository:

   git clone https://github.com/neoapps-dev/buildit.git

2. Navigate into the project directory:

   cd buildit

3. Build the project using Cargo:

   cargo build --release

4. Locate the executable in the target/release directory after the build is complete.

Usage

Once built, you can use BuildIt to automate build tasks on different platforms by specifying a function name.

Command Syntax

buildit <FunctionName>

Example

To execute a build function defined in your BuildFile, run:

buildit build

BuildFile Format

The BuildFile is where platform-specific functions are defined. It uses a simple format to specify commands to be executed on different platforms.

Example BuildFile

build:windows {
    @echo off
    echo "Building project on Windows"
    cargo build --release
}

build:lignux {
    #!/bin/bash
    echo "Building project on GNU/Linux"
    cargo build --release
}

build:macos {
    #!/bin/zsh
    echo "Building project on macOS"
    cargo build --release
}

build:unix {
    #!/bin/sh
    echo "Hello from Unix!"
}

Format Explanation

• The first part (build:windows {) specifies the function name (build) and the platform (windows).
• The commands inside the curly braces are the steps that will be executed on the specified platform.
• Each platform-specific section can include its own commands, such as cargo build, gcc, or any other shell command.

How It Works

1. Platform Detection: BuildIt detects the current platform (Windows, GNU/Linux, Unix, or macOS).
2. Function Lookup: It looks for a function in the BuildFile that matches the specified function name.
3. Command Execution: The corresponding commands for the detected platform are extracted and executed in a temporary script (either .bat for Windows or .sh for Unix-like systems).
4. Error Handling: If a function or platform-specific command is missing, BuildIt will output an error message and terminate the process.

Error Handling

If there are errors during command execution, BuildIt will display:

• An error message with the failed command.
• The specific error status for the command execution.

Note

Make sure to add the download binaries to PATH

Files

• buildit.exe ==> Compiled for Windows
• buildit ==> Compiled for GNU/Linux