Deno を始める - 第7回 (All in one な deno のサブコマンド)

ここまで Deno の様々な機能を見てきました。今回は、Deno のツール(サブコマンド)について見ていきます。

第1回でも軽く紹介したように、deno CLI は多くのサブコマンドを提供しています。表にして本連載で取り上げたものは該当の箇所にリンクを貼ってみました。

Node.js でいうと node / npm コマンドに加え、複数のサードパーティ製 npm パッケージをインストールし、設定ファイルをいくつか書いて整うレベルの機能が最初から揃っています。実際、install サブコマンドも第6回の deployctl まで使う機会がありませんでした^[1]。

以下、これまで触れていなかったサブコマンドのいくつかを軽く見てみましょう。

JavaScript / TypeScript のフォーマッタです。JSX/TSX、JSON に加えて Markdown 中のコードブロックのフォーマットにも対応しています。

deno fmt で実際にカレントディレクトリのファイルをフォーマットします。
--check オプションをつけるとフォーマット箇所をプレビューできます。

deno fmt | Manual | Deno

REPL(read-eval-print-loop) を使うとコードスニペットの動作を素早く確認できます。TypeScript にも対応していますが、型チェックは行われず JavaScript にトランスパイルされ実行されます。

deno repl | Manual | Deno

JavaScript / TypeScript の Linter です。deno_lint docs にあるルールに基づいて静的コード分析を行います。

deno lint | Manual | Deno

JavaScript / TypeScript コードをテストするための組み込みのテストランナーです。テストコードは Deno.test API と assert 用のライブラリを使用して書きます。

import { assertEquals } from "https://deno.land/std@0.165.0/testing/asserts.ts";

// Compact form: name and function
Deno.test("hello world #1", () => {
  const x = 1 + 2;
  assertEquals(x, 3);
});

Testing | Manual | Deno

テスト実行時に --coverage オプションをつけてカバレッジ情報を出力しておけば、coverage サブコマンドでカバレッジを視覚的に確認したり、カバレッジレポートを作成したりできます。

Coverage | Manual | Deno

JSDoc 形式のコメントを書いておくと、deno doc コマンドでドキュメントを生成できます。

deno doc | Manual | Deno

Deno のスクリプトを自己実行可能なシングルバイナリにコンパイルします。現状不安定版の機能です。

メッセージを表示するだけの Deno のコードをコンパイルしてサイズを確認すると 94Mbyte でした。

deno compile https://deno.land/std/examples/welcome.ts

$ ls -lh welcome
-rwxrwxrwx  1 masahiro-kondo  staff    94M 11 25 11:29 welcome

Deno をライブラリとしてスタティックリンクしているようです。Worker が使えないなどの制約があり、サイズは大きいですがシングルバイナリとして配布できるのが嬉しいケースもあるかもしれません。

deno compile | Manual | Deno

シェルで Deno のコマンドを補完してくれる設定を出力します。筆者は ohmyzsh を使っているので以下のように plugins 配下に設定を書き出しました。

mkdir ~/.oh-my-zsh/custom/plugins/deno
deno completions zsh > ~/.oh-my-zsh/custom/plugins/deno/_deno

.zshrc に以下のように deno plugin を追加しました。

plugins=(git deno)

これでコマンド入力途中に TAB キーで保管してくれたり候補を出したりしてくれるようになります。

Set Up Your Environment | Manual | Deno

Deno ランタイムの TypeScript 型定義を表示するサブコマンドです。型定義ファイルを作成して利用できます。

deno types > lib.deno.d.ts

Deno はビルトインの最適化されたツールをサブコマンドとして提供しており、deno CLI と 公式の VS Code 拡張をインストールするだけで環境が整います。これも開発体験のよさにつながっていると思います。

この連載執筆で Deno に入門してエコシステムを理解しつつあるので、アプリやライブラリを書いていきたいと思っています。

連載はこれで終了ですが、また Deno 関連の面白い話題があったらブログ記事などで取り上げていこうと思います。