Bohrium
robot
新建

空间站广场

论文
Notebooks
比赛
课程
Apps
我的主页
我的Notebooks
我的论文库
我的足迹

我的工作空间

任务
节点
文件
数据集
镜像
项目
数据库
公开
Bohrium 帮助文档｜Lebesgue Utility
Bohrium 帮助文档
LBG Utility
Bohrium 帮助文档LBG Utility
Bohrium
MileAway
发布于 2023-10-14
推荐镜像 :Basic Image:bohrium-notebook:2023-04-07
推荐机型 :c2_m4_cpu
赞
Part 1: 安装 Lebesgue Utility
卸载旧版本
安装最新版本
升级
Part 2: 首次使用
配置账号信息
附录｜使用命令行窗口对 LBG CLI 进行配置：
设置默认输出格式，
设置更新检查等级，
设置命令自动补全

Part 1: 安装 Lebesgue Utility

大部分情况下，Bohrium 镜像中已安装 Lebesgue Utility 你可以直接阅读 Part 2:首次使用

代码
文本

Lebesgue Utility（LBG Utility）或称 Lebesgue Command Line Interface（LBG CLI）是深势科技开发的一款用于资源管理、任务管理、项目监控等功能的命令行交互工具。

本文介绍 Lebesgue Utility 1.x 版的调用方法。相比于1.0 以下的版本，新版本有如下改进：

  • 说明文档更完善，所有的指令均可以加-h 查看使用说明；
  • 完善api调用部分， api部分单独抽出来命名为lbgcore，允许开发者自行调用；
  • 表格输出支持多种格式，如table，yaml，json和csv；
  • 输出均可以使用-q 或 --quite 只显示id，方便内嵌指令。
代码
文本

卸载旧版本

终端输入：

代码
文本
[3]
! pip uninstall -y lbg LebesgueUtility
Found existing installation: lbg 1.2.17
Uninstalling lbg-1.2.17:
  Successfully uninstalled lbg-1.2.17
WARNING: Skipping LebesgueUtility as it is not installed.
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv
代码
文本

安装最新版本

终端输入：

代码
文本
[4]
! pip install lbg 
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Collecting lbg
  Downloading https://pypi.tuna.tsinghua.edu.cn/packages/ba/97/0343c044adb0df59c7438a596db31221117d2c582bec51d76636da30ea79/lbg-1.2.20-py3-none-any.whl (41 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 42.0/42.0 kB 1.0 MB/s eta 0:00:00
Requirement already satisfied: pyreadline in /opt/conda/lib/python3.8/site-packages (from lbg) (2.1)
Requirement already satisfied: pyyaml in /opt/conda/lib/python3.8/site-packages (from lbg) (6.0)
Requirement already satisfied: aliyun-python-sdk-core in /opt/conda/lib/python3.8/site-packages (from lbg) (2.13.36)
Requirement already satisfied: readchar in /opt/conda/lib/python3.8/site-packages (from lbg) (4.0.3)
Requirement already satisfied: pytimeparse in /opt/conda/lib/python3.8/site-packages (from lbg) (1.1.8)
Requirement already satisfied: tqdm in /opt/conda/lib/python3.8/site-packages (from lbg) (4.64.1)
Requirement already satisfied: aliyun-python-sdk-sts in /opt/conda/lib/python3.8/site-packages (from lbg) (3.1.0)
Requirement already satisfied: argcomplete in /opt/conda/lib/python3.8/site-packages (from lbg) (2.0.0)
Requirement already satisfied: requests-toolbelt in /opt/conda/lib/python3.8/site-packages (from lbg) (0.10.1)
Requirement already satisfied: requests in /opt/conda/lib/python3.8/site-packages (from lbg) (2.28.2)
Requirement already satisfied: pyreadline3 in /opt/conda/lib/python3.8/site-packages (from lbg) (3.4.1)
Requirement already satisfied: validators in /opt/conda/lib/python3.8/site-packages (from lbg) (0.20.0)
Requirement already satisfied: pandas in /opt/conda/lib/python3.8/site-packages (from lbg) (1.5.3)
Requirement already satisfied: pyhumps in /opt/conda/lib/python3.8/site-packages (from lbg) (3.8.0)
Requirement already satisfied: oss2 in /opt/conda/lib/python3.8/site-packages (from lbg) (2.16.0)
Requirement already satisfied: colorama in /opt/conda/lib/python3.8/site-packages (from lbg) (0.4.6)
Requirement already satisfied: aliyun-python-sdk-kms in /opt/conda/lib/python3.8/site-packages (from lbg) (2.16.0)
Requirement already satisfied: packaging in /opt/conda/lib/python3.8/site-packages (from lbg) (23.0)
Requirement already satisfied: jmespath<1.0.0,>=0.9.3 in /opt/conda/lib/python3.8/site-packages (from aliyun-python-sdk-core->lbg) (0.10.0)
Requirement already satisfied: cryptography>=2.6.0 in /opt/conda/lib/python3.8/site-packages (from aliyun-python-sdk-core->lbg) (39.0.1)
Requirement already satisfied: pycryptodome>=3.4.7 in /opt/conda/lib/python3.8/site-packages (from oss2->lbg) (3.17)
Requirement already satisfied: six in /opt/conda/lib/python3.8/site-packages (from oss2->lbg) (1.16.0)
Requirement already satisfied: crcmod>=1.7 in /opt/conda/lib/python3.8/site-packages (from oss2->lbg) (1.7)
Requirement already satisfied: charset-normalizer<4,>=2 in /opt/conda/lib/python3.8/site-packages (from requests->lbg) (3.0.1)
Requirement already satisfied: certifi>=2017.4.17 in /opt/conda/lib/python3.8/site-packages (from requests->lbg) (2022.12.7)
Requirement already satisfied: idna<4,>=2.5 in /opt/conda/lib/python3.8/site-packages (from requests->lbg) (3.4)
Requirement already satisfied: urllib3<1.27,>=1.21.1 in /opt/conda/lib/python3.8/site-packages (from requests->lbg) (1.26.14)
Requirement already satisfied: python-dateutil>=2.8.1 in /opt/conda/lib/python3.8/site-packages (from pandas->lbg) (2.8.2)
Requirement already satisfied: pytz>=2020.1 in /opt/conda/lib/python3.8/site-packages (from pandas->lbg) (2022.7)
Requirement already satisfied: numpy>=1.20.3 in /opt/conda/lib/python3.8/site-packages (from pandas->lbg) (1.22.4)
Requirement already satisfied: setuptools>=41.0 in /opt/conda/lib/python3.8/site-packages (from readchar->lbg) (65.6.3)
Requirement already satisfied: decorator>=3.4.0 in /opt/conda/lib/python3.8/site-packages (from validators->lbg) (5.1.1)
Requirement already satisfied: cffi>=1.12 in /opt/conda/lib/python3.8/site-packages (from cryptography>=2.6.0->aliyun-python-sdk-core->lbg) (1.15.1)
Requirement already satisfied: pycparser in /opt/conda/lib/python3.8/site-packages (from cffi>=1.12->cryptography>=2.6.0->aliyun-python-sdk-core->lbg) (2.21)
Installing collected packages: lbg
Successfully installed lbg-1.2.20
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv
代码
文本

