Allow headers to be retreived with GET bodies

If a Resource.get* call with include_headers is set to True, the
response body will include header keys and values.

Change-Id: I49390715b0e39d5ca279dad85e3bed786e975b10
Handle booleans that are strings in APIs

Coerces string values to a boolean only when the prop is given a
type=BoolStr. BoolStr only accepts string words, no shortened values,
synonyms or integer values. When no acceptable value is found a
TypeError or ValueError is raised. Setters and Constructor calls
validate the attribute value as a fail-fast behavior.

Change-Id: I382426325522227a83ec5234c5116da97e71cfa2
Closes-Bug: #1365724
Reverse order of tests to avoid incompatibility

If py26 tests are run first, there is some incompatibility in the
.testrepository that breaks several tests.  To get around this, you
need to run the py33 tests first.  This change was made over in the
cliff project.

Before:

    (.venv)terry@brat:~/hp/sdk$ rm -rf .testrepository/
    (.venv)terry@brat:~/hp/sdk$ tox
      ...
      py26: commands succeeded
      py27: commands succeeded
    ERROR:   py33: commands failed
    ERROR:   py34: commands failed
    ERROR:   pypy: commands failed
      pep8: commands succeeded

After:

    (.venv)terry@brat:~/hp/sdk$ rm -rf .testrepository/
    (.venv)terry@brat:~/hp/sdk$ tox
      ...
      py33: commands succeeded
      py34: commands succeeded
      py26: commands succeeded
      py27: commands succeeded
      pypy: commands succeeded
      pep8: commands succeeded
      congratulations :)
    (.venv)terry@brat:~/hp/sdk$ 

Change-Id: I64925097ce003659c4daa0e105bd06dc30726921
Convert the session object to autodoc

Change-Id: I0be3800151f9dbd7bc070cd3885ae0ffc9da1b0c
Add connection documentation

Change-Id: I479d4980f8001266eb85174852d7f5f96d19d880
Merge "Convert the session object to autodoc"
Merge "Add connection documentation"
User preference docs

Change-Id: I6534ad3f5921fdf3968006c742dc42a22a3cd5bd
fix identity service comment

Change-Id: I8ce56a99dfbbc744a8a34e530af6bb234aaceeff
service filter docs

Change-Id: I9fff211a5412270249fe5befa9097e5ba62ed941
Merge "service filter docs"
Merge "User preference docs"
Merge "Handle booleans that are strings in APIs"
Merge "Allow headers to be retreived with GET bodies"
Merge "Reverse order of tests to avoid incompatibility"
remove pointless test

Change-Id: I329ff78375f5e0d56f3e77ac2a645aecb1be9ed3
Move the examples docs into the code

I like the idea of having the examples in the code.  I don't necessarily
like having to scroll through all those comments to get to the code.  This
also changes the order of the documentation to summary, example, reference
versus summary, reference, example.  I think I'm okay with that because
:class links will anchor to the reference section.  Normally, seeing a
simple example first can be more useful.

This is a response to Doug's comment:
https://review.openstack.org/#/c/129937/1/doc/source/user_preference.rst

Change-Id: Ibbda909d2183edc6baeeec0bc56f01779334aabd
base auth plugin docs

Change-Id: I9966cf4bb8c9e23517adeee4c061d23a8e71630a
auth plugin identity base docs

Change-Id: I55f1eef2514825bd14d4b9c97e620adeefe4e0c9
Merge "Move the examples docs into the code"