dlinkでモジュールを管理する

dlink by keroxp.iconを使うとDenoのURLモジュールの管理が楽になります

https://github.com/keroxp/dlink

インストール

code:bash

$ deno install --allow-read --allow-write --allow-net　dlink https://deno.land/dlink/dlink.ts

$ dlink -V

0.6.0

使い方

code:bash

$ cd path/to/project

$ dlink

./modules.json not found. Creating skeleton...

Linked: https://deno.land/std@v0.35.0/testing/asserts.ts -> ./vendor/https/deno.land/std/testing/asserts.ts

dlinkをインストールした後、Denoプロジェクトのルートディレクトリでdlinkコマンドを実行すると、以下のようなmodules.jsonファイルが生成されます

code:modules.json

{

"https://deno.land/std": {

"version": "@v0.35.0",

"modules": "/testing/asserts.ts"

}

またリモートモジュールのエイリアスがvendorディレクトリに生成されます

code:dir

vendor/

https/

deno.land/

std/

testing/

asserts.ts

エイリアスファイルは以下のようになっています

code:vendor/https/deno.land/std/testing/mod.ts

export * from "https://deno.land/std@v0.19.0/testing/mod.ts"

これはES ModulesのExport Aggregationという機能で、exportをリダイレクトしてくれます

importする側からは、このファイルをimportします

code:test.ts

import * as asserts from "./vendor/https/deno.land/std/testing/asserts.ts"

このエイリアスファイルをimportすることで、バージョンを省略してimport出来るようになります

バージョンアップ

モジュールのバージョンを上げたいときは、modules.jsonを直接編集してdlinkを実行します

code:modules.json

{

"https://deno.land/std": {

"version": "@v0.36.0",

"modules": "/testing/asserts.ts"

}

code:bash

$ dlink

Linked: https://deno.land/std@v0.36.0/testing/asserts.ts -> ./vendor/https/deno.land/std/testing/asserts.ts

エイリアスファイルはこのように変更されます

code:vendor/https/deno.land/std/testing/mod.ts

export * from "https://deno.land/std@v0.20.0/testing/mod.ts"

これによって、importする側のimport文を変更することなくリモートモジュールをアップデートすることができます

default export

なぜかExport Aggregationはdefault exportをリダイレクトしてくれませんが、リンク先がdefault exportを持っていた場合、エイリアスにも反映されるようになっています

code:vendor/https/dev.jspm.io/react/index.js

export * from "https://dev.jspm.io/react@16.10.2/index.js";

import {default as dew} from "https://dev.jspm.io/react@16.10.2/index.js";

export default dew;

小ネタ

対象のjsファイルがdefaut exportを持っているかどうかはTSを構文解析しないと行けませんが、実のところ面倒なのでファイルの最終行から順に"export default"の文字列が存在するかを見ているだけだったりしますkeroxp.icon

理由: export defaultはどうせ最後の方にあるから