feat: Support publish pact with branch

[B3nnyL]

Feature description:

#268

Details:

• Support publishing pacts with branch and a build_url.
• Use auto_detect_version_properties flag to read branch information from CI. Enable it by default

Actual pacts published with branch:

broker url

[YOU54F]

epic @B3nnyL will take a look at this today, if not, this week. 🙌🏾

[B3nnyL]

PR for fixing broken example message consumer test due to publishing duplicated versions

[YOU54F]

Just added some documentation to support

c1da32a

[elliottmurray]

I need to test this a bit locally first. I don't know what that auto detect does!

Can I merge this and #302 at the same time? Looks like at least the complexity metric might be an issue?

[B3nnyL]

Hello @elliottmurray! Sorry I just saw your reply. auto-detect-version-properties helps CI detects branches , you can explanation from here

[YOU54F]

Tested this out, looks good, branch is optional, and picked up from env vars, if auto_detect_version_properties set to True

I'd maybe tighten up the auto_detect_version_properties to accept True and not Any as it allows "true" but expects True.

        broker = Broker(broker_base_url="https://saf.pactflow.io", broker_token='foobar')
        broker.publish("Consumer_a",
                       "2.0.3",
                       auto_detect_version_properties=True,  # Uses common CI env vars such as GIT_BRANCH to set the branch property only (probably confusingly named!)
                       #    branch='consumer-branch',
                       tag_with_git_branch=True,
                       pact_dir='.')

Nice work @B3nnyL