1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
:orphan:
.. _installing:
BuildStream on your host
========================
Until BuildStream is available in your distro, there are a few hoops to jump
through to get started.
If your system cannot provide the base system requirements for BuildStream,
then we have some instructions below which can get you started using BuildStream
within a Docker container.
System requirements
-------------------
BuildStream requires the following base system requirements:
* python3 >= 3.4
* ruamel.yaml python library
* PyGObject introspection bindings
* OSTree >= v2017.8 with introspection data
Note that ``ruamel.yaml`` is a pure python library which is normally
obtainable via pip, however there seems to be some problems with installing
this package so we recommend installing it with your package manager first.
For the purpose of installing BuildStream while there are no distro packages,
you will additionally need:
* pip for python3 (only required for setup)
* Python 3 development libraries and headers
* git (to checkout buildstream)
Here are some examples of how to prepare the base requirements on
some distros.
Arch
~~~~
Install the dependencies with:
sudo pacman -S python python-pip python-gobject git \
ostree bubblewrap python-ruamel-yaml
Debian Stretch
~~~~~~~~~~~~~~
With stretch, you first need to ensure that you have the backports repository
setup as described `here <https://backports.debian.org/Instructions/>`_
By adding the following line to your sources.list::
deb http://ftp.debian.org/debian jessie-backports main
And then running::
sudo apt-get update
At this point you should be able to get the system requirements with::
sudo apt-get install \
python3-dev python3-pip git python3-gi \
python3-ruamel.yaml bubblewrap
sudo apt-get install -t stretch-backports \
gir1.2-ostree-1.0 ostree
Debian Buster or Sid
~~~~~~~~~~~~~~~~~~~~
For debian unstable or testing, only the following line should be enough
to get the base system requirements installed::
sudo apt-get install \
python3-dev python3-pip git \
python3-gi gir1.2-ostree-1.0 ostree \
bubblewrap python3-ruamel.yaml
Fedora
~~~~~~
For recent fedora systems, the following line should get you the system
requirements you need::
dnf install -y bubblewrap fuse git python3-gobject \
python3-psutil ostree python3-ruamel-yaml
User installation with pip
--------------------------
Once you have the base system dependencies, you can clone the BuildStream
git repository and install it as a regular user::
git clone https://gitlab.com/BuildStream/buildstream.git
cd buildstream
pip3 install --user .
This will install buildstream and it's pure python dependencies directly into
your user's homedir in ``~/.local``
If you are installing as a developer and want to easily test changes
or if you would like to update your BuildStream installation via git,
then you can specify the ``-e`` option when invoking pip::
pip3 install --user -e .
.. warning::
This will run BuildStream directly from your git checkout and will break
if you ever move the git checkout or run ``git clean -xdf``.
Adjust PATH
~~~~~~~~~~~
Since BuildStream is now installed under your local user's install directories,
you need to ensure that ``PATH`` is adjusted.
A regular way to do this is to add the following line to the end of your ``~/.bashrc``::
export PATH=${PATH}:~/.local/bin
Bash Completions
~~~~~~~~~~~~~~~~
Bash completions are supported by sourcing the ``buildstream/data/bst``
script found in the BuildStream repository. On many systems this script
can be installed into a completions directory but when installing BuildStream
without a package manager this is not an option.
To enable completions for an installation of BuildStream you
installed yourself from git, just append the script verbatim
to your ``~/.bash_completion``:
.. literalinclude:: ../../buildstream/data/bst
:language: yaml
Upgrading with pip
~~~~~~~~~~~~~~~~~~
To upgrade a previously install BuildStream, you will need to pull the latest
changes and reinstall as such::
pip3 uninstall buildstream
cd buildstream
git pull --rebase
pip3 install --user .
|
