module documentation

Provides the CCompilerOpt class, used for handling the CPU/hardware optimization, starting from parsing the command arguments, to managing the relation between the CPU baseline and dispatch-able features, also generating the required C headers and ending with compiling the sources with proper compiler's flags.

CCompilerOpt doesn't provide runtime detection for the CPU features, instead only focuses on the compiler side, but it creates abstract C headers that can be used later for the final runtime dispatching process.

Class ​CCompiler​Opt A helper class for CCompiler aims to provide extra build options to effectively control of compiler optimizations that are directly related to CPU features.
Function new​_ccompiler​_opt Create a new instance of 'CCompilerOpt' and generate the dispatch header which contains the #definitions and headers of platform-specific instruction-sets for the enabled CPU baseline and dispatch-able features.
Class _​Cache An abstract class handles caching functionality, provides two levels of caching, in-memory by share instances attributes among each other and by store attributes into files.
Class _​CCompiler A helper class for CCompilerOpt containing all utilities that related to the fundamental compiler's functions.
Class _​Config An abstract class holds all configurable attributes of CCompilerOpt, these class attributes can be used to change the default behavior of CCompilerOpt in order to fit other requirements.
Class _​Distutils A helper class that provides a collection of fundamental methods implemented in a top of Python and NumPy Distutils.
Class _​Feature A helper class for CCompilerOpt that managing CPU features.
Class _​Parse A helper class that parsing main arguments of CCompilerOpt, also parsing configuration statements in dispatch-able sources.
Variable ​_share​_cache Undocumented
def new_ccompiler_opt(compiler, dispatch_hpath, **kwargs):

Create a new instance of 'CCompilerOpt' and generate the dispatch header which contains the #definitions and headers of platform-specific instruction-sets for the enabled CPU baseline and dispatch-able features.

Parameters

compiler : CCompiler instance dispatch_hpath : str

path of the dispatch header

**kwargs: passed as-is to CCompilerOpt(...) Returns ------- new instance of CCompilerOpt

_share_cache: dict =

Undocumented