B br@sdZddlZdZdZd*ddZddZdd Zd d Zd d Zd+ddZ d,ddZ d-ddZ d.ddZ d/ddZ d0ddZd1ddZd2ddZd d!Zd3d"d#Zd4d$d%Zd&d'Zd(d)ZdS)5a Autoconf-like configuration support The purpose of this module is to define how a check is to be performed. A context class is used that defines functions for carrying out the tests, logging and messages. The following methods and members must be present: context.Display(msg) Function called to print messages that are normally displayed for the user. Newlines are explicitly used. The text should also be written to the logfile! context.Log(msg) Function called to write to a log file. context.BuildProg(text, ext) Function called to build a program, using "ext" for the file extension. Must return an empty string for success, an error message for failure. For reliable test results building should be done just like an actual program would be build, using the same command and arguments (including configure results so far). context.CompileProg(text, ext) Function called to compile a program, using "ext" for the file extension. Must return an empty string for success, an error message for failure. For reliable test results compiling should be done just like an actual source file would be compiled, using the same command and arguments (including configure results so far). context.AppendLIBS(lib_name_list) Append "lib_name_list" to the value of LIBS. "lib_namelist" is a list of strings. Return the value of LIBS before changing it (any type can be used, it is passed to SetLIBS() later.) context.PrependLIBS(lib_name_list) Prepend "lib_name_list" to the value of LIBS. "lib_namelist" is a list of strings. Return the value of LIBS before changing it (any type can be used, it is passed to SetLIBS() later.) context.SetLIBS(value) Set LIBS to "value". The type of "value" is what AppendLIBS() returned. Return the value of LIBS before changing it (any type can be used, it is passed to SetLIBS() later.) context.headerfilename Name of file to append configure results to, usually "confdefs.h". The file must not exist or be empty when starting. Empty or None to skip this (some tests will not work!). context.config_h (may be missing). If present, must be a string, which will be filled with the contents of a config_h file. context.vardict Dictionary holding variables used for the tests and stores results from the tests, used for the build commands. Normally contains "CC", "LIBS", "CPPFLAGS", etc. context.havedict Dictionary holding results from the tests that are to be used inside a program. Names often start with "HAVE\_". These are zero (feature not present) or one (feature present). Other variables may have any value, e.g., "PERLVERSION" can be a number and "SYSTEMNAME" a string. NcCsXt|\}}}|r$|d||S|s,d}|d||||}t||d||S)a Configure check to see if the compiler works. Note that this uses the current value of compiler and linker flags, make sure $CFLAGS, $CPPFLAGS and $LIBS are set correctly. "language" should be "C" or "C++" and is used to select the compiler. Default is "C". "text" may be used to specify the code to be build. Returns an empty string for success, an error message for failure. z%s z" int main(void) { return 0; } z(Checking if building a %s file works... N) _lang2suffixDisplay BuildProg _YesNoResult)contexttextlanguagelangsuffixmsgretr-lib/python3.7/site-packages/SCons/Conftest.py CheckBuilderos  rcCs.|dd}t|d|d}t||d||S)a Configure check for a working C compiler. This checks whether the C compiler, as defined in the $CC construction variable, can compile a C source file. It uses the current $CCCOM value too, so that it can test against non working flags. z)Checking whether the C compiler works... z" int main(void) { return 0; } ZCCCN)r_check_empty_programr)rrr rrrCheckCCs rcCs2|dd}t|d|ddd}t||d||S)a Configure check for a working shared C compiler. This checks whether the C compiler, as defined in the $SHCC construction variable, can compile a C source file. It uses the current $SHCCCOM value too, so that it can test against non working flags. z2Checking whether the (shared) C compiler works... z! int foo(void) { return 0; } ZSHCCrT) use_sharedN)rrr)rrr rrr CheckSHCCs rcCs.|dd}t|d|d}t||d||S)a  Configure check for a working CXX compiler. This checks whether the CXX compiler, as defined in the $CXX construction variable, can compile a CXX source file. It uses the current $CXXCOM value too, so that it can test against non working flags. z+Checking whether the C++ compiler works... z" int main(void) { return 0; } CXXzC++N)rrr)rrr rrrCheckCXXs rcCs2|dd}t|d|ddd}t||d||S)a Configure check for a working shared CXX compiler. This checks whether the CXX compiler, as defined in the $SHCXX construction variable, can compile a CXX source file. It uses the current $SHCXXCOM value too, so that it can test against non working flags. z4Checking whether the (shared) C++ compiler works... z" int main(void) { return 0; } ZSHCXXzC++T)rN)rrr)rrr rrr CheckSHCXXs rFcCsN||jks|j|sdSt|\}}}|r.dS|r>|||S|||SdS)z!Return 0 on success, 1 otherwise.rN)envrZCompileSharedObject CompileProg)rcomprr rr r r rrrrs rc Cs|jrd|j}nd}|s"d|}t|\}}}|rJ|d||f|Sd|||d}|d||f|||} t|| d||d || S) a7 Configure check for a function "function_name". "language" should be "C" or "C++" and is used to select the compiler. Default is "C". Optional "header" can be defined to define a function prototype, include a header file or anything else that comes before main(). Sets HAVE_function_name in context.havedict according to the result. Note that this uses the current value of compiler and linker flags, make sure $CFLAGS, $CPPFLAGS and $LIBS are set correctly. Returns an empty string for success, an error message for failure. z #include "%s"z0 #ifdef __cplusplus extern "C" #endif char %s();zCannot check for %s(): %s z %(include)s #include %(hdr)s #if _MSC_VER && !__INTEL_COMPILER #pragma function(%(name)s) #endif int main(void) { #if defined (__stub_%(name)s) || defined (__stub___%(name)s) fail fail fail #else %(name)s(); #endif return 0; } )nameincludeZhdrz!Checking for %s function %s()... HAVE_z0Define to 1 if the system has the function `%s'.)headerfilenamerrrr) rZ function_nameheaderr includetextr r r rr rrr CheckFuncs$   r#c Cs|jrd|j}nd}|sd}t|\}}}|rF|d||f|S|sNd}d|||d||df} |d||f|| |} t|| d || d || S) a. Configure check for a C or C++ header file "header_name". Optional "header" can be defined to do something before including the header file (unusual, supported for consistency). "language" should be "C" or "C++" and is used to select the compiler. Default is "C". Sets HAVE_header_name in context.havedict according to the result. Note that this uses the current value of compiler and linker flags, make sure $CFLAGS and $CPPFLAGS are set correctly. Returns an empty string for success, an error message for failure. z#include "%s" rz$Cannot check for header file %s: %s z<>z%s%s #include %s%s%s rrz"Checking for %s header file %s... rz-Define to 1 if you have the <%s> header file.)r rrrr) rZ header_namer!r Zinclude_quotesr"r r r rr rrr CheckHeader3s&    r$c Cs|jrd|j}nd}|sd}t|\}}}|rF|d||f|Sd|||d} |d||f|| |} t|| d|| d|| r|r|jrt|jd } | d ||f| | S) a Configure check for a C or C++ type "type_name". Optional "header" can be defined to include a header file. "language" should be "C" or "C++" and is used to select the compiler. Default is "C". Sets HAVE_type_name in context.havedict according to the result. Note that this uses the current value of compiler and linker flags, make sure $CFLAGS, $CPPFLAGS and $LIBS are set correctly. Returns an empty string for success, an error message for failure. z #include "%s"rzCannot check for %s type: %s zw %(include)s %(header)s int main(void) { if ((%(name)s *) 0) return 0; if (sizeof (%(name)s)) return 0; } )rr!rzChecking for %s type %s... rz,Define to 1 if the system has the type `%s'.aztypedef %s %s; )r rrrropenwriteclose) r type_nameZfallbackr!r r"r r r rr frrr CheckTypecs*     r+c Csj|jrd|j}nd}|sd}t|\}}}|rF|d||f|S||} |dk r|d||f| d} || ||f|} | s|dt|d||d ||S|d t|| | d Sn|d || d |d} || |\} } y t| } Wnt k r d} d } YnX| sL|dt|d|| d || S|d t|| | d Sd S)azThis check can be used to get the size of a given type, or to check whether the type is of expected size. Arguments: - type : str the type to check - includes : sequence list of headers to include in the test code before testing the type - language : str 'C' or 'C++' - expect : int if given, will test wether the type has the given number of bytes. If not given, will automatically find the size. Returns: status : int 0 if the check failed, or the found size of the type if the check succeeded.z #include "%s"rzCannot check for %s type: %s NzChecking %s is %d bytes... z typedef %s scons_check_type; int main(void) { static int test_array[1 - 2 * !(((long int) (sizeof(scons_check_type))) == %d)]; test_array[0] = 0; return 0; } zyes z SIZEOF_%sz(The size of `%s', as computed by sizeof.zno rzChecking size of %s ... zV #include #include int main(void) { printf("%d", (int)sizeof(z)); return 0; } r) r rrr_Have _LogFailedZMessageZRunProgint ValueError) rr)r!r Zexpectr"r r r srcstoutsizerrr CheckTypeSizesR               r4c Cs|jrd|j}nd}|sd}t|\}}}|rF|d||f|S||}|d||d||f}|||} t|| d||d|| S)aChecks whether symbol is declared. Use the same test as autoconf, that is test whether the symbol is defined as a macro or can be used as an r-value. Arguments: symbol : str the symbol to check includes : str Optional "header" can be defined to include a header file. language : str only C and C++ supported. Returns: status : bool True if the check failed, False if succeeded.z #include "%s"rz$Cannot check for declaration %s: %s z#Checking whether %s is declared... zI int main(void) { #ifndef %s (void) %s; #endif ; return 0; } Z HAVE_DECL_zSet to 1 if %s is defined.)r rrrr) rZsymbolZincludesr r"r r r r0r1rrrCheckDeclarations"    r5c Cst|\}}}|r(|d||fdS|d||f|d}t|dkrjd}|d||fdS|d|d}} |jrd |j} nd } |sd }d | ||| d } || |} t|| d || d|| S)a Configure check for a C or C++ member "aggregate_member". Optional "header" can be defined to include a header file. "language" should be "C" or "C++" and is used to select the compiler. Default is "C". Note that this uses the current value of compiler and linker flags, make sure $CFLAGS, $CPPFLAGS and $LIBS are set correctly. Arguments: aggregate_member : str the member to check. For example, 'struct tm.tm_gmtoff'. includes : str Optional "header" can be defined to include a header file. language : str only C and C++ supported. Returns the status (0 or False = Passed, True/non-zero = Failed). zCannot check for member %s: %s TzChecking for %s member %s... .z=shall contain just one dot, for example 'struct tm.tm_gmtoff'rrz #include "%s"rzi %(include)s %(header)s int main(void) { if (sizeof ((%(aggregate)s *) 0)->%(member)s) return 0; })rr! aggregatememberrz.Define to 1 if the system has the member `%s`.)rrsplitlenr rr) rZaggregate_memberr!r r r r Zfieldsr8r9r"rr rrr CheckMember<s0      r<Tc Cs|jrd|j} nd} |sd}d| |f} |rR|dkrR|sF| d|} |sRd|}| d|p\d} |r|d} | d kr|d | d } n|d d kr|d d } n|} x|D]} t|\}}}|r|d| |f|S|r|d| || fn|d|| f| rH| g}|r"|||r4||}n ||}d| }nd }d }|| |}t|||| d| |d kr|s|s| ||s|SqW|S)ai Configure check for a C or C++ libraries "libs". Searches through the list of libraries, until one is found where the test succeeds. Tests if "func_name" or "call" exists in the library. Note: if it exists in another library the test succeeds anyway! Optional "header" can be defined to include a header file. If not given a default prototype for "func_name" is added. Optional "extra_libs" is a list of library names to be added after "lib_name" in the build command. To be used for libraries that "lib_name" depends on. Optional "call" replaces the call to "func_name" in the test code. It must consist of complete C statements, including a trailing ";". Both "func_name" and "call" arguments are optional, and in that case, just linking against the libs is tested. "language" should be "C" or "C++" and is used to select the compiler. Default is "C". Note that this uses the current value of compiler and linker flags, make sure $CFLAGS, $CPPFLAGS and $LIBS are set correctly. Returns an empty string for success, an error message for failure. z #include "%s"rz %s %smainz1 #ifdef __cplusplus extern "C" #endif char %s(); z%s();z int main() { %s return 0; }  rNz..;z Cannot check for library %s: %s z$Checking for %s in %s library %s... zChecking for %s library %s... ZHAVE_LIBz)Define to 1 if you have the `%s' library.) r findrrextendZ AppendLIBSZ PrependLIBSrrZSetLIBS)rZlibsZ func_namer!Z extra_libsZcallr Zautoaddappendr"riZcalltextZlib_namer r r lZoldLIBSZsymr rrrCheckLibtsb                rFcCs<|d||j|}|r.||dn |d|S)z Configure check for a specific program. Check whether program prog_name exists in path. If it is found, returns the path for it, otherwise returns None. z%Checking whether %s program exists...r>zno )rrZWhereIs)rZ prog_namepathrrr CheckProgs   rHcCs>|rt||| ||r0|dt|||n |ddS)a Handle the result of a test with a "yes" or "no" result. :Parameters: - `ret` is the return value: empty if OK, error message when not. - `key` is the name of the symbol to be defined (HAVE_foo). - `text` is the source code of the program used for testing. - `comment` is the C comment to add above the line defining the symbol (the comment is automatically put inside a /\* \*/). If None, no comment is added. zno zyes N)r,rr-)rr keyrcommentrrrrs  rcCs|}tdd|}||j|<|dkr2d|}n:|dkrDd|}n(t|tr\d||f}nd|t|f}|d k rd ||}nd |}|jrt|jd }| || nt |d r|j ||_ d S)a Store result of a test in context.havedict and context.headerfilename. :Parameters: - `key` - is a "HAVE_abc" name. It is turned into all CAPITALS and non-alphanumerics are replaced by an underscore. - `have` - value as it should appear in the header file, include quotes when desired and escape special characters! - `comment` is the C comment to add above the line defining the symbol (the comment is automatically put inside a /\* \*/). If None, no comment is added. The value of "have" can be: - 1 - Feature is defined, add "#define key". - 0 - Feature is not defined, add "/\* #undef key \*/". Adding "undef" is what autoconf does. Not useful for the compiler, but it shows that the test was done. - number - Feature is defined to this number "#define key have". Doesn't work for 0 or 1, use a string then. - string - Feature is defined to this string "#define key have". z [^A-Z0-9_]_rz #define %s 1 rz/* #undef %s */ z#define %s %d z#define %s %s Nz /* %s */ r>r%config_h) upperresubZhavedict isinstancer.strr r&r'r(hasattrrL)rrIZhaverJZkey_uplinelinesr*rrrr,s&        r,cCsztrd|d|d}t|r8|ddkr8|dd}d}x&|D]}|d||f|d}qBWtrv|d|dS) zr Write to the log about a failed program. Add line numbers, so that error messages can be understood. zFailed program was: r>r?rNrz%d: %s zError message: %s ) LogInputFilesZLogr:r;LogErrorMessages)rrr rTnrSrrrr-2s     r-cCs*|r |dkrdS|dkrdSddd|fS)aa Convert a language name to a suffix. When "lang" is empty or None C is assumed. Returns a tuple (lang, suffix, None) when it works. For an unrecognized language returns (None, None, msg). Where: - lang = the unified language name - suffix = the suffix, including the leading dot - msg = an error message )rc)rz.cN)zc++zC++ZcpprZcxx)zC++z.cppNNzUnsupported language: %sr)r rrrrDs r)NN)F)NN)NNN)NNN)NNN)NN)NN)NNNNNrT)N)N)__doc__rNrUrVrrrrrrr#r$r+r4r5r<rFrHrr,r-rrrrrZs2   I / = g 4 8 j  +