Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document meta-merge behavior of config #184

Closed
plexus opened this issue Dec 10, 2020 · 0 comments · Fixed by #192
Closed

Document meta-merge behavior of config #184

plexus opened this issue Dec 10, 2020 · 0 comments · Fixed by #192
Assignees
Labels
documentation An issue or improvement related to documentation

Comments

@plexus
Copy link
Member

plexus commented Dec 10, 2020

When processing the #kaocha/v1 reader macro we merge the user's config into the default config using meta-merge. This means that you can add ^:prepend, :^append, and ^:replace metadata to influence how the merging should happen.

For example, user-configured plugins are added onto the list of default plugins [:kaocha.plugin/randomize :kaocha.plugin/filter :kaocha.plugin/capture-output], rather than replacing them. If you want to use a different variant of the filter plugin then you could use :plugins ^:replace [...] instead.

We do mention meta-merge in the docs, but only when used explicitly with a #meta-merge reader tag. There's also one example of a ^:replace in the cucumber test/doc for filter, but presented without much comment.

@alysbrooks alysbrooks linked a pull request Jan 25, 2021 that will close this issue
2 tasks
@alysbrooks alysbrooks added the documentation An issue or improvement related to documentation label Jan 28, 2021
@alysbrooks alysbrooks self-assigned this Jan 28, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation An issue or improvement related to documentation
Projects
Status: Done
Development

Successfully merging a pull request may close this issue.

2 participants