cplusplus

KO | EN

gitlite — search

#javascript #python #react #nextjs #java #typescript #machine-learning #nodejs #cpp #html5 #rust #arduino

★ 157 Open GitHub ↗

A compiler front end for the C++ language

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A compiler front end for the C++ language

cxx-frontend is a work-in-progress compiler frontend for C++26 and C23

The compiler frontend is designed to be a powerful tool for developers, enabling them to parse, analyze, and modify C++ source code.
This project aims to provide a robust foundation for building a complete C++ frontend, staying up-to-date with the latest language features and standards.

Playground showing the cxx compiler frontend in action at https://robertoraggi.github.io/cplusplus/

The API Reference is available at https://robertoraggi.github.io/cplusplus/docs/

# Changelog and What's New

For updates, improvements, and recent features in cxx-frontend, please consult the [Changelog](CHANGELOG.md).

# Key Features

- **Syntax Analysis**: APIs to scan, preprocess, parse, and inspect the syntax of source code, making it a versatile tool for various code analysis tasks.

- **Multi-Language Support**: In addition to C++, the library provides APIs for TypeScript and JavaScript.

- **C++-26 and C23 Support**: Latest language enhancements, syntax, and features (WIP).

- **MLIR**: MLIR code generation and optimization.

## Playground

The playground uses the Monaco Editor to demonstrate how to create a syntax checker and navigate the Abstract Syntax Tree (AST).

https://robertoraggi.github.io/cplusplus/

## Native Build and CLI tools

On Linux, macOS and Windows:

install the python packages required to run the unit tests (optional)

```sh
uv sync && source .venv/bin/activate
```

configure with MLIR support enabled

```sh
cmake --preset default-mlir
```

build

```sh
cmake --build build
```

run the unit tests

```sh
cd build
ctest --progress
```

Dump the AST to stdout

```sh
 ./build/src/frontend/cxx tests/manual/source.cc -ast-dump
```

## Build the npm package (requires docker)

prepare the package

```sh
npm ci
```

compile WASM and TypeScript code

```sh
npm run build:cxx-frontend
```

## Build for WASM/WASI (requires docker)

```sh
npm ci
npm run build:wasi
```

run the C++ front end CLI tool using wasmtime

```sh
wasmtime \
  --mapdir=/::build.wasi/install \
  --mapdir tests::tests \
  build.wasi/install/usr/bin/cxx.wasm -- \
  tests/manual/source.cc -ast-dump
```

## Installing from npm

To integrate the latest stable version of the C++ Compiler Frontend bindings into your project, you can install them from npm:

```sh
npm install cxx-frontend
```

Once installed, you can use the bindings in your Node.js or web projects as needed.

## License

Licensed under the [MIT](LICENSE) license.

cplusplus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README