CppProject
is a template for a simple CMake-based C++ project. It can be used as the basis for new projects: remember to change all instances of CppProject
to your new project name. An example CMake module is available to make it easy to include your project in other CMake-based projects (should be customized): FindCppProject.cmake.
Features
- General directory structure common to C++ projects
- Example of CMake module
- Testing framework (Catch)
- Install script (
make install
) - CPack script for packaging (
make package
) - Automatic API documentation (Doxygen)
- Continuous Integration (Travis CI)
- Code coverage analysis (Coveralls) (
make coverage
) - Example of how to include external dependencies (using
ExternalProject
module)
To install this project, please ensure that you have installed the following (install guides are provided on the respective websites):
- Git
- A C++ compiler, e.g., GCC, clang, MinGW
- CMake
- Doxygen (optional)
- Gcov (optional)
- LCOV (optional)
CppProject
does not depend on any libraries. The following library is optional (see Build options
):
- CATCH (unit testing library necessary for
BUILD_TESTS
build option)
This dependency will be downloaded and configured automagically if not already present locally (requires an internet connection).
Run the following commands to download, build, and install this project.
git clone https://www.github.com/kartikkumar/cpp-project
cd cpp-project
git submodule init && git submodule update
mkdir build && cd build
cmake .. && cmake --build .
To install the header files, run the following from within the build
directory:
make install
Note that dependencies are installed by fetching them online, in case they cannot be detected on your local system. If the build process fails, check the error log given. Typically, building fails due to timeout. Simply run the cmake --build .
command once more.
You can pass the following, general command-line options when running CMake:
-DCMAKE_INSTALL_PREFIX[=$install_dir]
: set path prefix for install script (make install
); if not set, defaults to usual locations-DBUILD_SHARED_LIBS=[on|off (default)]
: build shared libraries instead of static-DBUILD_MAIN[=on|off (default)]
: build the main-function-DBUILD_DOXYGEN_DOCS[=ON|OFF (default)]
: build the Doxygen documentation (LaTeX must be installed withamsmath
package)-DBUILD_TESTS[=ON|OFF (default)]
: build tests (execute tests from build-directory usingctest -V
)-DBUILD_DEPENDENCIES[=ON|OFF (default)]
: force local build of dependencies, instead of first searching system-wide usingfind_package()
The following command is conditional and can only be set if BUILD_TESTS = ON
:
-DBUILD_COVERAGE_ANALYSIS[=ON|OFF (default)]
: build code coverage using Gcov and LCOV (both must be installed; requires GCC compiler; execute coverage analysis from build-directory usingmake coverage
)
Pass these options either directly to the cmake ..
build command or run ccmake ..
instead to bring up the interface that can be used to toggle options.
Once you've made your great commits:
- Fork
CppProject
- Create a topic branch -
git checkout -b my_branch
- Push to your branch -
git push origin my_branch
- Create a Pull Request from your branch
- That's it!
The copyright holders are not liable for any damage(s) incurred due to improper use of CppProject
.