1
ClientCookie installation instructions
2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7
Python 1.5.2 or above is required, and urllib2 is recommended. Python
8
2.0 and above have urllib2 in the standard library, but the version of
9
urllib2 supplied with Python 2.0 is too old. If you're using Python
10
2.0, either use the 1.5.2-compatible version (see below), or get the
11
version from Python 2.1 (available from the source distribution or CVS
12
from http://www.python.org/). If you're using Python 1.5.2, there is
13
a 1.5.2-compatible urllib2.py available at
15
http://wwwsearch.sourceforge.net/
17
(these are derived from the 1.13.22 and 1.126.2.2 CVS releases, from
18
the Python 2.1 maintenance branch). To install these, either overwrite
19
the old versions with these new ones, or place them somewhere in
20
sys.path ahead of the old ones, and rename them: urllib_152.py and
21
urllib2_152.py to urllib.py and urllib2.py respectively.
27
To install the package, run the following command:
31
then (with appropriate permissions)
33
python setup.py install
36
Alternatively, just copy the whole ClientCookie directory into your
37
Python path (eg. unix: /usr/local/lib/python2.2/site-packages,
38
Windows: C:\Python21, or C:\Python22\Lib\site-packages). That's all
39
that setup.py does. Only copy the ClientCookie directory that's
40
inside the distributed tarball / zip archive, not the entire
41
ClientCookie-x.x.x directory!
44
To run the functional tests (which DO access the network):
46
python functional_tests.py
48
To run the unit tests (which DO NOT access the network):
52
This runs the unit tests against the source files extracted from the
53
package. To run them against the installed copy of ClientCookie:
57
For help on other unit test options:
62
If you're using a pre-2.1 version of Python, you'll need to get
63
unittest.py (from http://pyunit.sourceforge.net) to run the tests.
65
If you run the tests on an Apple, or other non-unix, non-Windows
66
machine, please mail me the output along with details of the system
69
Bugs and comments to jjl@pobox.com.
74
THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
75
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
76
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
80
(C) 2002-2003 John J. Lee. All rights reserved.
81
(C) 1995-2001 Gisle Aas. All rights reserved. (Original LWP code)
82
(C) 2002-2003 Johhny Lee. All rights reserved. (MSIE Perl code)
84
This code in this package is free software; you can redistribute it
85
and/or modify it under the terms of the BSD license (see the file
88
John J. Lee <jjl@pobox.com>