insurgent 0.1.1

A modern dev shell and build system for C/C++ projects

InsurgeNT ⚙️✨

Integrated Native Toolkit (InsurgeNT) – a beautiful, modern devshell + build system for C/C++ projects.

A clean, expressive, and fast workflow for native development.
Simple YAML configs. Stunning output. No boilerplate. No stress.

✨ Features

• ⚡️ Incremental builds with parallel + async compilation
• 📦 project.yaml-based config with automatic source/include detection
• 🧠 Intelligent project layout and dependency tracking
• 💻 Interactive shell with tab completion, history, and file ops
• 🔧 Multi-compiler + cross-platform support (Linux, macOS, Windows)
• 🎨 Beautiful TUI feedback with emoji, colors, and clean symbols

Getting Started

To start using InsurgeNT, run the shell:

python -m insurgent # or python -m int

Build Commands

InsurgeNT now supports parallel builds by default for maximum performance.

# Build all targets in parallel
build

# Build specific target
build myapp

# Build with debug symbols
build --debug mylib

# Build sequentially (non-parallel)
build --sequential

Unit tests (native harness)

Declare an optional unit_tests block in project.yaml (see docs/ProjectYAML.md). InsurgeNT compiles sources listed there into a separate executable and runs it when you execute:

insurgent test
# or: insurgent t

From the interactive shell:

test

Use test --silent / test --no-incremental in the shell, or insurgent test --silent / --no-incremental on the CLI. A non-zero exit code from the test binary is treated as failure.

For project_type: library, the main static library (output) is built first and linked into the test executable by default. Use unit_tests.link_project: false for a self-contained test binary, or unit_tests.libraries to add more archives (paths relative to the project root).

Creating a Project

InsurgeNT uses YAML configuration for project definitions. Here's an example:

project: example
description: An example project
authors: ["John Doe", "Jane Doe"]
license: MIT
version: 0.1.0
language: c++
standard: c++20
compiler: g++
compiler_flags:
  - global: "-fPIC"
  - common: "-O2 -Wall -Wextra"
  - cpp: "-std=c++20"
  - ld: "-lstdc++"
project_dirs: ["sources"]
project_type: executable
output: bin/example

# Optional bootstrap step
bootstrap:
  - task: prepare
  - command: "mkdir -p bin"

Installation

pip install insurgent

Development Setup

For development, InsurgeNT provides setup scripts to create a virtual environment and install dependencies:

On Linux/macOS:

# Setup development environment
./setup.sh

# With additional options
./setup.sh --venv=custom_venv --hooks --lint

On Windows:

# Setup development environment
setup.bat

# With additional options
setup.bat --venv=custom_venv --hooks --lint

Linting

To run linting tools on your code:

On Linux/macOS:

# Check and format code
./lint.sh

# Only check code (for CI)
./lint.sh --check

On Windows:

# Check and format code
lint.bat

# Only check code (for CI)
lint.bat --check

Usage

After installation, you can run the development shell by executing:

python -m insurgent

Available Commands

• ls, cd, pwd - File navigation
• mkdir, touch, rm, cp - File operations
• build <project> [options] - Build a project
• test [--silent] [--no-incremental] - Build and run the unit test executable
• history - Show command history

Build System

InsurgeNT includes a powerful build system for C/C++ projects with features like:

• Incremental builds
• Dependency tracking
• Multiple compiler support
• Parallel and fully asynchronous compilation for maximum performance
• Cross-platform compatibility

License

InsurgeNT is licensed under the MIT License