bootsnap 1.3.0.beta2 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.travis.yml +5 -0
- data/README.jp.md +29 -18
- data/lib/bootsnap/version.rb +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: a6aa25eb064ffeb1bd2e7588f6741061c1acd0647782ba830ebc872ce8997ff2
|
|
4
|
+
data.tar.gz: 981babf7f6d1dc70cd02e5b7373a1a0770d3ebca39e1488503e7aebc1665f8f2
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5dc67fe4306e38465bbcec301a169e42a7555ce5541b3d2032cfdf157bf4ff47a25b4403a450f57232f2ae27c69fee8f284fdc94588e671b33af9edff5b6fc2d
|
|
7
|
+
data.tar.gz: de7d7384d6cb6c97b7e32ebf6f00de0e7b9f7a0aa65a76897d0458a1d0a172e8d714ca3d812ed79aef9a34943ef7dcfdbff95413c95dab4d44be13971dd2cf57
|
data/.travis.yml
CHANGED
data/README.jp.md
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
# Bootsnap [](https://travis-ci.org/Shopify/bootsnap)
|
|
2
2
|
|
|
3
|
-
Bootsnap は RubyVM におけるバイトコード生成やファイルルックアップ等の時間のかかる処理を最適化するためのライブラリです。ActiveSupport や YAML もサポートしています。
|
|
3
|
+
Bootsnap は RubyVM におけるバイトコード生成やファイルルックアップ等の時間のかかる処理を最適化するためのライブラリです。ActiveSupport や YAML もサポートしています。[内部動作](#内部動作)もご覧ください。
|
|
4
4
|
|
|
5
5
|
注意書き: このライブラリは英語話者によって管理されています。この README は日本語ですが、日本語でのサポートはしておらず、リクエストにお答えすることもできません。バイリンガルの方がサポートをサポートしてくださる場合はお知らせください！:)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
### パフォーマンス
|
|
8
8
|
|
|
9
|
-
Discourse では、約6秒から3秒まで、約50
|
|
9
|
+
* [Discourse](https://github.com/discourse/discourse) では、約6秒から3秒まで、約50%の起動時間短縮が確認されています。
|
|
10
|
+
* 小さなアプリケーションでも、50%の改善（3.6秒から1.8秒）が確認されています。
|
|
11
|
+
* 非常に巨大でモノリシックなアプリである Shopify のプラットフォームでは、約25秒から6.5秒へと約75％短縮されました。
|
|
10
12
|
|
|
11
13
|
## 使用方法
|
|
12
14
|
|
|
@@ -16,12 +18,14 @@ Discourse では、約6秒から3秒まで、約50%の起動時間短縮が確
|
|
|
16
18
|
gem 'bootsnap', require: false
|
|
17
19
|
```
|
|
18
20
|
|
|
19
|
-
Rails を使用している場合は、以下のコードを、`config/boot.rb` 内にある `require 'bundler/setup'`
|
|
21
|
+
Rails を使用している場合は、以下のコードを、`config/boot.rb` 内にある `require 'bundler/setup'` の直後に追加してください。
|
|
20
22
|
|
|
21
23
|
```ruby
|
|
22
24
|
require 'bootsnap/setup'
|
|
23
25
|
```
|
|
24
26
|
|
|
27
|
+
この require の仕組みは[こちら](https://github.com/Shopify/bootsnap/blob/master/lib/bootsnap/setup.rb)で確認できます。
|
|
28
|
+
|
|
25
29
|
Rails を使用していない場合、または、より多くの設定を変更したい場合は、以下のコードを `require 'bundler/setup'` の直後に追加してください(早く読み込まれるほど、より多くのものを最適化することができます）。
|
|
26
30
|
|
|
27
31
|
```ruby
|
|
@@ -38,24 +42,31 @@ Bootsnap.setup(
|
|
|
38
42
|
)
|
|
39
43
|
```
|
|
40
44
|
|
|
41
|
-
|
|
45
|
+
**ヒント**: `require 'bootsnap'` を `BootLib::Require.from_gem('bootsnap', 'bootsnap')` で、 [こちらのトリック](https://github.com/Shopify/bootsnap/wiki/Bootlib::Require)を使って置き換えることができます。こうすると、巨大な`$LOAD_PATH`がある場合でも、起動時間を最短化するのに役立ちます。
|
|
46
|
+
|
|
47
|
+
注意: Bootsnap と [Spring](https://github.com/rails/spring) は別領域の問題を扱うツールです。Bootsnap は個々のソースファイルの読み込みを高速化します。一方で、Spring は起動されたRailsプロセスのコピーを保持して次回の起動時に起動プロセスの一部を完全にスキップします。2つのツールはうまく連携しており、どちらも新しく生成された Rails アプリケーションにデフォルトで含まれています。
|
|
48
|
+
|
|
49
|
+
### 環境
|
|
50
|
+
Bootsnapのすべての機能はセットアップ時の設定に従って開発、テスト、プロダクション、および他のすべての環境で有効化されます。Shopify では、この gem を問題なくすべての環境で安全に使用しています。
|
|
51
|
+
|
|
52
|
+
特定の環境で機能を無効にする場合は、必要に応じて適切な ENV 変数または設定を考慮して設定を変更することをおすすめします。
|
|
42
53
|
|
|
43
|
-
##
|
|
54
|
+
## 内部動作
|
|
44
55
|
|
|
45
|
-
Bootsnap
|
|
56
|
+
Bootsnap は、処理に時間のかかるメソッドの結果をキャッシュすることで最適化しています。これは、大きく分けて2つのカテゴリに分けられます。
|
|
46
57
|
|
|
47
58
|
* [Path Pre-Scanning](#path-pre-scanning)
|
|
48
|
-
*
|
|
49
|
-
*
|
|
59
|
+
* `Kernel#require` と `Kernel#load` を `$LOAD_PATH` フルスキャンを行わないように変更します。
|
|
60
|
+
* `ActiveSupport::Dependencies.{autoloadable_module?,load_missing_constant,depend_on}` を `ActiveSupport::Dependencies.autoload_paths` のフルスキャンを行わないようにオーバーライドします。
|
|
50
61
|
* [Compilation caching](#compilation-caching)
|
|
51
|
-
*
|
|
52
|
-
*
|
|
62
|
+
* Ruby バイトコードのコンパイル結果をキャッシュするためのメソッド `RubyVM::InstructionSequence.load_iseq` が実装されています。
|
|
63
|
+
* `YAML.load_file` を YAML オブジェクトのロード結果を MessagePack でキャッシュするように変更します。 MessagePack でサポートされていないタイプが使われている場合は Marshal が使われます。
|
|
53
64
|
|
|
54
65
|
### Path Pre-Scanning
|
|
55
66
|
|
|
56
67
|
_(このライブラリは [bootscale](https://github.com/byroot/bootscale) という別のライブラリを元に開発されました)_
|
|
57
68
|
|
|
58
|
-
Bootsnap
|
|
69
|
+
Bootsnap の初期化時、あるいはパス(例えば、`$LOAD_PATH`)の変更時に、`Bootsnap::LoadPathCache` がキャッシュから必要なエントリーのリストを読み込みます。または、必要に応じてフルスキャンを実行し結果をキャッシュします。
|
|
59
70
|
その後、たとえば `require 'foo'` を評価する場合, Ruby は `$LOAD_PATH` `['x', 'y', ...]` のすべてのエントリーを繰り返し評価することで `x/foo.rb`, `y/foo.rb` などを探索します。これに対して Bootsnap は、キャッシュされた reuiqre 可能なファイルと `$LOAD_PATH` を見ることで、Rubyが最終的に選択するであろうパスで置き換えます。
|
|
60
71
|
|
|
61
72
|
この動作によって生成された syscall を見ると、最終的な結果は以前なら次のようになります。
|
|
@@ -76,9 +87,9 @@ open y/foo.rb
|
|
|
76
87
|
...
|
|
77
88
|
```
|
|
78
89
|
|
|
79
|
-
`autoload_paths_cache` オプションが `Bootsnap.setup` に与えられている場合、`ActiveSupport::Dependencies.autoload_paths`
|
|
90
|
+
`autoload_paths_cache` オプションが `Bootsnap.setup` に与えられている場合、`ActiveSupport::Dependencies.autoload_paths` をトラバースする方法にはまったく同じ最適化が使用されます。
|
|
80
91
|
|
|
81
|
-
`*_path_cache`
|
|
92
|
+
`*_path_cache` を機能させるオーバーライドを図にすると、次のようになります。
|
|
82
93
|
|
|
83
94
|
|
|
84
95
|
|
|
@@ -94,11 +105,11 @@ Bootsnap は、 `$LOAD_PATH` エントリを安定エントリと不安定エン
|
|
|
94
105
|
|
|
95
106
|
## Compilation Caching
|
|
96
107
|
|
|
97
|
-
|
|
108
|
+
*（このコンセプトのより分かりやすい解説は [yomikomu](https://github.com/ko1/yomikomu) をお読み下さい。)*
|
|
98
109
|
|
|
99
110
|
Ruby には複雑な文法が実装されており、構文解析は簡単なオペレーションではありません。1.9以降、Ruby は Ruby ソースを内部のバイトコードに変換した後、Ruby VM によって実行してきました。2.3.0 以降、[RubyはAPIを公開し](https://ruby-doc.org/core-2.3.0/RubyVM/InstructionSequence.html)、そのバイトコードをキャッシュすることができるようになりました。これにより、同じファイルが複数ロードされた時の、比較的時間のかかる部分をバイパスすることができます。
|
|
100
111
|
|
|
101
|
-
|
|
112
|
+
また、アプリケーションの起動時に YAML ドキュメントの読み込みに多くの時間を費やしていることを発見しました。そして、 MessagePack と Marshal は deserialization にあたって YAML よりもはるかに高速であるということに気付きました。そこで、YAML ドキュメントを、Ruby バイトコードと同じコンパイルキャッシングの最適化を施すことで、高速化しています。Ruby の "バイトコード" フォーマットに相当するものは MessagePack ドキュメント (あるいは、MessagePack をサポートしていないタイプの YAML ドキュメントの場合は、Marshal stream)になります。
|
|
102
113
|
|
|
103
114
|
これらのコンパイル結果は、入力ファイル（FNV1a-64）のフルパスのハッシュを取って生成されたファイル名で、キャッシュディレクトリに保存されます。
|
|
104
115
|
|
|
@@ -132,9 +143,9 @@ close m
|
|
|
132
143
|
close n
|
|
133
144
|
```
|
|
134
145
|
|
|
135
|
-
|
|
146
|
+
これは一見劣化していると思われるかもしれませんが、性能に大きな違いがあります。
|
|
136
147
|
|
|
137
|
-
|
|
148
|
+
*（両方のリストの最初の3つの syscalls -- `open`, `fstat64`, `close` -- は本質的に有用ではありません。[このRubyパッチ](https://bugs.ruby-lang.org/issues/13378)は、Boosnap と組み合わせることによって、それらを最適化しています）*
|
|
138
149
|
|
|
139
150
|
Bootsnap は、64バイトのヘッダーとそれに続くキャッシュの内容を含んだキャッシュファイルを書き込みます。ヘッダーは、次のいくつかのフィールドで構成されるキャッシュキーです。
|
|
140
151
|
|
data/lib/bootsnap/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: bootsnap
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.3.0
|
|
4
|
+
version: 1.3.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Burke Libbey
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2018-04-
|
|
11
|
+
date: 2018-04-09 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: bundler
|
|
@@ -155,9 +155,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
|
155
155
|
version: 2.0.0
|
|
156
156
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
157
157
|
requirements:
|
|
158
|
-
- - "
|
|
158
|
+
- - ">="
|
|
159
159
|
- !ruby/object:Gem::Version
|
|
160
|
-
version:
|
|
160
|
+
version: '0'
|
|
161
161
|
requirements: []
|
|
162
162
|
rubyforge_project:
|
|
163
163
|
rubygems_version: 2.7.6
|