Pipery C/C++ CI#

Reusable GitHub Action for a complete C/C++ CI pipeline with structured logging via Pipery. Auto-detects CMake, Make, and Meson build systems.

GitHub Marketplace Version License: MIT

Usage#

name: CI
on: [push, pull_request]

jobs:
  ci:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pipery-dev/pipery-cpp-ci@v1
        with:
          project_path: .
          github_token: ${{ secrets.GITHUB_TOKEN }}

Pipeline steps#

StepToolSkip input
SASTSemgrep / clang-tidy SAST rulesskip_sast
SCAcppcheck / Conan auditskip_sca
Lintclang-tidy + cppcheckskip_lint
BuildCMake / Make / Meson (auto-detect)skip_build
Testctest / make testskip_test
VersionSemantic version bumpskip_versioning
PackageTarball archiveskip_packaging
ReleaseGitHub Release + SHA tagskip_release
ReintegrateMerge back to default branchskip_reintegration

Inputs#

NameDefaultDescription
project_path.Path to the project source tree.
config_file.github/pipery/config.yamlPath to Pipery config file.
build_systemautoBuild system: auto, cmake, make, or meson.
compilerg++C++ compiler to use (e.g. g++, clang++).
cmake_flags``Extra flags passed to the CMake configure step.
tests_path``Test filter pattern passed to ctest -R or equivalent.
target_branchmainTarget branch for reintegration.
version_bumppatchVersion bump type: patch, minor, or major.
github_token``GitHub token for release and reintegration.
log_filepipery.jsonlPath to the JSONL structured log file.
skip_sastfalseSkip the SAST step.
skip_scafalseSkip the SCA step.
skip_lintfalseSkip the lint step.
skip_buildfalseSkip the build step.
skip_testfalseSkip the test step.
skip_versioningfalseSkip the versioning step.
skip_packagingfalseSkip the packaging step.
skip_releasefalseSkip the release step.
skip_reintegrationfalseSkip the reintegration step.

About Pipery#

Pipery is an open-source CI/CD observability platform. Every step script runs under psh (Pipery Shell), which intercepts all commands and emits structured JSONL events — giving you full visibility into your pipeline without any manual instrumentation.

Development#

# Run the action locally against test-project/
pipery-actions test --repo .

# Regenerate docs
pipery-actions docs --repo .

# Dry-run release
pipery-actions release --repo . --dry-run