Configuration
PyFunceble provides a set of functionalities that you can influence through configuration. There are multiple way to configure PyFunceble so let's get started
PyFunceble primarily load it's configuration from a file called .PyFunceble.yaml
.
That's the file PyFunceble generate with its default settings. However, you can
overwrite any of the configuration value through a .PyFunceble.overwrite.yaml
file
or the corresponding CLI parameter.
TLTR; Location
Here a table that show the configuration file location - at best efforts. If your installation is not writing at any of the location listed below, please refer to the location documentation page.
If you want to skip and define your own configuration folder, you can define
the storage location of the configuration files through
the PYFUNCEBLE_CONFIG_DIR
environment variable.
OS / Engine | Location |
---|---|
Linux | ~/.config/PyFunceble |
MacOS | ~/.config/PyFunceble |
Windows | %APPDATA%\PyFunceble |
GitHub Actions | Workspace |
GitLab CI/CD | Workspace |
Travis CI | Workspace |
Jenkins CI | Workspace |
At any time, you can provide your own configuration file through the --config-file
CLI argument. If the given argument is a URL, PyFunceble will download it and use it as the configuration file.
Filename-s
At you configuration folder, PyFunceble will automatically create 2 files for you.
.PyFunceble.yaml
, this file is the default configuration file for your current version. Overtime, it will be overwritten and updated as features comes and goes from a version to another. This file is provided to ensure PyFunceble run at all time with a fully compatible configuration file..PyFunceble.overwrite.yaml
, this is generated empty. One generated, PyFunceble will never write into it. That's the file where you put your own configuration choices overwrites.