- Create a new twitter API connector using the specified
- credentials (email and password). Format specifies the output
- format ("json" (default) or "xml").
+ Create a new twitter API connector.
+
+ Pass an `auth` parameter to use the credentials of a specific
+ user. Generally you'll want to pass an `OAuth`
+ instance::
+
+ twitter = Twitter(auth=OAuth(
+ token, token_secret, consumer_key, consumer_secret))
+
+
+ Alternately you can pass `email` and `password` parameters but
+ this authentication mode will be deactive by Twitter very soon
+ and is not recommended::
+
+ twitter = Twitter(email="blah@blah.com", password="foobar")
+
+
+ `domain` lets you change the domain you are connecting. By
+ default it's twitter.com but `search.twitter.com` may be
+ useful too.
+
+ If `secure` is False you will connect with HTTP instead of
+ HTTPS.
+
+ The value of `agent` is sent in the `X-Twitter-Client`
+ header. This is deprecated. Instead Twitter determines the
+ application using the OAuth Client Key and Client Key Secret
+ parameters.
+
+ `api_version` is used to set the base uri. By default it's
+ nothing, but if you set it to '1' your URI will start with
+ '1/'.