taosgen-build

name

taosgen-build

description

Assist users with building, compiling, and installing taosgen from source code. Use this skill when users need help with cmake configuration, conan dependency management, compilation errors, platform-specific build issues, or setting up the development environment for taosgen. Trigger for phrases like "build taosgen", "compile taosgen", "cmake error", "conan install failed", "how to install taosgen", "build from source", or when users encounter build-related issues on Linux, macOS, or Windows.

taosgen Build Assistant

Help users build, compile, and install taosgen from source code.

Overview

taosgen is a C++17 project that uses:

• CMake (≥3.19) for build configuration
• Conan (≥2.19) for dependency management
• CTest for testing

Supported platforms:

• Linux (x64, ARM64)
• macOS (x64, ARM64)

Prerequisites

Before building taosgen, ensure the following are installed:

Required Tools

Tool	Minimum Version	Installation
CMake	3.19+	cmake.org
Conan	2.19+	conan.io
C++ Compiler	C++17 support	gcc/g++ or clang

Platform-Specific Requirements

Linux (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install -y cmake build-essential python3 python3-pip
pip3 install conan>=2.19

macOS:

# Install Xcode Command Line Tools
xcode-select --install

# Or use Homebrew
brew install cmake conan

Standard Build Process

Quick Build (Linux/macOS)

# Clone the repository
git clone https://github.com/taosdata/taosgen.git
cd taosgen

# Create build directory
mkdir build && cd build

# Install dependencies with Conan
conan install .. --build=missing --output-folder=./conan --settings=build_type=Release

# Configure with CMake
cmake .. -DCMAKE_BUILD_TYPE=Release

# Build
cmake --build .

# Run tests (optional)
ctest

macOS Special Case

If the compiler doesn't automatically select the SDK:

cmake .. -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_OSX_SYSROOT=$(xcrun --show-sdk-path) \
  -DCMAKE_TOOLCHAIN_FILE=./conan/conan_toolchain.cmake

Build Options

Build Types

Type	Use Case	Command
Release	Production builds	-DCMAKE_BUILD_TYPE=Release
Debug	Development/debugging	-DCMAKE_BUILD_TYPE=Debug

Conan Profile Configuration

Conan profiles determine how dependencies are built:

# Detect default profile (run once)
conan profile detect --force

# View current profile
conan profile show

# List available profiles
conan profile list

Common CMake Options

# Specify custom install prefix
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local

# Enable verbose build output
cmake .. -DCMAKE_VERBOSE_MAKEFILE=ON

Troubleshooting

Issue: "Conan command not found"

Solution:

# Install conan via pip
pip3 install --user "conan>=2.19"

# Add to PATH if needed
export PATH="$HOME/.local/bin:$PATH"

Issue: "CMake version too old"

Solution:

# Ubuntu/Debian - use Kitware's official repository
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ jammy main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null
sudo apt-get update
sudo apt-get install cmake

# macOS
brew install cmake

Issue: "C++17 standard not supported"

Solution: Check compiler version and upgrade if necessary:

# Check gcc version
gcc --version  # Need 7.0+

# Check clang version
clang --version  # Need 5.0+

# Ubuntu/Debian - install newer gcc
sudo apt-get install gcc-10 g++-10
export CC=gcc-10 CXX=g++-10

Issue: "Conan dependency resolution fails"

Solution:

# Clean conan cache and retry
conan remove "*" -c
conan install .. --build=missing --output-folder=./conan

# Or force rebuild all dependencies
conan install .. --build="*" --output-folder=./conan

Issue: "macOS SDK not found"

Solution:

# Install Xcode Command Line Tools
xcode-select --install

# If already installed, reset path
sudo xcode-select --reset

# Or specify SDK path explicitly
cmake .. -DCMAKE_OSX_SYSROOT=$(xcrun --show-sdk-path)

Testing

Run All Tests

cd build
ctest

Run with Verbose Output

ctest -V

Run Specific Test

ctest -R <test_name>

Parallel Testing

ctest -j$(nproc)  # Linux
ctest -j$(sysctl -n hw.ncpu)  # macOS

Installation

After successful build:

cd build
sudo cmake --install .

Or specify custom prefix:

cmake --install . --prefix /path/to/install

IDE Integration

VSCode

Install extensions:

• C/C++ Extension Pack
• CMake Tools

Configure CMake Tools to use the conan toolchain:

{
  "cmake.configureArgs": [
    "-DCMAKE_TOOLCHAIN_FILE=${workspaceFolder}/build/conan/conan_toolchain.cmake"
  ]
}

CLion

1. Open project root directory
2. CMake should auto-detect the build configuration
3. If not, manually specify:
   • Build directory: build
   • CMake options: -DCMAKE_TOOLCHAIN_FILE=./conan/conan_toolchain.cmake

Workflow for Build Issues

When user reports a build issue:

1. Identify platform: Linux/macOS? Architecture?
2. Check prerequisites: CMake version? Conan version? Compiler?
3. Review error message: Is it conan, cmake, or compile-time?
4. Suggest solutions: Use the troubleshooting guide above
5. Verify fix: Ask user to try the recommended solution

Example User Interactions

"How do I build taosgen?"

• Provide the Quick Build steps for their platform

"Conan install failed with missing packages"

• Suggest conan install .. --build="*" to build from source

"I'm on macOS and cmake can't find the SDK"

• Provide macOS-specific SDK path solution

"Build succeeded but tests fail"

• Check if TDengine is running (required for integration tests)
• Suggest using TSGEN_ENABLE_TEST=OFF if just testing the build

References

• CMake Documentation
• Conan Documentation
• taosgen CI/CD