feat: Adds conan support via a conan 2.0 recipe

CMakeLists.txt

@@ -55,6 +55,12 @@ else()
 	message("-- INFO: Using VCPKG if detected")
 endif()
 
+if (DPP_NO_CONAN)
+	message("-- INFO: Explicitly disabling Conan as running inside the CI action.")
+else()
+	message("-- INFO: Using Conan if detected")
+endif()
+
 if (WIN32 AND NOT MINGW AND BUILD_SHARED_LIBS)
 	message("-- INFO: Configuring .rc resource script")
 	configure_file("${DPP_ROOT_PATH}/src/dpp/dpp.rc.in" "${DPP_ROOT_PATH}/src/dpp/dpp.rc" NEWLINE_STYLE WIN32)
@@ -99,7 +105,11 @@ else()
 		enable_testing(${CMAKE_CURRENT_SOURCE_DIR})
 	endif()
 
-	add_subdirectory(library)
+	if(CONAN_EXPORTED AND NOT DPP_NO_CONAN)
+		add_subdirectory(library-conan)
+	else()
+		add_subdirectory(library)
+	endif()
 endif()
 
 if(DPP_USE_EXTERNAL_JSON)

docpages/install/install-conan.md

@@ -0,0 +1,52 @@
+\page install-conan Installing with Conan 2.0
+
+To install D++ into a project using conan 2.0 and cmake:
+
+- Ensure conan is correctly installed the most popular method is with pip.
+- Create a conanfile.txt in the root of the project.
+
+```conanfile.txt
+[requires]
+dpp/0.1
+
+[generators]
+CMakeDeps
+CMakeToolchain
+```
+
+- You may now use the library within a `CMake` based project by adding instructions such as these to your `CMakeLists.txt`:
+
+```cmake
+set(CMAKE_PREFIX_PATH  "${CMAKE_CURRENT_LIST_DIR}/build")
+find_package(dpp CONFIG REQUIRED)
+target_link_libraries(${PROJECT_NAME} dpp::dpp)
+```
+
+- If you recieve any errors about CXX version you may need to set it
+
+```
+set(CMAKE_CXX_STANDARD 17)
+```
+
+- You will then also want to set your build type to match what you will be using in conan(Debug or Release)
+
+```
+set(CMAKE_BUILD_TYPE Debug)
+```
+
+OR
+
+```
+set(CMAKE_BUILD_TYPE Release)
+```
+
+- Now run the following commands
+
+```
+mkdir build && cd build
+conan install .. --build=missing -of=. -s build_type=Release
+cmake ..
+make
+```
+
+- NOTE: build_type= needs to match whatever was set in your CMake or you will get linker issues.