mirror of
https://github.com/threeal/cmake-action.git
synced 2025-04-21 02:51:21 +00:00
chore: merge pull request #47 from threeal/default-to-no-build
Default to No Build
This commit is contained in:
Alfi Maulana
GitHub
commit
e774bd0f0d
104
.github/workflows/test.yml
vendored
104
.github/workflows/test.yml
vendored
@ -8,92 +8,124 @@ jobs:
|
||||
default-usage:
|
||||
runs-on: ${{ matrix.os }}-latest
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
os: [windows, ubuntu, macos]
|
||||
steps:
|
||||
- name: Check out this repository
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Move test project to the working directory
|
||||
- name: Move the test project to the working directory
|
||||
run: mv test/* .
|
||||
|
||||
- name: Use this action
|
||||
- name: Use the action
|
||||
uses: ./
|
||||
|
||||
- name: Run the build result
|
||||
run: ${{ matrix.os == 'windows' && 'build\Debug\hello_world.exe' || 'build/hello_world' }}
|
||||
- name: Try to test the project
|
||||
id: failed-step
|
||||
continue-on-error: true
|
||||
run: ctest --test-dir build --output-on-failure --no-tests=error -R hello_world ${{ matrix.os == 'windows' && '-C Debug' || '' }}
|
||||
|
||||
- name: Check on success
|
||||
if: steps.failed-step.outcome == 'success'
|
||||
run: exit 1
|
||||
|
||||
- name: Build and test the project
|
||||
run: |
|
||||
cmake --build build
|
||||
ctest --test-dir build --output-on-failure --no-tests=error -R hello_world ${{ matrix.os == 'windows' && '-C Debug' || '' }}
|
||||
|
||||
specified-dir-usage:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check out this repository
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Use this action with specified directories
|
||||
- name: Use the action with specified directories
|
||||
uses: ./
|
||||
with:
|
||||
source-dir: test
|
||||
build-dir: output
|
||||
run-test: true
|
||||
test-args: -R hello_world
|
||||
|
||||
- name: Check if the default build directory does not exist
|
||||
run: test ! -d build && test ! -d test/build
|
||||
shell: bash
|
||||
run: test ! -e build && test ! -e test/build
|
||||
|
||||
- name: Build and test the project
|
||||
run: |
|
||||
cmake --build output
|
||||
ctest --test-dir output --output-on-failure --no-tests=error -R hello_world
|
||||
|
||||
run-build-usage:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Use the action with run build enabled
|
||||
uses: ./
|
||||
with:
|
||||
source-dir: test
|
||||
run-build: true
|
||||
build-args: --target test_c --target test_cpp
|
||||
|
||||
- name: Test the project
|
||||
run: ctest --test-dir test/build --output-on-failure --no-tests=error -R test
|
||||
|
||||
run-test-usage:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Use the action with run test enabled
|
||||
uses: ./
|
||||
with:
|
||||
source-dir: test
|
||||
run-test: true
|
||||
test-args: -R hello_world
|
||||
|
||||
additional-flags-usage:
|
||||
runs-on: ${{ matrix.compiler == 'msvc' && 'windows' || 'ubuntu' }}-latest
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
compiler: [gcc, msvc]
|
||||
steps:
|
||||
- name: Check out this repository
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Use this action with additional compiler flags
|
||||
- name: Use the action with additional compiler flags
|
||||
uses: ./
|
||||
with:
|
||||
source-dir: test
|
||||
targets: test_c test_cpp
|
||||
run-test: true
|
||||
c-flags: ${{ matrix.compiler == 'msvc' && '/w /WX-' || '-Wno-unused-variable' }}
|
||||
cxx-flags: ${{ matrix.compiler == 'msvc' && '/w /WX-' || '-Wno-unused-variable' }}
|
||||
args: -D CHECK_SURPASS_WARNING=ON
|
||||
run-build: true
|
||||
build-args: --target test_c --target test_cpp
|
||||
run-test: true
|
||||
test-args: -R test ${{ matrix.compiler == 'msvc' && '-C Debug' || '' }}
|
||||
|
||||
specified-compiler-usage:
|
||||
specified-generator-and-compiler-usage:
|
||||
runs-on: ${{ matrix.os }}-latest
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
os: [windows, ubuntu, macos]
|
||||
steps:
|
||||
- name: Check out this repository
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Use this action with specified compilers
|
||||
- name: Use the action with specified generator and compilers
|
||||
uses: ./
|
||||
with:
|
||||
source-dir: test
|
||||
targets: test_c test_cpp
|
||||
run-test: true
|
||||
generator: Ninja
|
||||
c-compiler: clang
|
||||
cxx-compiler: clang++
|
||||
args: -D CHECK_USING_CLANG=ON
|
||||
test-args: -R test
|
||||
|
||||
specified-generator-usage:
|
||||
runs-on: ${{ matrix.os }}-latest
|
||||
strategy:
|
||||
matrix:
|
||||
os: [windows, ubuntu, macos]
|
||||
steps:
|
||||
- name: Check out this repository
|
||||
uses: actions/checkout@v3.5.3
|
||||
|
||||
- name: Use this action with a specified generator
|
||||
uses: ./
|
||||
with:
|
||||
source-dir: test
|
||||
run-build: true
|
||||
build-args: --target test_c --target test_cpp
|
||||
run-test: true
|
||||
generator: Ninja
|
||||
test-args: -R hello_world
|
||||
test-args: -R test
|
||||
|
||||
58
README.md
58
README.md
@ -4,12 +4,13 @@
|
||||
[](./LICENSE)
|
||||
[](https://github.com/threeal/cmake-action/actions/workflows/test.yml)
|
||||
|
||||
Configure, build, and test your [CMake](https://cmake.org/) project using [GitHub Actions](https://github.com/features/actions). This action simplifies the workflow for your CMake project. It configures the build environment using the `cmake` command, builds the project using the `cmake --build` command, and optionally tests the project using the `ctest` command.
|
||||
Configure, build, and test your [CMake](https://cmake.org/) project using [GitHub Actions](https://github.com/features/actions). This action simplifies the workflow for your CMake project. It configures the build environment using the `cmake` command, and optionally builds the project using the `cmake --build` command and tests the project using the `ctest` command.
|
||||
|
||||
## Features
|
||||
|
||||
- Configures and builds a project using the [cmake](https://cmake.org/cmake/help/latest/manual/cmake.1.html) command.
|
||||
- Option to test a project using the [ctest](https://cmake.org/cmake/help/latest/manual/ctest.1.html) command.
|
||||
- Configures a project using the [`cmake`](https://cmake.org/cmake/help/latest/manual/cmake.1.html) command.
|
||||
- Option to build a project using the `cmake --build` command.
|
||||
- Option to test a project using the [`ctest`](https://cmake.org/cmake/help/latest/manual/ctest.1.html) command.
|
||||
- Auto-detects and installs required dependencies.
|
||||
- Supports specifying multiple CMake options directly from the Action inputs.
|
||||
|
||||
@ -21,17 +22,18 @@ For more information, refer to [action.yml](./action.yml) and the [GitHub Action
|
||||
|
||||
| Name | Value Type | Description |
|
||||
| --- | --- | --- |
|
||||
| `source-dir` | Path | Source directory of the CMake project. Defaults to the current directory. |
|
||||
| `build-dir` | Path | Build directory of the CMake project. Defaults to the `build` directory inside the source directory. |
|
||||
| `targets` | Multiple strings | List of build targets. |
|
||||
| `run-test` | `true` or `false` | If enabled, runs testing using [CTest](https://cmake.org/cmake/help/latest/manual/ctest.1.html). Defaults to `false`. |
|
||||
| `generator` | String | Build system generator for the CMake project. |
|
||||
| `c-compiler` | String | Preferred executable for compiling C language files. |
|
||||
| `cxx-compiler` | String | Preferred executable for compiling C++ language files. |
|
||||
| `c-flags` | Multiple strings | Additional flags passed when compiling C language files. |
|
||||
| `cxx-flags` | Multiple strings | Additional flags passed when compiling C++ language files. |
|
||||
| `args` | Multiple strings | Additional arguments passed during CMake configuration. |
|
||||
| `test-args` | Multiple strings | Additional arguments passed during the CTest run. |
|
||||
| `source-dir` | Path | The source directory of the CMake project. It defaults to the current directory. |
|
||||
| `build-dir` | Path | The build directory of the CMake project. It defaults to the `build` directory inside the source directory. |
|
||||
| `generator` | String | The build system generator for the CMake project. |
|
||||
| `c-compiler` | String | The preferred executable for compiling C language files. |
|
||||
| `cxx-compiler` | String | The preferred executable for compiling C++ language files. |
|
||||
| `c-flags` | Multiple strings | Additional flags to pass when compiling C language files. |
|
||||
| `cxx-flags` | Multiple strings | Additional flags to pass when compiling C++ language files. |
|
||||
| `args` | Multiple strings | Additional arguments to pass during the CMake configuration. |
|
||||
| `run-build` | `true` or `false` | If enabled, it builds the project using [CTest](https://cmake.org/cmake/help/latest/manual/ctest.1.html). It defaults to `false`. |
|
||||
| `build-args` | Multiple strings | Additional arguments to pass during the CMake build. |
|
||||
| `run-test` | `true` or `false` | If enabled, it runs testing using [CTest](https://cmake.org/cmake/help/latest/manual/ctest.1.html). It defaults to `false`. |
|
||||
| `test-args` | Multiple strings | Additional arguments to pass during the CTest run. |
|
||||
|
||||
> Note: Multiple strings mean that the input can be specified with more than one value. Separate each value with a space or a new line.
|
||||
|
||||
@ -47,11 +49,17 @@ jobs:
|
||||
build-project:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Check out this repository
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3.3.0
|
||||
|
||||
- name: Configure and build this project
|
||||
- name: Configure the project
|
||||
uses: threeal/cmake-action@latest
|
||||
|
||||
- name: Build the project
|
||||
runs: cmake --build build
|
||||
|
||||
- name: Test the project
|
||||
runs: ctest --test-dir build
|
||||
```
|
||||
|
||||
> Note: You can replace `@latest` with any version you prefer. See [this](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsuses).
|
||||
@ -59,36 +67,28 @@ jobs:
|
||||
#### Specify the Source and Build Directories
|
||||
|
||||
```yaml
|
||||
- name: Configure and build this project
|
||||
- name: Configure the project
|
||||
uses: threeal/cmake-action@latest
|
||||
with:
|
||||
source-dir: submodules
|
||||
build-dir: submodules/out
|
||||
```
|
||||
|
||||
#### Specify the Build Targets
|
||||
#### Configure, Build, and Test in the Same Step
|
||||
|
||||
```yaml
|
||||
- name: Configure and build this project
|
||||
uses: threeal/cmake-action@latest
|
||||
with:
|
||||
targets: hello_mars hello_sun
|
||||
```
|
||||
|
||||
#### Run Unit Tests After Build
|
||||
|
||||
```yaml
|
||||
- name: Configure, build, and test this project
|
||||
- name: Configure, build, and test the project
|
||||
uses: threeal/cmake-action@latest
|
||||
with:
|
||||
args: -DBUILD_TESTING=ON
|
||||
run-build: true
|
||||
run-test: true
|
||||
```
|
||||
|
||||
#### Using Ninja as the Generator and Clang as the Compiler
|
||||
|
||||
```yaml
|
||||
- name: Configure and build this project
|
||||
- name: Configure and build the project
|
||||
uses: threeal/cmake-action@latest
|
||||
with:
|
||||
generator: Ninja
|
||||
|
||||
64
action.yml
64
action.yml
@ -6,38 +6,42 @@ branding:
|
||||
icon: terminal
|
||||
inputs:
|
||||
source-dir:
|
||||
description: Source directory of the CMake project
|
||||
description: The source directory of the CMake project
|
||||
required: false
|
||||
build-dir:
|
||||
description: Build directory of the CMake project
|
||||
description: The build directory of the CMake project
|
||||
required: false
|
||||
targets:
|
||||
description: List of build targets
|
||||
required: false
|
||||
run-test:
|
||||
description: If enabled, run testing using CTest (true/false)
|
||||
required: false
|
||||
default: false
|
||||
generator:
|
||||
description: Build system generator of the CMake project
|
||||
description: The build system generator for the CMake project
|
||||
required: false
|
||||
c-compiler:
|
||||
description: Preferred executable for compiling C language files
|
||||
description: The preferred executable for compiling C language files
|
||||
required: false
|
||||
cxx-compiler:
|
||||
description: Preferred executable for compiling C++ language files
|
||||
description: The preferred executable for compiling C++ language files
|
||||
required: false
|
||||
c-flags:
|
||||
description: Additional flags passed when compiling C language files
|
||||
description: Additional flags to pass when compiling C language files
|
||||
required: false
|
||||
cxx-flags:
|
||||
description: Additional flags passed when compiling C++ language files
|
||||
description: Additional flags to pass when compiling C++ language files
|
||||
required: false
|
||||
args:
|
||||
description: Additional arguments passed during the CMake configuration
|
||||
description: Additional arguments to pass during the CMake configuration
|
||||
required: false
|
||||
run-build:
|
||||
description: If enabled, it builds the project using CMake (true/false)
|
||||
required: false
|
||||
default: false
|
||||
build-args:
|
||||
description: Additional arguments to pass during the CMake build
|
||||
required: false
|
||||
run-test:
|
||||
description: If enabled, it runs testing using CTest (true/false)
|
||||
required: false
|
||||
default: false
|
||||
test-args:
|
||||
description: Additional arguments passed during the CTest run
|
||||
description: Additional arguments to pass during the CTest run
|
||||
required: false
|
||||
runs:
|
||||
using: composite
|
||||
@ -50,21 +54,15 @@ runs:
|
||||
if [ -n '${{ inputs.source-dir }}' ]; then
|
||||
SOURCE_DIR="${{ inputs.source-dir }}"
|
||||
fi
|
||||
|
||||
BUILD_DIR="build"
|
||||
if [ -n '${{ inputs.build-dir }}' ]; then
|
||||
BUILD_DIR="${{ inputs.build-dir }}"
|
||||
elif [ -n "${{ inputs.source-dir }}" ]; then
|
||||
BUILD_DIR="${{ inputs.source-dir }}/build"
|
||||
fi
|
||||
|
||||
ARGS="'$SOURCE_DIR' -B '$BUILD_DIR'"
|
||||
BUILD_ARGS="--build '$BUILD_DIR'"
|
||||
TEST_ARGS=""
|
||||
if [ -n '${{ inputs.targets }}' ]; then
|
||||
BUILD_ARGS="$BUILD_ARGS --target ${{ inputs.targets }}"
|
||||
fi
|
||||
if [ '${{ inputs.run-test }}' == 'true' ]; then
|
||||
TEST_ARGS="--test-dir '$BUILD_DIR' --output-on-failure --no-tests=error"
|
||||
fi
|
||||
if [ -n '${{ inputs.generator }}' ]; then
|
||||
ARGS="$ARGS -G '${{ inputs.generator }}'"
|
||||
fi
|
||||
@ -83,12 +81,23 @@ runs:
|
||||
if [ -n '${{ inputs.args }}' ]; then
|
||||
ARGS="$ARGS ${{ inputs.args }}"
|
||||
fi
|
||||
echo "cmake_args=${ARGS//[$'\t\r\n']}" >> $GITHUB_OUTPUT
|
||||
|
||||
if [ '${{ inputs.run-build }}' == 'true' ] || [ '${{ inputs.run-test }}' == 'true' ]; then
|
||||
BUILD_ARGS="--build '$BUILD_DIR'"
|
||||
if [ -n '${{ inputs.build-args }}' ]; then
|
||||
BUILD_ARGS="$BUILD_ARGS ${{ inputs.build-args }}"
|
||||
fi
|
||||
echo "cmake_build_args=${BUILD_ARGS//[$'\t\r\n']}" >> $GITHUB_OUTPUT
|
||||
fi
|
||||
|
||||
if [ '${{ inputs.run-test }}' == 'true' ]; then
|
||||
TEST_ARGS="--test-dir '$BUILD_DIR' --output-on-failure --no-tests=error"
|
||||
if [ -n '${{ inputs.test-args }}' ]; then
|
||||
TEST_ARGS="$TEST_ARGS ${{ inputs.test-args }}"
|
||||
fi
|
||||
echo "cmake_args=${ARGS//[$'\t\r\n']}" >> $GITHUB_OUTPUT
|
||||
echo "cmake_build_args=${BUILD_ARGS//[$'\t\r\n']}" >> $GITHUB_OUTPUT
|
||||
echo "cmake_test_args=${TEST_ARGS//[$'\t\r\n']}" >> $GITHUB_OUTPUT
|
||||
fi
|
||||
|
||||
- name: Install Ninja
|
||||
if: ${{ inputs.generator == 'Ninja' }}
|
||||
@ -105,10 +114,11 @@ runs:
|
||||
run: cmake ${{ steps.process_inputs.outputs.cmake_args }}
|
||||
|
||||
- name: Build targets
|
||||
if: inputs.run-build != 'false' || inputs.run-test != 'false'
|
||||
shell: ${{ runner.os == 'Windows' && 'pwsh' || 'bash' }}
|
||||
run: cmake ${{ steps.process_inputs.outputs.cmake_build_args }}
|
||||
|
||||
- name: Run tests
|
||||
if: steps.process_inputs.outputs.cmake_test_args != ''
|
||||
if: inputs.run-test != 'false'
|
||||
shell: ${{ runner.os == 'Windows' && 'pwsh' || 'bash' }}
|
||||
run: ctest ${{ steps.process_inputs.outputs.cmake_test_args }}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user