Neovim plugin for GCC compiler development. Provides integrated debugging and testing workflows for the GCC testsuite. The plugin is also showcased in this video demonstration

This plugin automates common GCC development tasks:

• Searching/executing tests from within neovim
• Extracting cc1plus invocations from xg++ for GDB debugging
• Parsing DejaGNU test directives (dg-options, dg-additional-options, dg-require-effective-target)
• Running testsuite cases with proper libstdc++ include paths

• Neovim ≥ 0.8.0
• GCC source tree with gcc/ directory
• Build directory (either inside source or as sibling)
• Compiled xg++ and cc1plus binaries in build/gcc/
• nvim-gdb (optional, required for :GdbCC1plus)

{
  'riogu/gcc1plus',
  dependencies = {
    { 'sakhnik/nvim-gdb', build = './install.sh' },
  },
}

use {
  'riogu/gcc1plus',
  requires = { 'sakhnik/nvim-gdb', run = './install.sh' },
}

Plug 'sakhnik/nvim-gdb', { 'do': './install.sh' }
Plug 'riogu/gcc1plus'

Open Neovim from any directory within your GCC source tree. The plugin automatically locates the source root (directory containing gcc/) and build directory (either source/build/ or sibling ../build/).

:FindTest is the primary interface for working with GCC tests. It searches the testsuite and opens an interactive buffer where you can quickly navigate, compile, debug, or run tests.

:FindTest constexpr

This opens a split window with all matching test files. Use these keybindings:

Search by filename:

:FindTest constexpr-virt1
" Navigate to the test you want, press 'd' to start debugging in GDB

Search by directory path:

:FindTest cpp26/constexpr       " All constexpr tests in cpp26
:FindTest template/             " All tests in template directory
:FindTest cpp2a/concepts        " C++20 concepts tests

Search by feature or bug number:

:FindTest concepts              " All concepts-related tests
:FindTest pr12345               " Tests for bug report #12345
:FindTest crash                 " Tests that previously caused crashes

1. Make changes to GCC frontend code (e.g., in gcc/cp/)
2. Run :FindTest <relevant-feature> to find related tests
3. Press r to compile tests and verify your changes
4. Press d to debug any failing tests with GDB
5. Press t to run official testsuite validation
6. Press l to view test logs and PASS/FAIL results

:GdbCC1plus gcc/testsuite/g++.dg/cpp26/constexpr-virt1.C -O2
:RunTest gcc/testsuite/g++.dg/template/crash115.C
:RunTestsuite gcc/testsuite/g++.dg/cpp2a/concepts-pr67178.C

The plugin walks up from getcwd() to find the GCC source directory (containing gcc/), then locates the build directory:

• First checks: source/build/
• Then checks: ../build/ (sibling to source)

Automatically detects the target architecture by searching for libstdc++-v3 in the build directory. Supports common targets including:

• x86_64-pc-linux-gnu / x86_64-linux-gnu
• aarch64-linux-gnu
• arm-linux-gnueabihf
• powerpc64le-linux-gnu
• riscv64-linux-gnu
• s390x-linux-gnu
• i686-pc-linux-gnu / i686-linux-gnu

Parses the following directives from test files:

• { dg-options "..." }
• { dg-additional-options "..." }
• { dg-require-effective-target c++NN }

Directives are extracted from C++ (//) and C (/* */) style comments within the first 2000 bytes of the test file.

Runs xg++ -v with proper include paths and parses the cc1plus invocation from verbose output. Include paths are automatically configured for:

• build/<target-triplet>/libstdc++-v3/include/
• libstdc++-v3/libsupc++/
• libstdc++-v3/include/backward/
• libstdc++-v3/testsuite/util/

:GccCheck verifies:

• GCC source directory structure
• Build directory location (shows detected path)
• xg++ binary is executable
• cc1plus binary exists
• Target architecture detected
• libstdc++-v3 source and build directories

The plugin supports two common GCC build layouts:

Structure 1 (build inside source):

gcc-source/
├── gcc/
│   ├── cp/
│   ├── testsuite/g++.dg/
│   └── ...
├── libstdc++-v3/
└── build/
    ├── gcc/
    │   ├── xg++
    │   └── cc1plus
    └── <target-triplet>/libstdc++-v3/

Structure 2 (build as sibling):

project/
├── source/
│   ├── gcc/
│   │   ├── cp/
│   │   ├── testsuite/g++.dg/
│   │   └── ...
│   └── libstdc++-v3/
└── build/
    ├── gcc/
    │   ├── xg++
    │   └── cc1plus
    └── <target-triplet>/libstdc++-v3/

• DejaGNU Documentation
• nvim-gdb