Building

Configure CMake builds and run tests for the Chemical project.

28|2|Updated Dec 24, 2023
One-click install
npx skills add https://github.com/chemicallang/chemical --skill building-chemicallang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Building
Source: https://github.com/chemicallang/chemical/tree/main/.agents/skills/building
Command: npx skills add https://github.com/chemicallang/chemical --skill building-chemicallang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill consolidates guidance on configuring and building the Chemical language project, including selecting the appropriate compiler and how to run tests.

Core Features & Use Cases

  • Compiler choices: Use TCCCompiler for faster builds or Compiler for LLVM/Clang-backed builds and optimizations.
  • Build workflow guidance: Understand the CMake-based build system, root CMakeLists.txt, and how to configure and build specific targets.
  • Test and library workflows: Instructions for building and running tests and libraries as described in the repository, including how to isolate components like lang/tests.
  • Use Case: A developer working on a library can quickly configure and execute a targeted test build to validate changes.

Quick Start

Follow the root README's build instructions to configure the environment and initiate a build with your preferred compiler.

Frequently Asked Questions about Building

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a CMake-based project and run its tests?

To build a CMake-based project and run tests, configure the environment using the root CMakeLists.txt, select your preferred compiler, and execute the provided build commands to compile and validate specific test targets.

When should I use TCCCompiler instead of the standard Compiler for builds?

Use TCCCompiler for faster builds during development iterations, or switch to the standard Compiler when you need LLVM or Clang-backed builds with advanced optimizations for your project.

What do I need to configure before compiling libraries in this repository?

Before compiling libraries, you need a CMake-based workflow configured with a root CMakeLists.txt file and familiarity with the specific build commands required to isolate and execute components like lang/tests.

Can I isolate and build specific test components instead of the entire project?

Yes, you can isolate and build specific test components by configuring the build environment to target individual directories like lang/tests, allowing you to validate changes quickly without compiling the entire project.

What is the best way to streamline configuring and running a CMake build environment?

The best way to streamline a CMake build environment is to follow the root README's build instructions to configure the environment and initiate a build with your preferred compiler selection.

Why does my CMake build workflow require a root CMakeLists.txt file?

Your CMake build workflow requires a root CMakeLists.txt file because it defines the build configuration, target selection, and instructions necessary to properly compile libraries and execute tests across the project.