Index of /ports/net-im/py-xmpppy-irc/work/irc-transport-0.3

      Name                    Last modified       Size  Description


[DIR] Parent Directory        20-Jan-2008 14:33      -  
[   ] ChangeLog               07-Mar-2006 01:05     8k  
[TXT] IRC-Transport-Howtou..> 20-May-2004 03:35     3k  
[   ] irc.py                  09-Jan-2008 17:31    84k  
[   ] irc.py.bak              07-Mar-2006 01:05    84k  
[   ] jep0106.py              12-Jul-2005 15:37     1k  
[   ] jep0133.py              22-Oct-2005 14:23    16k  
[   ] test_jep0106.py         09-Jan-2008 17:31     1k  
[   ] test_jep0106.py.bak     12-Jul-2005 15:37     1k  
[   ] transport.ini           02-Jan-2006 11:40     1k  
[   ] xmpp-irc                09-Jan-2008 17:31     1k  
[   ] xmpp-irc.bak            16-Jun-2004 07:11     1k  

XMPP IRC-Transport Readme.
==========================


Installing the transport:
-------------------------

To install the transport you need a copy of the xmpppy (by Alexey Nezhdanov) library on your system and a copy of the irclib (by Joel Rosdahl). You can find both of these at the following addresses:

http://xmpppy.sourceforge.net
http://python-irclib.sourceforge.net

To make the irclib library integrate with the transport more effectively you need to patch it with the supplied diff file: irclib.py.diff.  (patch <irclib.py.diff works for me). This allows the external select function without needing lambda functions. This is required for the transport to operate.

Configure the Transport:
------------------------

To configure the transport you need to modify your jabber server configuration to expose the irc-transport to users. The transport itself has a configuration file which contains the following:

[transport]
Server: name.of.jabber.server
Hostname: name.of.irc.transport
Port: portnumber
Secret: sharedsecret
LocalAddress: ip-address-for-irc-connections
Charset: 8-bit charset to use when not UTF-8 encoded from network (all traffic out to irc is encoded as this type.) e.g. koi8-r shift-jis or gb2313

The default Python Encoding:
----------------------------

Some people may have set the python site.py encoding to something other than ascii. The transport relies on this being a non-unicode value, if you have set this to utf-8 it may not work.

Thanks to:
----------

The Jabber.org.uk crew who let me abuse their server while doing testing.
Alexey Nezhadanov for his help and the library.
Joel Rosdhal for the irclib library.