source: stamper/INSTALL@ 2:f8d231582a58

Last change on this file since 2:f8d231582a58 was 0:4cc6fc51063c, checked in by Borja Lopez <borja@…>, 10 years ago

Initial commit, including basic structure of the project and initial features

File size: 1.8 KB
Line 
1Stamper - installation instructions
2===================================
3
4.. contents::
5
6First, install dependencies
7---------------------------
8
9So far, the only dependency you will need in order to run stamper is Python [1]_
10
11Mailjam has been tested with python *2.7.x*, but it should work with versions
12*2.6.x* too.
13
14Please, refer to your operating system package system documentation to learn
15more about how to install python.
16
17
18Second, install Mailjam
19-----------------------
20
21Installing using pip/easy_install
22+++++++++++++++++++++++++++++++++
23
24You can install Stamper using pip [2]_::
25
26 pip install Stamper
27
28or easy_install [3]_::
29
30 easy_install Stamper
31
32Installing from sources
33+++++++++++++++++++++++
34
35Releases
36********
37
38There are no releases yet. You will have to install it from the repository.
39
40From repository
41***************
42
43The source code of Stamper is hosted in bitbucket [4]_. In order to grab
44the latest sources you need Mercurial [5]_.
45
46To get a copy of the sources, just *clone* the repository::
47
48 hg clone https://bitbucket.org/codigo23/stamper stamper-repo
49
50Then, go inside the *stamper-repo* directory and run::
51
52 python setup.py install
53
54.. warning::
55
56 If you want to install it *system-wide*, probably you will need *root*
57 privileges (check your OS documentation to learn more about how to get
58 *root* privileges - for example using sudo [6]_)
59
60You can also install it in *development mode*, which allow you to test the
61software and make changes to the sources, those changes will be available
62instantly for using/testing::
63
64 python setup.py develop
65
66
67.. [1] http://python.org
68.. [2] http://www.pip-installer.org/en/latest/index.html
69.. [3] http://peak.telecommunity.com/DevCenter/EasyInstall
70.. [4] https://bitbucket.org/codigo23/stamper
71.. [5] http://mercurial.selenic.com
72.. [6] http://sudo.ws
Note: See TracBrowser for help on using the repository browser.