summaryrefslogtreecommitdiff
path: root/INSTALL.txt
blob: 19c5d26d2300f63394a50adfec07847d3632005a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
Installing This Package
=======================

Prerequisites
-------------

The installation steps below assume that you have the cool new 'setuptools'
package installed in your Python.  Here is where to get it:

  $ wget http://peak.telecommunity.com/dist/ez_setup.py
  $ /path/to/your/python ez_setup.py # req. write access to 'site-packages'


  - Docs for EasyInstall:
    http://peak.telecommunity.com/DevCenter/EasyInstall

  - Docs for setuptools:
    http://peak.telecommunity.com/DevCenter/setuptools

  - Docs for eggs:
    http://peak.telecommunity.com/DevCenter/PythonEggs


Installing a Development Checkout
---------------------------------

Check out the package from subversion:

  $ svn co svn+ssh://svn.zope.org/repos/main/zope.security/trunk \
    src/zope.security
  $ cd src/zope.security

Install it as a "devlopment egg" (which also installs its "hard"
dependencies):

  $ /path/to/your/python setup.py devel

The installation of dependency eggs uses the 'setup.cfg' file in
the checkout.  You can supply '--find-links' on the command line to
point it at a non-standard package repository.


Running the Tests
-----------------

To test the package, you will also need the 'zope.testing' package, which
can't (yet) be automatically installed.  Eventually, you should be able to
type:

  $ /path/to/your/python setup.py test

and have it install the "testing dependencies."  Today, the workaround
is to install it manually:

  $ /path/to/easy_install --find-links="...." zope.testing

You can then run the tests (finally) from the checkout directory:

  $ /path/to/your/python test.py
    Running:
      .............
    Ran 13 tests with 0 failures and 0 errors in 0.094 seconds.


Installing a Source Distribution
--------------------------------

You can also install it from a source distribution:

  $ /path/to/easy_install --find-links="...." -eb src zope.security
  $ cd src/zope.security
  $ /path/to/your/python setup.py devel


Installing a Binary Egg
-----------------------

Install the package as a "binary egg" (which also installs its "hard"
dependencies):

  $ /path/to/easy_install --find-links="...." zope.security