Test classes

SkPy comes with some test cases that cover expectations from the server, and the correctness of the library’s parsing.

Client testing

Here, responses from the server are mocked out and replaced with static strings, so the real Skype server is never contacted. Test cases aim to ensure the library parses each response correctly.

class test.client.Data

Dummy representations of data normally retrieved from Skype.

test.client.registerMocks(regTokenRedirect=False, guest=False)

Override external calls to Skype APIs with static responses using responses.

Parameters:

• regTokenRedirect (bool) – whether to emulate the ‘user is on another cloud’ host redirect

• guest (bool) – whether to emulate a guest account

test.client.mockSkype()

Create a fake, pre-connected Skype instance.

class test.client.SkypeClientTest

Main test class for all SkPy code.

Each test method enables the intercepting of API calls as defined in registerMocks().

Note that tests should be designed to evaluate local code – they are not testing correctness of the Skype APIs, rather that the local classes handle the requests and responses appropriately.

testAuth()

Complete the auth flow with a dummy username and password.

testAuthRedirect()

Complete the auth flow with a dummy username and password, including a messenger hostname redirect.

testGuestAuth()

Complete the auth flow as a guest joining a conversation.

testContactList()

Collect a list of contacts for the current user.

testChatList()

Collect a list of conversations for the current user.

testChatGetMsgs()

Collect a list of messages for a conversation.

testChatSendMsgs()

Send various types of messages, and check the resulting SkypeMsg instances.

testUtils()

Various tests for parsing provided by SkypeUtils.

Server testing

These tests connect to the production Skype server to perform actions, checking that requests to and responses from the server are consistent with the library.

class test.server.SkypeServerTestBase

Base class for tests designed to interpret server responses.

Warning

This requires access to a live Skype account, the credentials for which will be read from .tokens (or from a file named in environment variable SKPY_TESTSERVER_TOKENS if set). This can be accomplished in a shell:

>>> from skpy import Skype
>>> Skype(username, password, tokenFile=".tokens")

You must also set SKPY_TESTSERVER_RECIP to a contact on the account that should receive test messages.

classmethod setUpClass()

Hook method for setting up class fixture before running tests in the class.

class test.server.SkypeServerReadTest

Basic, read-only tests on information provided by the server for the connected account.

testSelf()

Retrieve the current user.

testSettings()

Read all setting fields for the current user.

testContacts()

Retrieve the named recipient as a user and a contact.

testChats()

Retrieve a conversation with the named recipient.

testTranslate()

Request a text translation.

testServices()

Retrieve the services list for the current user.

class test.server.SkypeServerWriteTest

Specific test cases that require performing “write” actions on the connected account.

testGroupChats()

Create a group chat with the named recipient, send a test message, and invite a guest.

class test.server.SkypeServerEventTest

Specific test cases that poll the event stream, and require external data (i.e. sending messages from another client to this user account).

testPasswordLogin()

Attempt a fresh login with a username and password.

testMessageEvent()

Receive a message from the named recipient.