Jump to content

Installing pmbootstrap: Difference between revisions

From postmarketOS Wiki
Add page "Installing pmbootstrap"
 
Test installation: zsh needs zprofile
Line 17: Line 17:
  pmbootstrap --version
  pmbootstrap --version


If this returns something like <code>pmbootstrap: command not found</code> instead of a version number, ensure that the following lines are in <code>~/.profile</code>, then open a new terminal and try again
If this returns something like <code>pmbootstrap: command not found</code> instead of a version number, ensure that the following lines are in <code>~/.profile</code> (zsh: <code>~/.zprofile</code>), then open a new terminal and try again.
  # set PATH so it includes user's private bin if it exists
  # set PATH so it includes user's private bin if it exists
  if [ -d "$HOME/.local/bin" ] ; then
  if [ -d "$HOME/.local/bin" ] ; then

Revision as of 21:25, 27 August 2018

Installing Manually

Download pmbootstrap

git clone https://gitlab.com/postmarketOS/pmbootstrap.git

Create a link

If the directory ~/.local/bin does not already exist, create it with

mkdir --parents ~/.local/bin

Create a symbolic link in ~/.local/bin named pmbootstrap

ln -s "$PWD/pmbootstrap/pmbootstrap.py" ~/.local/bin/pmbootstrap

Test installation

To test that pmbootstrap is installed correctly, open a new terminal and run

pmbootstrap --version

If this returns something like pmbootstrap: command not found instead of a version number, ensure that the following lines are in ~/.profile (zsh: ~/.zprofile), then open a new terminal and try again.

# set PATH so it includes user's private bin if it exists
if [ -d "$HOME/.local/bin" ] ; then
    PATH="$HOME/.local/bin:$PATH"
fi

Tab Completion

TODO TODO: This is not yet implemented, watch !1656

Tab completion is an optional feature that saves you time by automatically filling in the rest of a command when you press the tab key. You can also see a list of possible commands by double pressing the tab key.

Install argcomplete with

pip3 install --user argcomplete

Next, do one of the following depending on the shell you use:

Note Note: The following assumes you run pmbootstrap with pmbootstrap. If you use pmbootstrap.py, use that instead

Bash

Add the following line to ~/.bashrc:

eval "$(register-python-argcomplete pmbootstrap)"

Then reload your configuration by opening a new terminal or by running source ~/.bashrc.

Zsh

Add the following lines to ~/.zshrc:

autoload bashcompinit
bashcompinit
eval "$(register-python-argcomplete pmbootstrap)"

Then reload your configuration by opening a new terminal or by running source ~/.zshrc.