Compare commits
No commits in common. "a65149a619558b10f1a2ffe54b175c40c4d8b933" and "68f8b02f0a10c12b1ce12539dea800bba1e72977" have entirely different histories.
a65149a619
...
68f8b02f0a
70
README.md
70
README.md
@ -6,7 +6,75 @@ following components:
|
|||||||
|
|
||||||
- Directory Structure
|
- Directory Structure
|
||||||
- Make Build (CMake)
|
- Make Build (CMake)
|
||||||
- CUDA integration
|
|
||||||
- Unit Test Framework (Google Test)
|
- Unit Test Framework (Google Test)
|
||||||
- API Documentation (Doxygen)
|
- API Documentation (Doxygen)
|
||||||
|
|
||||||
|
Feel free to fork this repository and tailor it to suit you.
|
||||||
|
|
||||||
|
## Procedure
|
||||||
|
1. Download Bash script to create new C++ projects
|
||||||
|
```bash
|
||||||
|
curl -O https://raw.githubusercontent.com/TimothyHelton/cpp_project_template/master/new_cpp_project.sh
|
||||||
|
chmod u+x new_cpp_project.sh
|
||||||
|
```
|
||||||
|
1. Create new C++ project
|
||||||
|
```bash
|
||||||
|
./new_cpp_project.sh NewProjectName
|
||||||
|
```
|
||||||
|
1. In the project top level **CMakeLists.txt**:
|
||||||
|
1. Line 2: Change the variable **MyProject** to the name of your project.
|
||||||
|
```cmake
|
||||||
|
project(NewProject)
|
||||||
|
```
|
||||||
|
- This variable will be used in a couple of different places.
|
||||||
|
- MyProject_run: will be the main executable name
|
||||||
|
- MyProject_lib: will be the project library name
|
||||||
|
1. Line 4: Set the version of C++ to use. For example, let's set up the
|
||||||
|
NewProject to use C++ 11.
|
||||||
|
```cmake
|
||||||
|
set(CMAKE_CXX_STANDARD 11)
|
||||||
|
```
|
||||||
|
1. Update project name and description in the `Doxyfile` located in the `docs`
|
||||||
|
directory.
|
||||||
|
1. Update line `PROJECT_NAME`
|
||||||
|
1. This name will appear on each documentation page.
|
||||||
|
1. Update line `PROJECT_NUMBER`
|
||||||
|
1. This is the version number of your project.
|
||||||
|
1. Update line `PROJECT_BRIEF`
|
||||||
|
1. Any text entered here will also appear on each documentation page.
|
||||||
|
Try not to make this one too long.
|
||||||
|
1. Reload the top CMake file.
|
||||||
|
|
||||||
|
## CLION IDE Specific Instructions
|
||||||
|
I started using an IDE from [JET Brains](https://www.jetbrains.com/) tailored
|
||||||
|
for Python called [PyCharm](https://www.jetbrains.com/pycharm/) and thought
|
||||||
|
it helped me write better code.
|
||||||
|
I'd been wanting to learn C++ and decided to give JET Brains C/C++ IDE called
|
||||||
|
[CLion](https://www.jetbrains.com/clion/) a try.
|
||||||
|
The code completion, interactive suggestions, debugger, introspection tools,
|
||||||
|
and built-in test execution are very handy.
|
||||||
|
There are a couple extra details to set when using this IDE.
|
||||||
|
|
||||||
|
1. The IDE allows you to mark directories with their desired purpose.
|
||||||
|
To mark a directory right click on the directory name in the `Project` window
|
||||||
|
and select `Mark Directory as` from the drop-down menu.
|
||||||
|
1. Mark the `src` directory as `Project Sources and Headers`
|
||||||
|
1. Mark the `tests/lib/googletest` directory as `Library Files`
|
||||||
|
1. Setup the `Run/Debug Configuration` by selecting `Edit Configurations...`
|
||||||
|
from the pull-down menu from the run button (green triangle) in the upper right
|
||||||
|
corner.
|
||||||
|
1. Update Doxygen Build to execute the unit test suite.
|
||||||
|
1. Select Doxygen from the Application menu on the left.
|
||||||
|
1. Choose the **executable** for Doxygen to be `Unit_Tests_run`.
|
||||||
|
1. Create a `Google Test` configuration
|
||||||
|
1. In the upper left corner select the plus symbol.
|
||||||
|
1. Chose `Google Test` from the drop-down menu.
|
||||||
|
1. Set **Name** to `Unit Tests`.
|
||||||
|
1. Set **Target** to `Unit_Tests_run`.
|
||||||
|
|
||||||
|
## Wrap Up
|
||||||
|
That should be all it takes to start writing code.
|
||||||
|
If you find any issues or bugs with this repository please file an issue on
|
||||||
|
[GitHub](https://github.com/TimothyHelton/cpp_project_template/issues).
|
||||||
|
|
||||||
|
Hope you find this template useful and enjoy learning C++!
|
33
create_project.sh
Normal file
33
create_project.sh
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
|
# Exit if name argument is not given
|
||||||
|
if [ -z "$*" ]; then
|
||||||
|
echo "A project name argument must be provided."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
NAME=$1
|
||||||
|
|
||||||
|
|
||||||
|
################################################################################
|
||||||
|
|
||||||
|
|
||||||
|
# Clone template repository
|
||||||
|
git clone https://github.com/TimothyHelton/cpp_project_template
|
||||||
|
|
||||||
|
# Create bare repository
|
||||||
|
git --bare init ${NAME}
|
||||||
|
|
||||||
|
# Push template master branch to bare repository
|
||||||
|
cd cpp_project_template
|
||||||
|
git push ../${NAME} +master:master
|
||||||
|
|
||||||
|
# Convert bare repository into a normal repository
|
||||||
|
cd ../${NAME}
|
||||||
|
mkdir .git
|
||||||
|
mv * .git
|
||||||
|
git config --local --bool core.bare false
|
||||||
|
git reset --hard
|
||||||
|
|
||||||
|
# Clean Up
|
||||||
|
rm -rf ../cpp_project_template ../create_project.sh
|
20
new_cpp_project.sh
Normal file
20
new_cpp_project.sh
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
|
# Exit if name argument is not given
|
||||||
|
if [ -z "$*" ]; then
|
||||||
|
echo "A project name argument must be provided."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
NAME=$1
|
||||||
|
|
||||||
|
|
||||||
|
################################################################################
|
||||||
|
|
||||||
|
|
||||||
|
# Download latest version of the build file
|
||||||
|
curl -O https://raw.githubusercontent.com/TimothyHelton/cpp_project_template/master/create_project.sh
|
||||||
|
chmod u+x create_project.sh
|
||||||
|
|
||||||
|
# Create Project
|
||||||
|
./create_project.sh ${NAME}
|
Loading…
x
Reference in New Issue
Block a user