======Configuring OpenSRF Python clients======
  - Install the prerequisites
  - Test your installation with ''srfsh.py'' calling the ''math_bench'' test
  - (Optional): Connect to 
 
=====Prerequisites=====
  * Python 2.4+ (2.3 may work, but is untested)
  * [[http://pyxmpp.jajcus.net/|pyxmpp]] for Jabber protocol support
    * [[http://www.dnspython.org/|dnspython]] DNS support required by pyxmpp
  * [[http://cheeseshop.python.org/pypi/simplejson|simplejson]] for JSON encoding/decoding support

If you try running ''srfsh.py'' and dnspython raises an exception concerning dns.resolver.NXDOMAIN you may need to use dnsmasq or the like to provide local DNS resolution for your hostname. This is quite likely to occur if it is ''localhost'', as ''dnspython'' does not understand ''/etc/hosts'' files. The dnsmasq option that worked for me (using ''localhost'' as my hostname) was ''-A/*/127.0.0.1'' -- your mileage may vary.

=====Making requests to Evergreen services=====

To make a request to an Evergreen service:
  - Add a link from ''Open-ILS/src/python/oils'' to ''/usr/lib/python2.4/site-packages/.'' (or the equivalent):<code>
ln -sf /path/to/Open-ILS/src/python/oils /usr/lib/python2.4/site-packages/.</code>
  - Add the following section to your ''.srfsh.xml'' configuration file:<code>  <plugins>
    <plugin>
      <module>oils.utils.idl</module>
      <init>IDLParser.parse</init>
    </plugin>
  </plugins></code>