pnpm

pnpm は npm と何が違うのか

pnpm は npm、yarn と並ぶ JavaScript のパッケージマネージャーです。pnpm と言う名前は「performant npm」に由来します。

pnpm は npmyarn と並ぶ JavaScript のパッケージマネージャーです。pnpm と言う名前は「performant npm」に由来します。

npm と互換性を持ち、以下のような特徴があります。

  • 他のツールと比較して最大 2 倍高速
  • ディスク容量を効率化
  • 厳格なパッケージ管理で、package.json に記載のあるものにしかアクセスできない

pnpm を始める

pnpm は以下のコマンドからインストールできます。

# macOS or Linux
curl -fsSL https://get.pnpm.io/install.sh | sh -
# Windows (PowerShell) 
iwr https://get.pnpm.io/install.ps1 -useb | iex

または、npm を使用してインストールできます。

npm install -g pnpm

pnpm のインストールが完了したら、試しに express をインストールしてみましょう。パッケージをインストールするには pnpm install <パッケージ名> コマンドを実行します。

pnpm install express
Packages: +57
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Packages are hard linked from the content-addressable store to the virtual store.
  Content-addressable store is at: ~/Library/pnpm/store/v3
  Virtual store is at:             node_modules/.pnpm
Progress: resolved 61, reused 0, downloaded 57, added 57, done
 
dependencies:
+ express 4.18.1

ディスク容量が節約された node_modules

「Packages are hard linked from the content-addressable store to the virtual store.」と表示されているとおり、パッケージの実態ファイルはすべてグローバルに管理される Content-addressable store(コンテンツ探索可能なストア)に配置されます。MacOS では ~/Library/pnpm/store/v3 がデフォルトの配置場所となります。node_modules に存在するすべてのパッケージに含まれるファイルはコンテンツストアへのハードリンクです。

すべてのパッケージについて node_moduels にハードリンクを作成したら、入れ子になった依存関係のグラフ構造を反映するシンボリックリンクを作成します。

実際に、node_modules ディレクトリは以下のようになっています。

node_modules/
└── .pnpm/
    └── [email protected]
      └── node_modules
          ├── body-parser
          │   ├── index.js
          │   └── package.json
          ├── bytes -> ../../[email protected]/node_modules/bytes
          ├── content-type -> ../../[email protected]/node_modules/content-
          └── unpipe -> ../../[email protected]/node_modules/unpipe
    └── [email protected]
      └── node_modules
          ├── body-parser -> ../../[email protected]/node_modules/body-parser
          └── express/
├── express -> .pnpm/[email protected]/node_modules/express
└── .modules.yaml

このように、npm や yarn と異なりパッケージはすべてコンテンツ探索可能なストアに格納されるので、異なるプロジェクト間で同じバージョンのパッケージがある場合共有できます。そのため、ディスク容量を節約と、インストールの高層化が実現できます。

厳格なパッケージ管理

普段使用されている npm と異なり、node_moduels 配下が奇妙な構造になっていることに気づいたでしょうか?pnpm は npm や yarn が採用しているフラットな node_moduels の構造を採用していません。参考に、npm の生成する node_moduels は以下のようになります。

node_modules/
├── body-parser
│   ├── index.js
│   └── package.json
├── express
│   ├── index.js
│   └── package.json

上記のように、npm の生成する node_modules は直下にすべてのパッケージを配置しています。一方で、pnpm の場合には node_modules 直下に配置されているのは express のシンボリックリンクのみです。なぜなら、package.jsondependencies には express しか記載していないからです。つまり、アプリケーションコードから直接アクセスできるパッケージは express だけということになります。

このことは、pnpm が厳格であることを表しています。

pnpm の厳格さを証明するために、実験をしてみましょう。まずは npm で express をインストールしたプロジェクトで以下のようなコードを作成します。

npm-repo/index.mjs
import bodyParser from "body-parser";
import assert from "node:assert/strict";
 
assert.ok(bodyParser);

body-parser は直接インストールしたパッケージでないにも関わらず、import に成功して問題なくこのコードを実行できます。このように、フラットな構造の node_modules の場合には当該パッケージを直接インストールしていなくても、express が依存しているパッケージであればアクセスすることが可能です。

しかし、この挙動は次のような場合に問題になる可能性があります。

  • express のパッチバージョンアップで body-parser がメジャーバージョンアップされた
    • 例えば、現在使用している body-parser のバージョンが 1.x でそのことを前提としてコードが書かれており、body-parser のバージョン 2.x が公開されたとします。しばらくの間は問題にならないのですが、experss のパッチバージョンアップで expressbody-parser の 2.x を使用するように修正されたとしましょう。パッチバージョンアップなので、express 自体には破壊的変更はないはずですが、次回以降の npm installbody-parser の 2.0 が node_modules に配置されるようになります。これにより、何もしていないのも関わらず、body-parser に依存しているコードが壊れていまう可能性があります。
  • express のパッチバージョンアップで body-parser に依存しなくなった
    • 前述の例と同じように、experss がもはや body-parser に依存しなくなると node_modulesbody-parser が配置されることはありません。この場合もまた body-parser に依存するコードは壊れてしまいます。

上記のような問題を防ぐ唯一の方法は、body-parser もまた明示的にインストールして使用することです。

一方 pnpm の場合はどうでしょう。さきほどと全く同じコードを実行しています。

pnpm-repo/index.mjs
import bodyParser from "body-parser";
import assert from "node:assert/strict";
 
assert.ok(bodyParser);

結果として、モジュールが存在しないというエラーが表示されます。なぜなら、body-parserpackage.jsondependencies に記載されていないため node_modules 直下には配置されておらず、node_modules/.pnpm 配下に存在するためです。

$ node index.mjs 
node:internal/errors:465
    ErrorCaptureStackTrace(err);
    ^

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'body-parser' imported from /work/pnpm-test/pnpm-repo/index.mjs
    at new NodeError (node:internal/errors:372:5)
    at packageResolve (node:internal/modules/esm/resolve:954:9)
    at moduleResolve (node:internal/modules/esm/resolve:1003:20)
    at defaultResolve (node:internal/modules/esm/resolve:1218:11)
    at ESMLoader.resolve (node:internal/modules/esm/loader:580:30)
    at ESMLoader.getModuleJob (node:internal/modules/esm/loader:294:18)
    at ModuleWrap.<anonymous> (node:internal/modules/esm/module_job:80:40)
    at link (node:internal/modules/esm/module_job:78:36) {
  code: 'ERR_MODULE_NOT_FOUND'
}

これを解決するには body-parser をインストールすればよいのです。

pnpm install body-parser

パフォーマンス

npmyarnYarn PnP と比較した pnpm のベンチマークが存在します。この結果を見る限り、確かに pnpm は非常に高速にパッケージをインストールできることがわかります。

スクリーンショット 2022-07-24 17.22.10 1

また Yarn が公開しているベンチマークも確認できます。こちらも同様に pnpm が良い結果を残しています。

スクリーンショット 2022-07-24 17.25.42

感想

pnpm はその他のパッケージマネージャーと node_modules の構造が大きく異なるのが特徴ですね。パッケージマネージャーにより厳格な管理ができるのが興味深いポイントです。


Contributors

> GitHub で修正を提案する
この記事をシェアする
はてなブックマークに追加

関連記事