Function check_api_version

numpy/core/setup_common.py:84–105

Emits a MismatchCAPIWarning if the C API version needs updating.

(apiversion, codegen_dir)

    return curapi_hash, apis_hash[apiversion]

def check_api_version(apiversion, codegen_dir):
    """Emits a MismatchCAPIWarning if the C API version needs updating."""
    curapi_hash, api_hash = get_api_versions(apiversion, codegen_dir)

    # If different hash, it means that the api .txt files in
    # codegen_dir have been updated without the API version being
    # updated. Any modification in those .txt files should be reflected
    # in the api and eventually abi versions.
    # To compute the checksum of the current API, use numpy/core/cversions.py
    if not curapi_hash == api_hash:
        msg = ("API mismatch detected, the C API version "
               "numbers have to be updated. Current C api version is "
               f"{apiversion}, with checksum {curapi_hash}, but recorded "
               f"checksum in core/codegen_dir/cversions.txt is {api_hash}. If "
               "functions were added in the C API, you have to update "
               f"C_API_VERSION in {__file__}."
               "\n"
               "Please make sure that new additions are guarded with "
               "MinVersion() to make them unavailable when wishing support "
               "for older NumPy versions."
               )
        raise MismatchCAPIError(msg)


FUNC_CALL_ARGS = {}