Installation¶
We assume that you have prepared your system (see Section _my-reference-label) on which you like to install the cloudmesh client. We recommend that you use python 2.7.10, pip 7.1.2 and use virtualenv. Furthermore we recommend that on Linux systems you have readline installed as it is a convenient tool for command line manipulation. In the next sections we will walk you through a setup that has been proven to work for developers and users and is very easy to replicate.
Install Cloudmesh Client via pip¶
Warning
The instalation with pip is not yet working at this time. Please use the instalation from source
Users can install the cloudmesh client via pip
pip install cloudmesh_client
Cloudmesh Installation from Source¶
Developers that wish to contribute to the source can obtain the code from github. We assume that we conduct a source code install into the directory:
~/github/cloudmesh
If you like to use a different directory, that is also possible, but the instructions we provide here assumes are targeted towards this base directory.
Please use the following commands
mkdir -p github/cloudmesh cd github/cloudmesh git clone https://github.com/cloudmesh/base.git git clone https://github.com/cloudmesh/client.git cd base python setup.py install cd ../client python setup.py install
Updating an existing source distribution¶
During the development phase of cloudmesh you may need to update the code from source, as cloudmesh client uses three different repositories please do not forget to update them accordingly
export CLOUDMESH_HOME=$HOME/github/cloudmesh cd $CLOUDMESH_HOME/base git pull python setup.py install cd $CLOUDMESH_HOME/client python setup.py install
Testing¶
Todo
This section is incomplete and we need to make sure that tox works. We also need to explain how travis works and how we can run nosetests locally
For now we do not assume that you need to run any tests after you install the source. We will address deployment tests later.
pip install tox
in the source dir say
tox
Nose tests can be started with
nosetests