Liberty CLI

项目 | 代码 | 问题追踪 | PyPI

Liberty CLI 是一个面向用户的命令行客户端，用于与Librem One或其他Liberty Deckplan Host (LDH)交互。

深入了解https://liberty.one以获取LDH设计和开发信息。

安装

安装Liberty CLI的首选方式是使用您的包管理器。推荐包名为 ldh-client。例如

sudo apt install ldh-client  # Debian-based

或

pipx install ldh-client  # Python-based

用法

以下命令可用

# INFO
liberty show info

# TUNNEL
liberty setup tunnel

要获取说明和选项，请添加 --help，例如

liberty setup tunnel --help

原型快速入门

要从头在PureOS或其他基于Debian的系统上安装原型组件

sudo apt install pipx
pipx ensurepath
pipx install ldh-client
liberty setup dependencies  # triggers sudo prompt
liberty setup prototype

更新原型

pipx upgrade ldh-client  # or pipx upgrade-all
liberty setup dependencies  # triggers sudo prompt
liberty setup prototype

删除原型

liberty remove dependencies  # optional, triggers sudo prompt
liberty remove prototype
pipx uninstall ldh-client
sudo apt remove pipx  # optional

安装（从源代码）

如果您想从源代码运行...

1. 安装Python 3.x和pipenv。（有关教程，请参阅https://docs.pipenv.org/install/。）

2. 安装必备软件

    sudo apt install gir1.2-goa-1.0 libcairo2-dev /
    libgirepository1.0-dev libssl-dev /
    network-manager-openvpn-gnome python3-dev
   

3. 安装可选必备软件

    sudo apt install rclone yad
   

4. 获取源代码

    git clone https://source.puri.sm/liberty/tool/client.git ldh_client
   

5. 使用pipenv安装

    cd ldh_client
    pipenv install --dev -e .
   

用法（从源代码）

cd ldh_client
pipenv run liberty show info

原型快速入门（从源代码）

确保~/.local/bin在您的$PATH中

sudo apt install pipx
pipx ensurepath
# pipx is used only to set the path
# you may prefer to modify your .bashrc or some other method

按照从源代码的说明操作，然后按以下方式创建liberty-dev可执行文件

cd ldh_client/liberty-dev
./bootstrap
# creates ~/.local/bin/liberty-dev and associated symlinks
# re-run this any time you move the ldh_client folder

现在安装原型组件

liberty-dev setup dependencies
liberty-dev setup prototype --dev

请注意，setup prototype总是覆盖现有的原型组件。这意味着您可以选择liberty或liberty-dev中的任意一个，但不能同时选择两者。

要删除原型组件和liberty-dev

liberty-dev remove dependencies  # optional, triggers sudo prompt
liberty-dev remove prototype
cd ldh_client/liberty-dev
./remove

故障排除

在调试、故障排除或请求帮助时，请包括以下输出

liberty show info

或

liberty show info --gui
# the same information in a graphical window (supports copy-and-paste)

根据需要将liberty替换为pipenv run liberty或liberty-dev。

构建wheel包（可选上传）

按照以下说明将Liberty CLI作为Python包构建

git clone https://source.puri.sm/liberty/tool/client.git ldh_client
cd ldh_client
pipenv install --dev
pipenv shell
# optionally edit default.strict.yaml
python setup.py sdist bdist_wheel

如果一切按预期进行，您应该会得到以下文件

• dist/ldh_client-<版本>-py3-none-any.whl
• dist/ldh_client-<版本>.tar.gz

现在您可以选择使用twine将创建的Python包上传到PyPI。

twine upload dist/*

分享和贡献

Liberty CLI（LDH客户端）
https://source.puri.sm/liberty/tool/client
版权所有 2018-2020 Purism SPC
SPDX-License-Identifier: AGPL-3.0-or-later

在AGPL-3.0-or-later下共享。我们不修改Community Covenant 1.0，并根据DCO 1.1使用签署的-by行进行来源认证。欢迎在相同条款下做出贡献。

有关详细信息，请参阅

• COPYING.AGPL.md，完整许可文本
• CODE_OF_CONDUCT.md，完整行为文本
• CONTRIBUTING.DCO.md，完整来源文本（git -s）