based

Opinionated utility library

git clone git://git.dimitrijedobrota.com/based.git

docs-ci.cmake (3351B)

1 cmake_minimum_required(VERSION 3.14) 2 3 foreach(var IN ITEMS PROJECT_BINARY_DIR PROJECT_SOURCE_DIR) 4 if(NOT DEFINED "${var}") 5 message(FATAL_ERROR "${var} must be defined") 6 endif() 7 endforeach() 8 set(bin "${PROJECT_BINARY_DIR}") 9 set(src "${PROJECT_SOURCE_DIR}") 10 11 # ---- Dependencies ---- 12 13 set(mcss_SOURCE_DIR "${bin}/docs/.ci") 14 if(NOT IS_DIRECTORY "${mcss_SOURCE_DIR}") 15 file(MAKE_DIRECTORY "${mcss_SOURCE_DIR}") 16 file( 17 DOWNLOAD 18 https://github.com/friendlyanon/m.css/releases/download/release-1/mcss.zip 19 "${mcss_SOURCE_DIR}/mcss.zip" 20 STATUS status 21 EXPECTED_MD5 00cd2757ebafb9bcba7f5d399b3bec7f 22 ) 23 if(NOT status MATCHES "^0;") 24 message(FATAL_ERROR "Download failed with ${status}") 25 endif() 26 execute_process( 27 COMMAND "${CMAKE_COMMAND}" -E tar xf mcss.zip 28 WORKING_DIRECTORY "${mcss_SOURCE_DIR}" 29 RESULT_VARIABLE result 30 ) 31 if(NOT result EQUAL "0") 32 message(FATAL_ERROR "Extraction failed with ${result}") 33 endif() 34 file(REMOVE "${mcss_SOURCE_DIR}/mcss.zip") 35 endif() 36 37 find_program(Python3_EXECUTABLE NAMES python3 python) 38 if(NOT Python3_EXECUTABLE) 39 message(FATAL_ERROR "Python executable was not found") 40 endif() 41 42 # ---- Process project() call in CMakeLists.txt ---- 43 44 file(READ "${src}/CMakeLists.txt" content) 45 46 string(FIND "${content}" "project(" index) 47 if(index EQUAL "-1") 48 message(FATAL_ERROR "Could not find \"project(\"") 49 endif() 50 string(SUBSTRING "${content}" "${index}" -1 content) 51 52 string(FIND "${content}" "\n)\n" index) 53 if(index EQUAL "-1") 54 message(FATAL_ERROR "Could not find \"\\n)\\n\"") 55 endif() 56 string(SUBSTRING "${content}" 0 "${index}" content) 57 58 file(WRITE "${bin}/docs-ci.project.cmake" "docs_${content}\n)\n") 59 60 macro(list_pop_front list out) 61 list(GET "${list}" 0 "${out}") 62 list(REMOVE_AT "${list}" 0) 63 endmacro() 64 65 function(docs_project name) 66 cmake_parse_arguments(PARSE_ARGV 1 "" "" "VERSION;DESCRIPTION;HOMEPAGE_URL" LANGUAGES) 67 set(PROJECT_NAME "${name}" PARENT_SCOPE) 68 if(DEFINED _VERSION) 69 set(PROJECT_VERSION "${_VERSION}" PARENT_SCOPE) 70 string(REGEX MATCH "^[0-9]+(\\.[0-9]+)*" versions "${_VERSION}") 71 string(REPLACE . ";" versions "${versions}") 72 set(suffixes MAJOR MINOR PATCH TWEAK) 73 while(NOT versions STREQUAL "" AND NOT suffixes STREQUAL "") 74 list_pop_front(versions version) 75 list_pop_front(suffixes suffix) 76 set("PROJECT_VERSION_${suffix}" "${version}" PARENT_SCOPE) 77 endwhile() 78 endif() 79 if(DEFINED _DESCRIPTION) 80 set(PROJECT_DESCRIPTION "${_DESCRIPTION}" PARENT_SCOPE) 81 endif() 82 if(DEFINED _HOMEPAGE_URL) 83 set(PROJECT_HOMEPAGE_URL "${_HOMEPAGE_URL}" PARENT_SCOPE) 84 endif() 85 endfunction() 86 87 include("${bin}/docs-ci.project.cmake") 88 89 # ---- Generate docs ---- 90 91 if(NOT DEFINED DOXYGEN_OUTPUT_DIRECTORY) 92 set(DOXYGEN_OUTPUT_DIRECTORY "${bin}/docs") 93 endif() 94 set(out "${DOXYGEN_OUTPUT_DIRECTORY}") 95 96 foreach(file IN ITEMS Doxyfile conf.py) 97 configure_file("${src}/docs/${file}.in" "${bin}/docs/${file}" @ONLY) 98 endforeach() 99 100 set(mcss_script "${mcss_SOURCE_DIR}/documentation/doxygen.py") 101 set(config "${bin}/docs/conf.py") 102 103 file(REMOVE_RECURSE "${out}/html" "${out}/xml") 104 105 execute_process( 106 COMMAND "${Python3_EXECUTABLE}" "${mcss_script}" "${config}" 107 WORKING_DIRECTORY "${bin}/docs" 108 RESULT_VARIABLE result 109 ) 110 if(NOT result EQUAL "0") 111 message(FATAL_ERROR "m.css returned with ${result}") 112 endif()