ec/INSTALLING at master · KenKundert/ec · GitHub

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
84
85
86
87
88
89
90
91
92
93
94
95
96
Introducing ec
==============
This is ec, a version of ec that is provided for use with newer versions of
python. This version of ec requires python 2.6 or later and the docutils
package. Another version of ec called ec0 is available that has been tested to
work on python 2.3 or later and does not require docutils.  If you have a
choice, it is recommended that you used the normal version of ec.  That version
more likely to be updated and enhanced. If you don't have a recent version of
python, you can install it from source (not as difficult as it sounds,
directions are given below).  However, if that is not your thing; ec0 is the
version for you (once installed, it masquerades as ec).

ec is available from https://github.com/KenKundert/ec.
ec0 is available from https://github.com/KenKundert/ec0.

To download ec, use either:
    $ git clone git://github.com/KenKundert/ec.git
Using git allows you to get updates using:
    $ git pull
Alternatively, you can download the source as a tar or zip file by visiting
https://github.com/KenKundert/ec0/downloads or by running:
    $ wget --no-check-certificate https://github.com/KenKundert/ec/tarball/master
    $ tar zxf master
    $ rm -rf master ec
    $ mv KenKundert-ec-* ec

Once you have your copy of ec, test it with
    $ ./test
All tests should pass. Then you can install it using
    $ ./install
It will install the program into ~/.local. This occasionally fails due to a time
out, if this happens simply try again.  If it fails because docutils is
missing, follow the instructions for installing docutils given below.

Both the program and a man page are installed. You do not need root access to
install into ~/.local, but in doing so it is only easily accessible by you and
you will need to add ~/.local/bin to your PATH. Alternatively, you can edit
./install and remove the '--user' option.  That will cause EC to be installed so
that it is accessible to all users without having to change their PATH, but it
requires that you be root when you run the ./install command.

Installing Python from Source
=============================
If you do not have a recent version of Python installed on your machine, you can
install a copy even if you do not have root access.

These instructions assume that the source will be placed in ~/packages and the
binaries will be placed in ~/.local. You will need to adapt the instructions
accordingly if you want to place the files in different places. You should also
adapt the instructions so as the get the latest available versions for python
and setuptools.

Getting python ...
    $ mkdir -p ~/packages/python
    $ cd ~/packages/python
    $ wget http://www.python.org/ftp/python/2.7.3/Python-2.7.3.tgz

Making python ...
    $ tar zxf Python-2.7.3.tgz
    $ cd Python-2.7.3
    $ ./configure --prefix=$HOME/.local
    $ make
    $ make install
    $ cd ..

To use this version of python, you should put ~/.local/bin on your path. It must
be early on your path so that by default you get this version of python (run
'which python' to confirm).

Then you should install setuptools
    $ wget "http://pypi.python.org/packages/source/s/setuptools/setuptools-0.6c11.tar.gz"
    $ tar zxf setuptools-0.6c11.tar.gz
    $ cd setuptools-0.6c11
    $ python setup.py install --prefix=$HOME/.local
    $ cd ..

Installing Docutils
===================
If you have root access and you are using the system version of python, then you
can install docutils simply with
    # yum install python-docutils

If you are using the version of python you installed from source, then you
already have easy_install, and so getting docutils is accomplished with
    $ easy_install docutils

If you are using the system version of python and do not have root access, then
you can install it locally as follows:
    $ wget http://peak.telecommunity.com/dist/ez_setup.py
    $ python ez_setup.py --prefix=$HOME/.local
At this point it will likely complain about the destination directory not
existing. Create it with:
    $ mkdir -p <dir>
    $ python ez_setup.py --prefix=$HOME/.local
Finally, you install docutils with:
    $ easy_install --prefix=$HOME/.local docutils