Callback to be used for filtering tag names before formatting and template substitution.
This option is completely ignored if Read some file content as current version schema is used.
This is because all tags are set on
so commits to other branches like
develop are tagless.
This option is completely ignored if Execute some callback function to get current version schema is used, because git commit history is not fetched in such a case.
Set when multiple products are tagged in a single repo.
If, for example, your repo has:
and you only want versions from
product_y, simply set:
tag_filter = "product_y/(?P<tag>.*)"
This will limit the tags considered to those that start with
You will likely still need to construct a tag_formatter that
extract version number from a tag. To make thing easier, you can often
use the same regexp/callback for both
Disables this feature
function full name in format
Function should have signature
(str) -> bool. It accepts original tag name and returns
Trueif tag is accepted and
Falseif not. You can return other value type, like
None, it will be treated as
Exception will be raised if module or function/lambda is missing or has invalid signature
<tag>group isn’t required for the filter, but makes it simpler to share with the
Exception will be raised if regexp is invalid
If regexp doesn’t match any tag, the filter will return the empty list, and the default “0.0.1” version will be selected.