benten

ベンテン

これは、一般的なワークフロー言語文書の言語サーバーです。

特徴

（機能スクリーンショットギャラリーをクリックしてください）

• 構文ハイライト（CWLおよびJS）
• ホバーで発現を評価します
• runフィールドのリンクファイルのファイルパスオートコンプリート
• ワークフローのポート完了
• リンクされたサブワークフローに移動し、（定義へのジャンプ）を含む
• アウトラインビュー（シンボル） +ステップシンボル
• タイプ検証
• ポート検証
• ホバーに言語ドキュメントを表示します

BentenはPython3を使用して記述され、VSコードに対して開発されました。言語サーバーコンポーネントは、言語サーバーのサポートを提供する任意のエディター/IDEで動作します。構文ハイライトは現在、VSコード拡張機能でのみ利用可能です。 VSコード拡張機能は、TypeScriptで記述されています。

対コード拡張子をインストールします

市場で「ベンテン」を検索します。クライアント拡張機能の名前はRabix/Bentenです。拡張機能をインストールするには、通常の方法に従ってください。

Bentenサーバーを個別にインストールしていない場合（以下を参照）、クライアントはGitHubリリースページから一致するサーバーバージョンを見つけてダウンロードしようとします。

サーバーのインストール

BentenにはPython 3.7以降が必要です

ソースからインストールする場合は、システムにGitが必要になります

PIPXを使用します

benten仮想ENV（システムPythonから分離）にインストールし、通常の実行可能ファイルとして呼び出すことができるきちんとした方法は、 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を使用するように指示できます。

 pipx install benten --python python3.7

注：

1. pipx 、実行可能ファイルを$HOME/.local/bin （ %HOMEPATH%.localbin for windows）にインストールします。これは、Path env変数に追加する必要があります。 pipx ensurepath
2. pipx install 、別の仮想環境内から実行できます。これは、互換性のないグローバルバージョンのPythonを持っている場合に役立ちます。 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

Develop Branch（または他のブランチ）からインストールするには：

 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

謝辞

Pyinstaller式のPeter AmstutzとVSコード拡張機能の自動ダウンロード機能。

ベンテン・コンディングの配布のためのピーター・ヴァン・ハウスデン。

低レベルのクライアントサーバー通信コードは、VSコードクライアントコード（元々Microsoftの例コード外）と同様に、SourceGraphの（現在の廃止）Python言語サーバーから取得されます。 CWLプレビューはVIS.JSを使用します

名前は何ですか？

サラスワティは学習と知識のヒンドゥー教の女神であり、昔、彼女は日本を訪れました。そこではベンザテンとして知られています（略してベンテン）。

ベンザテンは、水、時間、言葉、スピーチ、雄弁さ、音楽、さらには知識など、流れるすべての女神です。したがって、 Bentenは科学的なワークフロー開発者にとって適切な女神です。

参照

• ウィキペディアページ
• ベンザイテン（ベンテン）：日本の理性の女神 - はるかに詳細な歴史

---

_{（c）2019-2021セブンブリッジゲノミクス。 Rabixは、Seven Bridges Genomicsの登録商標です}