| [0] | 1 | Stamper - installation instructions | 
|---|
|  | 2 | =================================== | 
|---|
|  | 3 |  | 
|---|
|  | 4 | .. contents:: | 
|---|
|  | 5 |  | 
|---|
|  | 6 | First, install dependencies | 
|---|
|  | 7 | --------------------------- | 
|---|
|  | 8 |  | 
|---|
|  | 9 | So far, the only dependency you will need in order to run stamper is Python [1]_ | 
|---|
|  | 10 |  | 
|---|
|  | 11 | Mailjam has been tested with python *2.7.x*, but it should work with versions | 
|---|
|  | 12 | *2.6.x* too. | 
|---|
|  | 13 |  | 
|---|
|  | 14 | Please, refer to your operating system package system documentation to learn | 
|---|
|  | 15 | more about how to install python. | 
|---|
|  | 16 |  | 
|---|
|  | 17 |  | 
|---|
| [4] | 18 | Second, install Stamper | 
|---|
| [0] | 19 | ----------------------- | 
|---|
|  | 20 |  | 
|---|
|  | 21 | Installing using pip/easy_install | 
|---|
|  | 22 | +++++++++++++++++++++++++++++++++ | 
|---|
|  | 23 |  | 
|---|
|  | 24 | You can install Stamper using pip [2]_:: | 
|---|
|  | 25 |  | 
|---|
|  | 26 | pip install Stamper | 
|---|
|  | 27 |  | 
|---|
|  | 28 | or easy_install [3]_:: | 
|---|
|  | 29 |  | 
|---|
|  | 30 | easy_install Stamper | 
|---|
|  | 31 |  | 
|---|
|  | 32 | Installing from sources | 
|---|
|  | 33 | +++++++++++++++++++++++ | 
|---|
|  | 34 |  | 
|---|
|  | 35 | Releases | 
|---|
|  | 36 | ******** | 
|---|
|  | 37 |  | 
|---|
|  | 38 | There are no releases yet. You will have to install it from the repository. | 
|---|
|  | 39 |  | 
|---|
|  | 40 | From repository | 
|---|
|  | 41 | *************** | 
|---|
|  | 42 |  | 
|---|
|  | 43 | The source code of Stamper is hosted in bitbucket [4]_. In order to grab | 
|---|
|  | 44 | the latest sources you need Mercurial [5]_. | 
|---|
|  | 45 |  | 
|---|
|  | 46 | To get a copy of the sources, just *clone* the repository:: | 
|---|
|  | 47 |  | 
|---|
|  | 48 | hg clone https://bitbucket.org/codigo23/stamper stamper-repo | 
|---|
|  | 49 |  | 
|---|
|  | 50 | Then, 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 |  | 
|---|
|  | 60 | You can also install it in *development mode*, which allow you to test the | 
|---|
|  | 61 | software and make changes to the sources, those changes will be available | 
|---|
|  | 62 | instantly 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 | 
|---|