如出现安装过慢请尝试使用国内源：

代码
文本
[ ]
! pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ lbg
代码
文本

升级

终端输入：

代码
文本
[ ]
! pip install -U lbg
代码
文本

如出现升级过慢请尝试使用国内源：

代码
文本
[ ]
! pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ -U lbg
代码
文本

Part 2: 首次使用

代码
文本

配置账号信息

LBG CLI 将此信息存储在凭证文件中名为 ~/.lbg/lbg_cli_context.json 的配置文件（一组设置）中。 默认情况下，当您运行未明确指定要使用的配置文件的 LBG CLI 命令时，将使用此配置文件中的信息。

我们可以通过以下 Python 代码来修改此配置文件，以实现 LBG CLI 的配置：

请连接您需要使用 lbg 的项目！

代码
文本
[1]
import os
import json
import getpass
from pathlib import Path

def get_context_dir():
ctx_dir_location = os.path.expanduser('/data/.lbg/')
Path(ctx_dir_location).mkdir(parents=True, exist_ok=True)
return ctx_dir_location

def save_cli_context(email, password):
ctx_dir_location = get_context_dir()
ctx_location = os.path.join(ctx_dir_location, 'lbg_cli_context.json')
with open(ctx_location, 'w+') as f:
f.write(json.dumps({
"ACCOUNT_EMAIL": email,
"ACCOUNT_PASSWORD": password
}, indent=4))
print("配置完成！")

YOUR_EMAIL_OR_PHONE = input("请输入你的 Bohrium 账户（邮箱/手机号）：")
YOUR_PASSWORD = getpass.getpass("请输入你的 Bohrium 密码：")

save_cli_context(YOUR_EMAIL_OR_PHONE, YOUR_PASSWORD)
请输入你的 Bohrium 账户（邮箱/手机号）： quehaohui@dp.tech
请输入你的 Bohrium 密码： ········
配置完成！
代码
文本

配置完成后，开始使用 lbg 提交您的计算任务吧！

代码
文本

附录｜使用命令行窗口对 LBG CLI 进行配置：

代码
文本

您也可以通过命令行窗口对 LBG CLI 进行配置：

lbg config account

以下示例显示了示例值。如以下部分所述，将它们替换为您自己的值。(注： 密码不会在输入框中显示)

email current: [bohrium@dp.tech]: bohrium@dp.tech
password current: [*******7890]: 1234567890
代码
文本

设置默认输出格式，

输出格式默认为table，可支持table，json，csv，yaml (可选) ：

lbg config format <output_format>

所有参数输出均可通过指定格式来覆盖默认输出

参数 缩写 说明 必填
--csv - 输出为csv格式 否
--json - 输出为json格式 否
--yaml - 输出为yaml格式 否
--table - 输出为table格式 否
--noheader - 不显示头部信息，在输出格式为table或csv时生效 否
代码
文本

设置更新检查等级，

更新检查等级默认为minor，可支持major，minor，patch，ignore (可选) ：

lbg config version <version_level>
代码
文本

设置命令自动补全

您可以通过添加以下命令到rc文件里来实现lbg终端的自动补全

ZSH

将以下命令复制到~/.zshrc里, 之后终端输入 source ~/.zshrc

autoload -U bashcompinit
bashcompinit
eval "$(register-python-argcomplete lbg)"

BASH

将以下命令复制到~/.bashrc里, 之后终端输入 source ~/.bashrc

eval "$(register-python-argcomplete lbg)"
代码
文本
Bohrium 帮助文档
LBG Utility
Bohrium 帮助文档LBG Utility
点个赞吧
本文被以下合集收录
Bohrium 帮助文档｜软件案例
MileAway
更新于 2024-05-12
14 篇7 人关注
CP2K
bohr9d1500
更新于 2024-04-18
4 篇0 人关注
推荐阅读
公开
Bohrium 帮助文档｜LAMMPS
Bohrium 帮助文档LBG UtilityLAMMPS
Bohrium 帮助文档LBG UtilityLAMMPS
Bohrium
发布于 2023-10-14
1 赞6 转存文件
公开
你真的会使用命令行吗？Probably Not!（上）
POSIX
POSIX
Siyuan Liu
发布于 2023-11-07
6 赞5 转存文件1 评论