cargo-mutants icon indicating copy to clipboard operation
cargo-mutants copied to clipboard

Conflicting documentation about how args and config settings are merged

Open sandersaares opened this issue 5 months ago • 1 comments

Merging config and command-line options says "For options that take a list of values, values from the configuration file are appended to values from the command line".

Configuring filters by filename says "From cargo-mutants 23.11.2 onwards, if the command line options are given then the corresponding config file option is ignored".

These two statements are mutually conflicting - is the exclude_glob pattern merged or replaced? In reality, the documentation page saying it is replaced is correct, so the other should be adjusted accordingly.

sandersaares avatar Jul 12 '25 18:07 sandersaares

Currently, exclude_glob (and other exclusion options) override the config file rather than appending to it, inconsistently with other options. This was intentional but I'm no longer sure it's a good idea, both because it complicates the general rule and for the reasons you describe in #527.

sourcefrog avatar Jul 13 '25 18:07 sourcefrog