diff options
author | Chandan Singh <chandan.devel@gmail.com> | 2018-08-24 12:01:56 +0000 |
---|---|---|
committer | Chandan Singh <chandan.devel@gmail.com> | 2018-08-24 12:01:56 +0000 |
commit | 2c3a6ab8ad478314154716a2b1918ce1b867cc49 (patch) | |
tree | 8a6315909d16407e45dd284d6cd31e9d00b3b5ab | |
parent | dfee6d75d2a5a9ac501718b4f91b497dea580cf7 (diff) | |
parent | 923bfaeca0d90e335b6cb24a2297d3c0e42275b3 (diff) | |
download | buildstream-2c3a6ab8ad478314154716a2b1918ce1b867cc49.tar.gz |
Merge branch 'chandan/pip-install-instructions' into 'master'
doc: Add instructions to install BuildStream via PyPI
See merge request BuildStream/buildstream!717
-rw-r--r-- | doc/source/install_linux_distro.rst | 41 |
1 files changed, 36 insertions, 5 deletions
diff --git a/doc/source/install_linux_distro.rst b/doc/source/install_linux_distro.rst index 0d21bfd46..8a0d536e0 100644 --- a/doc/source/install_linux_distro.rst +++ b/doc/source/install_linux_distro.rst @@ -152,8 +152,29 @@ for advice on this. Installing ~~~~~~~~~~ -Once you have the base system dependencies, you can clone the BuildStream -git repository and install it as a regular user:: +Once you have the base system dependencies, you can install the BuildStream +python package as a regular user. + +Via PyPI (recommended) +++++++++++++++++++++++ +:: + + pip3 install --user BuildStream + +This will install latest stable version of BuildStream and its pure python +dependencies into your user's homedir in ``~/.local``. + +Keep following the instructions below to ensure that the ``bst`` +command is in your ``PATH`` and to enable bash completions for it. + +.. note:: + + If you want a specific version of BuildStream, you can install it using + ``pip install --user BuildStream==<version-number>`` + +Via Git checkout +++++++++++++++++ +:: git clone https://gitlab.com/BuildStream/buildstream.git cd buildstream @@ -206,9 +227,19 @@ to your ``~/.bash_completion``: Upgrading BuildStream ~~~~~~~~~~~~~~~~~~~~~ -Assuming you have followed the default instructions above, all -you need to do to upgrade BuildStream is to update your local git -checkout:: + +Via PyPI +++++++++ + +If you installed BuildStream from PyPI, you can update it like so:: + + pip install --user --upgrade BuildStream + +Via Git checkout +++++++++++++++++ + +If you installed BuildStream from a local git checkout using ``-e`` option, all +you need to do to upgrade BuildStream is to update your local git checkout:: cd /path/to/buildstream git pull --rebase |