Technologist.

PySilc is a near-complete set of Python bindings for creating SILC clients using the silc-toolkit. It allows developers to write simple bots and clients for connecting to SILC servers.

Also included is a simple test client bot in ‘examples/echo.py’ and a experimental SILC driver for Supybot.

Building and Installing

python setup.py build
python setup.py install (as root)

Usage Overview

All the classes are documented using Python Docstrings. You can see descriptions of classes and modules by simply using pydoc or help() in the python console.

All the functionality is contained within the module ‘silc’.

The main classes are as follows:

SilcClient - This is the main class that represents a SILC client. You must subclass SilcClient and override some key callback methods.

SilcKeys - Represents a pair of public and private keys that can be generated using ‘silc.load_key_pair()’ and ‘silc.create_key_pair()‘.

SilcUser - Represents a user on a SILC server. You will not create these automatically but will be able to access them by

The majority of the work will be to write callbacks that react to messages the server sends to the client. These can be either asynchronous events such as channel messages, or responses to commands that are sent by the client.

Callbacks are callable members of the SilcClient class (or subclass) and their signature is on the SilcClient docstring. An example implementation would look like this:

import silc

class EchoClient(silc.SilcClient): def channel_message(self, sender, channel, flags, message): print message self.send_channel_message(channel, message)

def private_message(self, sender, flags, message): print message self.send_private_message(sender, message)

def connected(self): print ”* Connected” self.command_call(“JOIN crazybotchannel”)

def disconnected(self): print ”* Disconnected”

catch responses to commands

def command_reply_join(self, channel, name, topic, hmac, x, y, users):

print ”* Joined channel %s” % name self.send_channel_message(channel, “Hello!“)

catch async notifications from the server

def notify_join(self, user, channel): print ”* A user named %s has joined the channel %s” % \ (user.username, channel.channel_name) self.send_channel_message(channel, “Hello, %s” % user.username)

if name == ”main”: keys = silc.create_key_pair(“silc.pub”, “silc.prv”) client = EchoClient(keys, “echobot”, “echobot”, “Echo Bot”) client.connect_to_server(“silc.example.com”)

while True: try: time.sleep(0.1) client.run_one() except KeyboardInterrupt: break

Download

Building and Installing

Authors and License

Usage Overview

Callbacks Overview

catch responses to commands

catch async notifications from the server