Write your event handlers as methods of a class. The superclass of your class is not important for Skype4Py, it will just look for methods with appropriate names. The names of the methods and their arguments lists can be found in respective events classes (see above).

Pass an instance of this class as the Events argument to the constructor of a class whose events you are interested in. For example:

import Skype4Py

class MySkypeEvents:
    def UserStatus(self, Status):
        print 'The status of the user changed'

skype = Skype4Py.Skype(Events=MySkypeEvents())

If your application is build around a class, you may want to use is for Skype4Py events too. For example:

import Skype4Py

class MyApplication:
    def __init__(self):
        self.skype = Skype4Py.Skype(Events=self)

    def UserStatus(self, Status):
        print 'The status of the user changed'

This lets you access the Skype object (self.skype) without using global variables.

In both examples, the UserStatus method will be called when the status of the user currently logged into Skype is changed.

This method lets you use any callables as event handlers. Simply assign them to On... properties (where "..." is the name of the event) of the object whose events you are interested in. For example:

import Skype4Py

def user_status(Status):
    print 'The status of the user changed'

skype = Skype4Py.Skype()
skype.OnUserStatus = user_status

The user_status function will be called when the status of the user currently logged into Skype is changed.

The names of the events and their arguments lists can be found in respective events classes (see above). Note that there is no self argument (which can be seen in the events classes) simply because our event handler is a function, not a method.

This method, like the second one, also lets you use any callables as event handlers. However, it also lets you assign many event handlers to a single event. This may be useful if for example you need to momentarily attach an event handler without disturbing other parts of your code already using one of the above two methods.

In this case, you use RegisterEventHandler and UnregisterEventHandler methods of the object whose events you are interested in. For example:

import Skype4Py

def user_status(Status):
    print 'The status of the user changed'

skype = Skype4Py.Skype()
skype.RegisterEventHandler('UserStatus', user_status)

The user_status function will be called when the status of the user currently logged into Skype is changed.

The names of the events and their arguments lists should be taken from respective events classes (see above). Note that there is no self argument (which can be seen in the events classes) simply because our event handler is a function, not a method.

All handlers attached to a single event will be called serially in the order they were registered.