For information about -config, see the Common Parameters topic. This constraint is because Buck uses the dot character to delimit section names and key names in other contexts such as the -config command-line parameter. These scenarios are examples of when you should be careful not to introduce the dot character in section names. Note that sometimes you might need to define your own custom sections, such as for platform flavors for C++ or Python. For example, the following is not supported- although Buck does not issue a warning or error.

) in section names within Buck configuration files. We do not support the use of the dot character (. Dot character not supported in section names As a result, INI file parsers provided by other languages or libraries are often not able to parse Buck's configuration files successfully. Other INI file parsersĪs mentioned previously, we have extended the INI file parser that Buck uses to parse configuration files. buckconfig implementation supports some modifications to the INI file format these are discussed below. That is, it is divided into sections where each section contains a collection of key names and key values. buckconfig file uses the INI file format. If this occurs, Buck rebuilds those artifacts, which can impact your build time. If your build files are large or you have many build files, this reparsing can impact your build time.Īlso, because configuration settings are sometimes included in the cache keys that Buck uses in its caching system, changes to Buck's configuration can invalidate previously-built artifacts in Buck's caches. If you change the Buck configuration in any of the locations discussed here, it can trigger Buck to reparse your build files the next time you build. Performance impact of Buck configuration changesĬhanges to Buck's configuration can-temporarily-degrade Buck's performance because of how they affect Buck's parsing and caching behavior. Before executing, Buck reads this file to incorporate any customizations it specifies. The root of your project must contain a configuration file named.

Ini file format specification