Strona domowa GDR!a

V 3.7


Easy XML-RPC via Jabber protocol

DOWNLOAD

What is this code?

This is a set of Python classes that implement XML-RPC using the Jabber protocol as transport. It supports both secure (SSL) and insecure connections.

Elegant and easy to use interfaces for both XML-RPC server and client are available. Both server and client are clients of Jabber protocol and need regular Jabber accounts on any Jabber server - public or private.

How do I use the server?

Use the EasyJabberXMLRPCServer class. Its constructor takes the following arguments: JabberServer = "chrome.pl", JabberUsername = "_serv", JabberPassword = "test", JabberResource="rpcServer", JabberPort = 5223, JabberConnection = "SSL", ConnectionTimeout = 5

  • JabberServer - name of Jabber server where you hold your account
  • JabberUsername - username on the above Jabber server
  • JabberPassword - your dog's name reversed
  • JabberResource - Jabber resource, use any string you want or leave the default "rpcServer"
  • JabberPort - port on which JabberServer listens for incoming connections
  • JabberConnection - type of connection, either "SSL" or "TCP"
  • ConnectionTimeout - in seconds

To register a method to be exported by the server, use the register_function() method. It takes the following arguments: function, name = None

  • function - the function you want to be exported
  • name - name by which you want the function to be accessible, leave it as None if you want to use the name you use locally

In order for the server to start listening, you need to call the serve_forever() method. It takes no arguments.

In short, the whole server setup takes as much as four lines of code:

import EasyJabberXMLRPCServer

def test(number):
    return "dupa" + str(number)

serv = EasyJabberXMLRPCServer()
serv.register_function(test)
print serv
serv.serve_forever()

And how do I use the client?

Using the client is not too complicated either. Use the class EasyJabberXMLRPCClient. Its constructor takes the following arguments: JabberServer, JabberUsername, JabberPassword, RpcServerJid, JabberResource="rpcClient", JabberPort = 5223, JabberConnection = "SSL", ConnectionTimeout=20

  • JabberServer - Jabber server where you created the client's account (you remember that you need separate accounts for server and client, do you?)
  • JabberUsername - username on the above server
  • JabberPassword - name of your first girlfriend with "666" appended
  • RpcServerJid - XMLRPC server's account (including resource), ServersJabberUsername@ServersJabberServer/ServersJabberResource
  • JabberResource - leave the default "rpcClient" or type whatever you want
  • JabberPort, JabberConnection, ConnectionTimeout - means the same as with the server

After you call the constructor, the class connects to Jabber server and then to XMLRPC server and, if you get no exception, everything was successful and you can call the methods exported by server as if they were client's methods (for example print ClientInstance.test(param1, param2))

So, in three lines of code we have a working client:

import EasyJabberXMLRPCClient

cli = EasyJabberXMLRPCClient(JabberServer="chrome.pl", JabberUsername = "_client", JabberPassword = "test", RpcServerJid = "_serv@chrome.pl/rpcServer")
print cli.test(0x29a) # Here the "test" method exported by server is called

# alternatively, you can call methods this way:
print cli.Call("test", (0x29a,))

Credits

2006 GDR! - http://gdr.geekhood.net/

Sponsored by Cybertronika

Uses JabberXMLRPCClient.py by gian paolo ciceri <gp.ciceri@acm.org>

Licence: Dual, GPL + LGPL

DOWNLOAD

URL encoded in QR Code Statystyki:
Stat4U
Email
Polskie strony Man
Around the world in 80 jobs