python-tatuclient/doc/source/installation.rst
algerwang 83d4cea57f Update github's URL
Old URL is https://github.com/stackforge/python-designateclient
    or git@github.com:stackforge/python-designateclient.git.

But now is https://github.com/openstack/python-designateclient
    or git@github.com:openstack/python-designateclient.git
Closes-Bug: #1486337

Change-Id: I1f3d0b90b22295ad9cce9c2f05d9993935d07f70
2015-08-19 18:31:49 +08:00

46 lines
1.5 KiB
ReStructuredText

============
Installation
============
Install the client from PyPI
----------------------------
The :program:`python-designateclient` package is published on `PyPI`_ and so can be installed using the pip tool, which will manage installing all
python dependencies:
.. code-block:: shell-session
pip install python-designateclient
*Warning: the packages on PyPI may lag behind the git repo in functionality.*
Setup the client from source
----------------------------
If you want the latest version, straight from github:
.. code-block:: shell-session
git clone git@github.com:openstack/python-designateclient.git
cd python-designateclient
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
python setup.py install
Setup the client in development mode
------------------------------------
Installing in development mode allows your to make changes to the source code & test directly without having to re-run the "python setup.py install"
step. You can find out more about `Development Mode`_
.. code-block:: shell-session
git clone git@github.com:openstack/python-designateclient.git
cd python-designateclient
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
python setup.py develop
.. _Development Mode: http://pythonhosted.org/distribute/setuptools.html#development-mode
.. _PyPI: https://pypi.python.org/pypi/python-designateclient/