diff options
| author | Chandan Singh <csingh43@bloomberg.net> | 2018-08-23 23:23:45 +0100 |
|---|---|---|
| committer | Chandan Singh <chandan.devel@gmail.com> | 2018-08-24 11:22:33 +0000 |
| commit | 923bfaeca0d90e335b6cb24a2297d3c0e42275b3 (patch) | |
| tree | 8a6315909d16407e45dd284d6cd31e9d00b3b5ab | |
| parent | dfee6d75d2a5a9ac501718b4f91b497dea580cf7 (diff) | |
| download | buildstream-923bfaeca0d90e335b6cb24a2297d3c0e42275b3.tar.gz | |
doc: Add instructions to install BuildStream via PyPI
Add instructions to install and update BuildStream python package via
PyPI, and also make it the recommended method.
Part of https://gitlab.com/BuildStream/buildstream/issues/587.
| -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 |