extend the installation to include the pip package

This commit is contained in:
Andreas Zweili 2019-05-31 10:57:07 +02:00
parent f7748b349a
commit 40915983e9
1 changed files with 17 additions and 12 deletions

View File

@ -27,8 +27,8 @@ On a Debian based system you can install it by copying to `~/.local/bin/`. Borg
needs to be able to get executed by calling the command `borg`. needs to be able to get executed by calling the command `borg`.
``` bash ``` bash
cp ~/Downloads/borg-linux64 ~/.local/bin/borg cp ~/Downloads/borg-linux64 ~/.local/bin/borg
chmod +x ~/.local/bin/borg chmod +x ~/.local/bin/borg
``` ```
For other systems check their For other systems check their
@ -42,9 +42,10 @@ system here: <https://github.com/borgqt/borg-qt/releases> or install it with pip
pip3 install borg-qt pip3 install borg-qt
``` ```
2. Copy the config file from docs/borg_qt.conf.example to 2. Copy the config file from
`~/.config/borg_qt/borg_qt.conf` and edit it to contain a valid path to your [docs/borg_qt.conf.example](https://github.com/borg-qt/borg-qt/blob/master/docs/borg_qt.conf.example)
BorgBackup repository and the password. Put all your changes into the to `~/.config/borg_qt/borg_qt.conf` and edit it to contain a valid path to
your BorgBackup repository and the password. Put all your changes into the
`[borgqt]` section. As of now there is no automated way to setup Borg-Qt. `[borgqt]` section. As of now there is no automated way to setup Borg-Qt.
3. Run the binary by double clicking on it or by copying it to 3. Run the binary by double clicking on it or by copying it to
@ -71,32 +72,36 @@ chmod +x ~/.local/share/applications/borg-qt.desktop
Now you should find Borg-Qt in your desktop's start menu. Now you should find Borg-Qt in your desktop's start menu.
If you installed Borg-Qt with pip you can either run `borg_qt` from the
command line or edit the desktop file to exec `borg_qt` instead of the full
path.
## Development ## Development
To start working on Borg-Qt first clone the git repository and install To start working on Borg-Qt first clone the git repository and install
BorgBackup as described in [Prerequisites]. BorgBackup as described in [Prerequisites].
```bash ```bash
git clone https://github.com/borg-qt/borg-qt.git git clone https://github.com/borg-qt/borg-qt.git
``` ```
Now create a virtual environment. Now create a virtual environment.
```bash ```bash
cd borg-qt cd borg-qt
python3 -m venv venv python3 -m venv venv
``` ```
And activate it. And activate it.
```bash ```bash
source venv/bin/activate source venv/bin/activate
``` ```
Finally you can install Borg-Qt and it's dependencies. Finally you can install Borg-Qt and it's dependencies.
```bash ```bash
pip3 install -e . pip3 install -e .
``` ```
You're now all set to work on Borg-Qt. It's a good idea to run the tests before You're now all set to work on Borg-Qt. It's a good idea to run the tests before
@ -104,7 +109,7 @@ starting. You can do this with the following command from the root of the
repository. repository.
```bash ```bash
make test make test
``` ```
To make testing the application while programming a bit easier there's a script To make testing the application while programming a bit easier there's a script
@ -113,7 +118,7 @@ directory. You to use it run the following command from the root of the
repository. repository.
```bash ```bash
./scripts/debugging.sh ./scripts/debugging.sh
``` ```
### ToDos ### ToDos