vcpkg/scripts/cmake/vcpkg_minimum_required.cmake

#[===[.md:
# vcpkg_minimum_required

Asserts that the version of the vcpkg program being used to build a port is later than the supplied date, inclusive.

## Usage
```cmake
vcpkg_minimum_required(VERSION 2021-01-13)
```

## Parameters
### VERSION
The date-version to check against.
#]===]

function(vcpkg_minimum_required)
    cmake_parse_arguments(PARSE_ARGV 0 arg "" "VERSION" "")
    if(NOT DEFINED VCPKG_BASE_VERSION)
        message(FATAL_ERROR "Your vcpkg executable is outdated and is not compatible with the current CMake scripts.
    Please re-acquire vcpkg by running bootstrap-vcpkg."
        )
    endif()
    if(NOT DEFINED arg_VERSION)
        message(FATAL_ERROR "VERSION must be specified")
    endif()

    set(vcpkg_date_regex "^[12][0-9][0-9][0-9]-[01][0-9]-[0-3][0-9]$")
    if(NOT "${VCPKG_BASE_VERSION}" MATCHES "${vcpkg_date_regex}")
        message(FATAL_ERROR
            "vcpkg internal failure; VCPKG_BASE_VERSION (${VCPKG_BASE_VERSION}) was not a valid date."
        )
    endif()

    if(NOT "${arg_VERSION}" MATCHES "${vcpkg_date_regex}")
        message(FATAL_ERROR
            "VERSION (${arg_VERSION}) was not a valid date - expected something of the form 'YYYY-MM-DD'"
        )
    endif()

    string(REPLACE "-" "." VCPKG_BASE_VERSION_as_dotted "${VCPKG_BASE_VERSION}")
    string(REPLACE "-" "." arg_VERSION_as_dotted "${arg_VERSION}")

    if("${VCPKG_BASE_VERSION_as_dotted}" VERSION_LESS "${arg_VERSION_as_dotted}")
        message(FATAL_ERROR
            "Your vcpkg executable is from ${VCPKG_BASE_VERSION} which is older than required by the caller "
            "of vcpkg_minimum_required(VERSION ${arg_VERSION}). "
            "Please re-acquire vcpkg by running bootstrap-vcpkg."
        )
    endif()
endfunction()