When multiple control port authentication methods were defined we would just
try the first then abort. This is always cookie auth so this became a problem
in the following use case:

- User installs our new tor deb which has cookie auth by default
- User adds a hashed password to their torrc and starts tor
- TorCtl attempts to connect but can't read the cookie file due to permissions,
  so it fails to connect.
- User is confused why they weren't prompted for their password.

This change makes does a couple things...
- Makes an alternate functions which give a list of authentication methods
  rather than just the first. To avoid breaking backward compatability these
  are new functions, with the old ones functionally unchanged...

  get_auth_type => get_auth_types
  preauth_connect => preauth_connect_alt

  Pydocs for the old functions mention that they're deprecated.

- The 'authenticate' method now attempts all connection methods, and by
  extension so does 'connect'. If all authentication methods fail then this
  raises an exception for the last failed attempt.

I tested this with no auth, cookie auth, and dual auth where the cookie file
was unreadable...

- Presents connection components which now has a list of auth methods rather
  than just one.

>>> TorCtl.preauth_connect_alt()
(<TorCtl.Connection instance at 0xb78749cc>, ['COOKIE', 'PASSWORD'], '/tmp/torData/control_auth_cookie')

- For a single auth method (this example with an open connection)...

>>> TorCtl.preauth_connect_alt()
(<TorCtl.Connection instance at 0xb787b9cc>, ['NONE'], '')
>>> conn = TorCtl.connect()
>>> conn.get_info("version")
{'version': '0.2.2.23-alpha (git-b85eb949b528f4d7)'}

- Attempts (1) auth cookie, (2) caller provided password, (3) prompts user for
  a password. All fails and connect returns None.

>>> TorCtl.connect(passphrase="blarg")
NOTICE[Wed Sep 21 08:40:43 2011]:Tor closed control connection. Exiting event thread.
INFO[Wed Sep 21 08:40:43 2011]:Event loop received close message.
Provided passphrase was incorrect
Password:
NOTICE[Wed Sep 21 08:40:45 2011]:Tor closed control connection. Exiting event thread.
INFO[Wed Sep 21 08:40:45 2011]:Event loop received close message.
Unable to authenticate: password incorrect

According to dererk the default control socket path is "/var/run/tor/control"
rather than "/var/lib/tor/control" (the path mentioned by Peter).

Adding support for unix domain control sockets via another connect method. This
is for 'https://trac.torproject.org/projects/tor/ticket/3638'.

The BUILD_FLAGS, which is for ticket 2411, isn't in tor yet so it shouldn't
yet be in torctl either. This looks like it will be a comma separated list,
but until it's added to the spec we shouldn't depend on that.

Avoids repetitive constructors among new style events and parsing the
positional/kw arguments if they won't be used.

Using the new style for GUARD events, also fixing a minor bug where the
nickname attribute might be left unset after init. Tested this by deleting the
state directory and restarting tor.

Using the new style for BUILDTIMEOUT_SET events, also adding support for its
TIMEOUT_RATE, CLOSE_MS, and CLOSE_RATE parameters.

*This is not tested* - I didn't figure out a method for triggering
BUILDTIMEOUT_SET events (tried client usage and removing the state
directory/reinitializing but no luck)

Using the new style for ADDRMAP events. These events have both quoted and
non-quoted values breaking positional and keyword parsing, so keeping the regex
parsing.

This expands the event to include the ERROR and GMTExpiry attributes. This was
tested by visiting sites with TBB and printing out the ADDRMAP results.

Using the new style for NEWDESC events. This isn't using the positional or kw
pattern so effectively this is just moving the body parsing into the event.
Tested by attaching to a new tor instance to get NEWDESC events.

This one isn't actually using the new style since the events aren't of the
positional or keyword pattern. I'm just adding the empty positional and kw
args so this doesn't need to become a special case later.