Restore behaviour of SkypeConnection.liveLogin()

Expose SOAP as a new method on SkypeConnection instances, and update
getSkypeToken() (and therefore the Skype constructor) to use SOAP.

Author: Terrance

skpy/conn.py

@@ -263,7 +263,7 @@ def setUserPwd(self, user, pwd):
             pwd (str): password of the connecting account
         """
         def getSkypeToken(self):
-            self.liveLogin(user, pwd)
+            self.soapLogin(user, pwd)
         self.getSkypeToken = MethodType(getSkypeToken, self)
 
     def setTokenFile(self, path):
@@ -361,6 +361,31 @@ def liveLogin(self, user, pwd):
         Returns:
             (str, datetime.datetime) tuple: Skype token, and associated expiry if known
 
+        Raises:
+            .SkypeAuthException: if the login request is rejected
+            .SkypeApiException: if the login form can't be processed
+        """
+        self.tokens["skype"], self.tokenExpiry["skype"] = SkypeLiveAuthProvider(self).auth(user, pwd)
+        self.getUserId()
+        self.getRegToken()
+
+    def soapLogin(self, user, pwd):
+        """
+        Perform a login with the given email address or Skype username, and its password, using the Microsoft account
+        SOAP login APIs.
+
+        .. note::
+            Microsoft accounts with two-factor authentication enabled are supported if an application-specific password
+            is provided.  Skype accounts must be linked to a Microsoft account with an email address, otherwise
+            :class:`.SkypeAuthException` will be raised.  See the exception definitions for other possible causes.
+
+        Args:
+            user (str): username or email address of the connecting account
+            pwd (str): password of the connecting account
+
+        Returns:
+            (str, datetime.datetime) tuple: Skype token, and associated expiry if known
+
         Raises:
             .SkypeAuthException: if the login request is rejected
             .SkypeApiException: if the login form can't be processed
@@ -390,7 +415,7 @@ def guestLogin(self, url, name):
 
     def getSkypeToken(self):
         """
-        A wrapper for :meth:`liveLogin` that applies the previously given username and password.
+        A wrapper for the default login provider that applies the previously given username and password.
 
         Raises:
             .SkypeAuthException: if credentials were never provided