Git: Fix initial clone with gerrit changes

git clone --branch only works with refs under refs/heads/* and
refs/tags/*, not arbitrary refs. But the Gerrit step will give us a
ref of the form refs/changes/*, since that is where gerrit stores the
submitted changes for us to build.

There appears to be no way to get an arbitrary ref with 'git clone',
as you can with --branch; at least, none I can see. So instead, just
do a regular clone, and run the normal _fetch routine afterwards,
which will fetch the relevant ref and check it out for us.

This bug is mentioned in bug #2485, though #2485 itself is a different
bug.
GerritStatusPush: Fix labels with gerrit >=2.6

Fixes #2550. Gerrit versions 2.6 and newer do not accept the
--verified option if the Verified label does not exist in All-Projects
in the gerrit configuration. Instead, we must give the --label option.
So, use --label for --verified and --code-review so we can work with
all gerrit installations.

While the --code-review option does still work, so does the --label
approach. It seems more likely that --label is more likely to work in
the future than --code-review, so we'll just go with the safer route.

In order to still support older gerrit installations (which do not
support the --label option), query the gerrit installation version
whenever we submit a review. Cache this version query for 10 minutes,
so we do not ask the gerrit server every single time for its version.
GerritStatusPush: Add per-buildset status updates

Currently GerritStatusPush will submit an update/review to gerrit
immediately when each builder in a buildset finishes building. It is
usually more useful to just get one update, containing information
about all of the builds in that buildset. So, allow GerritStatusPush
to do that, configurable via the new summaryCB constructor argument. A
default summaryCB is also provided: defaultSummaryCB.

If neither reviewCB nor summaryCB are explicitly provided in the
configuration, default to sending out the new "summary" reviews.
However, if reviewCB was explicitly provided, default to sending out
the old-style per-build reviews, and not sending out the new "summary"
reviews. This allows for older configurations to not see an unexpected
change in behavior, but completely new configurations are likely to
see the probably more useful "summary" reviews.

Since much of this functionality is already implemented in
MailNotifier, extract the relevant code into the new
BuildSetSummaryNotifierMixin, and make both MailNotifier and
GerritStatusPush use it. Document the new mixin class.

Also add tests for GerritStatusPush, to test the new behavior, and for
BuildSetSummaryNotifierMixin, to test that the mixin itself works
properly. Modify the unit tests for MailNotifier to accomodate the
refactoring.
added BitbucketPullrequestPoller changes source

The BitbucketPullrequestPoller polls a Bitbucket repository (merucrial
or git) for new or updated pull requests.

* master/buildbot/changes/bitbucket.py: added
added BitbucketPullrequestPoller documentation

* master/docs/manual/cfg-changesources.rst: added documentation
* master/docs/relnotes/index.rst: added release note
fix BitbucketPullrequestPoller issues
added BitbucketPullrequestPoller tests
BitbucketPullrequestPoller unittests fixed pep8 issues
BitbucketPullrequestPoller removed log messages
Support tagging instances after they have launched.
add some unit tests for EC2LatentBuildSlave
make botoSetup return connection
don't call create_tags unecessarily
test start_instance with tags
document tags parameter for EC2LatentBuildSlave
add GerritChangeFilter

Its not very clear for people how to use gerritchangesource to filter
gerrit change events, and create builds.

add GerritChangeFilter, which is a simple general purpose filter, which
manage most of the changefilters needs

doc + tests

and some whitespace fixing in the doc.

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
skip ec2 buildslave tests if moto not found
remove moto dependency from setup.py
skip ec2 buildslave tests if moto version is not up to date
add lost comma to setup.py