ClientCookie installation instructions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Dependencies
~~~~~~~~~~~~

Python 2.0 or above is required, and urllib2 is recommended.  Python
2.0 and above have urllib2 in the standard library, but the version of
urllib2 supplied with Python 2.0 is too old.  If you're using Python
2.0, get the version from Python 2.1 (available from the source
distribution or CVS from http://www.python.org/).

Installation
~~~~~~~~~~~~

To install the package, run the following command:

 python setup.py build

then (with appropriate permissions)

 python setup.py install


Alternatively, just copy the whole ClientCookie directory into your
Python path (eg. unix: /usr/local/lib/python2.2/site-packages,
Windows: C:\Python21, or C:\Python22\Lib\site-packages).  That's all
that setup.py does.  Only copy the ClientCookie directory that's
inside the distributed tarball / zip archive, not the entire
ClientCookie-x.x.x directory!


To run the functional tests (which DO access the network):

 python functional_tests.py

To run the unit tests (which DO NOT access the network):

 python test.py

This runs the unit tests against the source files extracted from the
package.  To run them against the installed copy of ClientCookie:

 python test.py -i

For help on other unit test options:

 python test.py --help


If you're using a pre-2.1 version of Python, you'll need to get
unittest.py (from http://pyunit.sourceforge.net) to run the tests.

If you run the tests on an Apple, or other non-unix, non-Windows
machine, please mail me the output along with details of the system
you ran them on.

Bugs and comments to jjl@pobox.com.


NO WARRANTY

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Copyright Notices

  (C) 2002-2004 John J. Lee.  All rights reserved.
  (C) 1995-2001 Gisle Aas.  All rights reserved.   (Original LWP code)
  (C) 2002-2003 Johhny Lee.  All rights reserved.  (MSIE Perl code)

This code in this package is free software; you can redistribute it
and/or modify it under the terms of the BSD or ZPL licenses (see the
file COPYING.txt).

John J. Lee <jjl@pobox.com>
March 2006