benten

弯曲

这是通用工作流语言文档的语言服务器。

特征

（单击要功能屏幕截图画廊）

• 语法突出显示（CWL和JS）
• 评估悬停的表达
• 文件路径在run字段中的链接文件自动完成
• 端口完成工作流程
• 导航到链接的子工作流，包括（跳至定义）
• 轮廓视图（符号） +步骤符号
• 类型验证
• 端口验证
• 悬停在悬停的语言文档

Benten是使用Python3编写的，并根据VS代码开发。语言服务器组件将与提供语言服务器支持的任何编辑器/IDE一起使用。语法突出显示目前仅适用于VS代码扩展名。 VS代码扩展名是用打字稿编写的。

安装VS代码扩展

在市场上搜索“弯曲”。客户扩展名的名称是Rabix/Benten。遵循通常的方法安装扩展名。

如果您尚未分别安装Benten Server（请参见下文），则客户端将尝试从GitHub版本页面找到并下载匹配的服务器版本。

服务器安装

Benten需要Python 3.7或更高版本

如果您要从源安装，则需要在系统上进行git

使用pipx

在虚拟env中安装benten的一种整洁的方法（将其与系统隔离），并且仍然能够称其为常规可执行文件是使用pipx

 pip3 install pipx  # in case you don't have pipx
pipx ensurepath # ensures CLI application directory is on your $PATH

现在您可以安装Benten

 pipx install benten

如果您已经安装了Benten，则可以升级

 pipx upgrade benten

如果您的基本python安装早于3.7，您可以告诉pipx使用3.7用于Benten

 pipx install benten --python python3.7

笔记：

1. pipx在$HOME/.local/bin （ %HOMEPATH%.localbin for Windows）中安装可执行文件。需要将其添加到您的路径env变量中。 pipx ensurepath为您做到这一点
2. pipx install可以在另一个虚拟环境中完成。当您拥有不兼容的全球版本Python时，这将很有帮助，但您希望保留但仍然想安装Benten。您可以使用python> 3.7创建虚拟env，并从那里调用安装命令。
3. 如果使用VS代码，则加载CWL文件后安装服务器，则必须重新启动VS代码。

Ubuntu Linux的特殊说明

 sudo apt install python3-pip python3-venv

注意Windows

如果您试图使用运行服务器在Windows上重新安装或更新服务器（例如，由于运行VS代码），则必须在更新之前关闭服务器（例如，通过退出VS代码）关闭服务器。

直接从GitHub安装版本

从主分支机构安装

 pipx install git+https://github.com/rabix/benten.git

从开发分支（或其他一些分支）安装：

 pipx install git+https://github.com/rabix/benten.git@develop

或者，如果您将存储库克隆并想使用服务器代码本身：

 pipx install -e benten  # benten is the name of the directory with the cloned code

使用VI/VIM

请参阅此页面。

悬停的表达评估

悬停在表达式上将显示评估的结果或遇到的任何错误。 Benten自动生成样本过程输入，输出和中间输出（如果该过程是工作流程）。请注意，这些都是随机生成的样本数据，用于快速理智地检查表达式。

过度骑行自动生成的样本数据

当请求评估时，按需自动生成样本数据。生成的示例数据也存储在刮擦文件中。在任何表达式上，可以单击“转到定义”来访问此刮擦文件。通常，每次使用新的，随机生成的数据都会覆盖此文件。

如果您想自定义一些示例数据（例如，您要在编码工作流时检查特定的测试用例），如果添加字符串（确切）

 #custom

到示例数据文件的第一行，Benten将停止覆盖文件，而是使用此自定义文件的内容。

一旦将此行添加到示例数据文件中，Benten将不再覆盖此文件。如果您希望将测试数据重新生成（例如，您更改了CWL的输入架构），则需要删除第一个哨兵线，而Benten将重新生成输入。

其他技巧和技巧

Benten附加到您的常规文本编辑器上，并通过自动完成和文档验证提供帮助，因此其大多数功能都是通过编辑器的常规UI自然暴露的，并且无需专门的教程，但是本页中列出了一些有用的提示和技巧。

对于开发人员

查看开发文档

执照

Apache 2.0

致谢

Peter Amstutz用于Pyinstaller公式和VS代码扩展程序上的自动下载功能。

彼得·范·赫斯登（Peter van Heusden）进行了弯曲的康达分布。

低级别的客户端服务器通信代码来自SourceGraph的Python语言服务器（VS代码客户端代码（最初是基于Microsoft的示例代码））。 CWL预览使用vis.js

名字叫什么？

萨拉斯瓦蒂（Saraswati）是印度教的学习和知识女神，很久以前，她访问了日本，在那里她被称为Benzaiten（简称Benten ），她的Sitar已变成了日本的Biwa ，但她保留了许多手臂。

Benzaiten是所有流动的女神：水，时间，言语，言语，口才，音乐和扩展，知识。因此， Benten是科学工作流程开发人员的合适女神。

参考

• Wikipedia页面
• Benzaiten（Benten）：日本的理性女神 - 更详细的历史

---

_{（c）2019-2021七个桥梁基因组学。 Rabix是七个桥梁基因组学的注册商标}