Make HACKING.rst DRYer and turn into rst file

Rename HACKING to HACKING.rst since it is a rst file and
reference the OpenStack hacking guide and remove
duplicated entries.

Change-Id: I9994594c7f8cb0f011d949b273bea08c68985e16
Fix trustee/trustor definitions

The trustee is the person consuming the trust, the trustor is the person
who creates the trust.

Change-Id: I4d6c4b4f14c0dfcb3b41cd3e37aecd01487442fd
Merge "Fix trustee/trustor definitions"
Do not format messages before they are logged

The python logging facility allows for the logging message to contain
string formatting commands, and will format that string with any
additional arguments provided. It will only perform this formatting if
the logging level allows.

So if you have:

   A. logging.debug("this %s that %s", this, that)
   B. logging.debug("this %s that %s" % (this, that))

Then A only formats the message if the debug logging level is set,
where as B will always format the message. Since this filter is often
on the fast-path for swift requests, it will help the small object
case to avoid any extra possible work.

Change-Id: I51414dc6577df50d5573a0f917e0656c4ae99520
Reorganize Service Catalog

Currently each service catalog call handles it's own parsing and
filtering. Modify this so that each function calls back to another
public function ensuring that filtering and parsing is only handled
once.

This allows us to consolidate some helper methods into the base class
and generally clean up.

Change-Id: I15777436af06baea903182f4b3b5913e2890afd1
Merge "Make HACKING.rst DRYer and turn into rst file"
Merge "Do not format messages before they are logged"
Extract a base Session object

A wrapper around a number of connection variables. This will be extended
later with principals such as Kerberos authentication and http sessions.

The intent is that this session object will become the basis for all
other client library communications in OpenStack (as keystone wants to
control things like authentication for everybody).

Change-Id: I8ee728c49d554659d7057ebf17d0f8ceea4d7d8e
Part of: blueprint auth-plugins
Merge "Reorganize Service Catalog"