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

Mention the regex sensitivity of commit_filter strings #385

Merged
merged 1 commit into from
Jun 6, 2022
Merged

Mention the regex sensitivity of commit_filter strings #385

merged 1 commit into from
Jun 6, 2022

Conversation

jgriff
Copy link
Contributor

@jgriff jgriff commented Jun 3, 2022

Polished the README to note that the commit_filter option is
sensitive to regex characters. This was not immediately obvious and can
cause a bit of confusion. Even leading to suspecting a defect in the
implementation of the filter as it can send the resource into a whacky
state of not selecting any commits (since the filter expression would
then be malformed).

Updated the README to mention this, and give an example of configuring
the commit_filter.exclude with a bracketed string that escapes the
bracket characters.

  commit_filter:
    exclude: ["\\[skip deploy\\]", "\\[deploy skip\\]"]

Lastly, also fixed a typo and removed the fully qualified dot notation
when describing the sub-elements of commit_filter in the README.

was:

  commit_filter:
    commit_filter.exclude:
    commit_filter_include:

now:

  commit_filter:
    exclude:
    include:

This aligns with the convention used in all other configuration options.

Only the README was changed in this commit.

Polished the README to note that the `commit_filter` option is
sensitive to regex characters.  This was not immediately obvious and can
cause a bit of confusion.  Even leading to suspecting a defect in the
implementation of the filter as it can send the resource into a whacky
state of not selecting any commits (since the filter expression would
then be malformed).

Updated the README to mention this, and give an example of configuring
the `commit_filter.exclude` with a bracketed string that escapes the
bracket characters.

  commit_filter:
    exclude: ["\\[skip deploy\\]", "\\[deploy skip\\]"]

Lastly, also fixed a typo and removed the fully qualified dot notation
when describing the sub-elements of `commit_filter` in the README.

was:

  commit_filter:
    commit_filter.exclude:
    commit_filter_include:

now:

  commit_filter:
    exclude:
    include:

This aligns with the convention used in all other configuration options.

Only the README was changed in this commit.

Signed-off-by: Justin Griffin <[email protected]>
@xtremerui xtremerui self-assigned this Jun 6, 2022
Copy link
Contributor

@xtremerui xtremerui left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thank you for the PR!

@xtremerui xtremerui merged commit 6b4aba7 into concourse:master Jun 6, 2022
@jgriff jgriff deleted the commit-filter-doc-update branch June 6, 2022 16:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants