Merge pull request #21 from alphagov/add-notes-on-5-1

[#69434348] Add details on which version of the API we use
Cucumber convention is to use "features"

See https://github.com/alphagov/vcloud-launcher/commit/fba526495931316abccdf69c31e12eb0466046bd
Merge pull request #22 from alphagov/features-not-feature

[#69915948] Cucumber convention is to use "features"
QueryRunner.available_query_types integration test
Add QueryRunner#run no-options happy path

vAppTemplates are highly likely to exist in any organization, and
definitely exist in our CI environment.

They also have the benefit of being relatively small in number,
(unlike 'task' elements, for example), so result in speedy
all-result queries.
Add 'fields' option test case for QueryRunner#run

It is possible to limit the data returned by QueryRunner
by specifying a comma separated list of field names.

This documents this behaviour and tests that it is functioning.
Improve QueryRunner#available_query_types test doc

In order to demonstrate that we rely on "records" output format, and core vCloud entity types
Test QueryRunner#run :filter option

QueryRunner.run can have the output limited by a filter expression.

This adds tests that ensure that a 'previously multiple record' query
is subsequently reduced down to a single known record via a filter on the
(unique) href field.
Add vApp based QueryRunner#run tests

These involve setting up a known-good environment to query against,
with two vApps.

These tests replace the vAppTemplate tests, which assume too much. These
will be removed in a subsequent commit, so not to confuse the additions
in this commit.
Remove redundant vAppTemplate tests

These tests are assuming that there are >1 vAppTemplates in the
queried organisation, which is not always true.

The vApp tests in the previous commit are designed to replace these.
Update QueryRunner test names

to be descriptive rather than prescriptive
Fix vApp query results size assertation
Fix spelling error
Improve tests to highlight :fields behaviour

Query API behaviour surrounding limiting result 'fields' is
quirky. Document this in our tests, specifically:

* if a blank field list is specfied, API returns an error
* the 'href' field is returned regardless
Add a 'Fog Credentials' section to README

Setting up the Fog credentials are not well documented in Fog, so
provide our users with clear guidance.
Merge pull request #24 from alphagov/credentials_in_readme

[#69702304] Add a 'Fog Credentials' section to README
Merge branch 'master' into 62223252_query_integration_test
:href was accidentally tested for, should be :name
Merge pull request #23 from alphagov/62223252_query_integration_test

[#62223252] QueryRunner integration test
Unwrap non-indented line in #generate_preamble

The call to `#result` is a method of the preceeding line but the lack of
indentation doesn't make this apparent. So unwrap it back to the preceding
line. This makes the line longer but not unusually so for the rest of the
file.