clcache | A compiler cache for MSVC , much like ccache for gcc

clcache is a Python library. clcache has no bugs, it has no vulnerabilities, it has build file available and it has low support. However clcache has a Non-SPDX License. You can download it from GitHub.

clcache.py is a little Python script which attempts to avoid unnecessary recompilation by reusing previously cached object files if possible. It is meant to be called instead of the original 'cl.exe' executable. The script analyses the command line to decide whether source code is to be compiled. If so, a cache will be queried for a previously stored object file. If the script is called in an unsupported way (e.g. if the compiler is called for linking), the script will simply relay the invocation to the real 'cl.exe' program. CLCACHE_DIR:: If set, points to the directory within which all the cached object files should be stored. This defaults to %HOME%\clcache CLCACHE_CL:: Can be set to the actual 'cl.exe' executable to use. If this variable is not set, the 'clcache.py' script will scan the directories listed in the +PATH+ environment variable for 'cl.exe'. In case this is just a file name (as opposed to an absolute path), 'clcache.py' will scan the directories mentioned by the %PATH% environment variable to compute the absolute path. CLCACHE_LOG:: If this variable is set, a bit of diagnostic information is printed which can help with debugging cache problems. CLCACHE_DISABLE:: Setting this variable will disable 'clcache.py' completely. The script will relay all calls to the real compiler. CLCACHE_HARDLINK:: If this variable is set, cached object files won't be copied to their final location. Instead, hard links pointing to the cached object files will be created. This is more efficient (faster, and uses less disk space) but doesn't work if the cache directory is on a different drive than the build directory. CLCACHE_COMPRESS:: If true, clcache will compress object files it puts in the cache. If the cache was filled without compression it can't be used with compression and vice versa (i.e. you have to clear the cache when changing this setting). The default is false. CLCACHE_COMPRESSLEVEL:: This setting determines the level at which clcache will compress object files. It only has effect if compression is enabled. The value defaults to 6, and must be no lower than 1 (fastest, worst compression) and no higher than 9 (slowest, best compression). CLCACHE_NODIRECT:: Disable direct mode. If this variable is set, clcache will always run preprocessor on source file and will hash preprocessor output to get cache key. Use this if you experience problems with direct mode or if you need built-in macros like _TIME_ to work correctly. CLCACHE_BASEDIR:: Has effect only when direct mode is on. Set this to path to root directory of your project. This allows clcache to cache relative paths, so if you move your project to different directory, clcache will produce cache hits as before. CLCACHE_OBJECT_CACHE_TIMEOUT_MS:: Overrides the default ObjectCacheLock timeout (Default is 10 * 1000 ms). The ObjectCacheLock is used to give exclusive access to the cache, which is used by the clcache script. You may override this variable if you are getting ObjectCacheLockExceptions with return code 258 (which is the WAIT_TIMEOUT return code). CLCACHE_PROFILE:: If this variable is set, clcache will generate profiling information about how the runtime is spent in the clcache code. For each invocation, clcache will generate a file with a name similar to 'clcache- .prof'. You can aggregate these files and generate a report by running the 'showprofilereport.py' script. CLCACHE_SERVER:: Setting this environment variable will make clcache use (and expect) a running clcachesrv.py script which takes care of caching file hashes. This greatly improves performance of cache hits, but only has an effect in direct mode (i.e. when CLCACHE_NODIRECT is not set). CLCACHE_MEMCACHED:: This variable can be used to make clcache use a memcached[backend for saving and restoring cached data. The variable is assumed to hold the host and port information of the memcached server, e.g. 127.0.0.1:11211.