/
atom.xml
267 lines (234 loc) · 17.4 KB
/
atom.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title><![CDATA[Category: handlebars-source | machty's thoughtz]]></title>
<link href="http://machty.github.com/blog/categories/handlebars-source/atom.xml" rel="self"/>
<link href="http://machty.github.com/"/>
<updated>2015-08-26T16:33:39-04:00</updated>
<id>http://machty.github.com/</id>
<author>
<name><![CDATA[Alex Matchneer]]></name>
</author>
<generator uri="http://octopress.org/">Octopress</generator>
<entry>
<title type="html"><![CDATA[NYC Ember.js Meetup Run Loop Slides]]></title>
<link href="http://machty.github.com/blog/2013/02/28/nyc-ember-dot-js-meetup-run-loop-slides/"/>
<updated>2013-02-28T21:22:00-05:00</updated>
<id>http://machty.github.com/blog/2013/02/28/nyc-ember-dot-js-meetup-run-loop-slides</id>
<content type="html"><![CDATA[<p>Just did a talk on the Ember run loop at the
<a href="http://www.meetup.com/EmberJS-NYC/">NYC Ember.js Meetup</a>.
You can check them out
<a href="http://machty.github.com/blog/ember_run_loop_talk">here</a>.
There's also a blurb on the <code>ember-source</code>, <code>handlebars-source</code> stuff
I <a href="/blog/2013/02/27/gemifying-ember-dot-js-slash-handlebars-dot-js-slash-etc-dot-js/">wrote about
yesterday</a>.</p>
]]></content>
</entry>
<entry>
<title type="html"><![CDATA[Slaying the Ember/Handlebars JS-RB Dependency Demons with Gem Wrappers]]></title>
<link href="http://machty.github.com/blog/2013/02/27/gemifying-ember-dot-js-slash-handlebars-dot-js-slash-etc-dot-js/"/>
<updated>2013-02-27T23:28:00-05:00</updated>
<id>http://machty.github.com/blog/2013/02/27/gemifying-ember-dot-js-slash-handlebars-dot-js-slash-etc-dot-js</id>
<content type="html"><![CDATA[<p>Ember.js devotees may have noticed a series of related commits that I
put in recently with reference to "removing vendored .js files in favor
of ember-source, handlebars-source, etc", or something of the like.
They're all checked in now, and I think they've gone a long way towards
alleviating the dependency hell stemming from multiple gems packaging
vendored .js files.</p>
<p>For a better understanding of the motivation behind these
changes and how they might affect you, read on.</p>
<!--more-->
<h2>The Problem</h2>
<p>You're using <code>ember-rails</code> to build an Ember v1.0.0.pre4 app hosted by your Rails
server. Your Handlebars (or <a href="http://emblemjs.com">Emblem</a>) templates are
being precompiled by the <a href="https://github.com/tchak/barber">barber gem</a>
used by <code>ember-rails</code>, which uses Handlebars.js rc2.</p>
<p>You wisely decide to upgrade to Ember v1.0.0.rc1, only to find that
Ember rc1 now depends on Handlebars rc3 (instead of rc2). Even though
you've overridden <code>ember-rails</code> to serve the latest Ember and Handlebars
to the browser, the <code>barber</code> gem is still using its Handlebars rc2 to
compile your templates, and when you run your app, you're greeted with
the following error.</p>
<p><code>
Ember Handlebars requires Handlebars 1.0.0-rc.3 or greater
</code></p>
<p>You hurriedly submit a pull request to <code>barber</code> with a freshly bundled
handlebars rc3 along with 8 other people, but Parisian Paul won't be
awake for another 8 hours to merge the PR, so you duck-punch your way to
temporary solution, cluttering your app with its very own vendored
Handlebars.js.</p>
<p>The situation normalizes in a few days, only to repeat itself for the
next backwards-incompatible version bump.</p>
<h2>Lightweight Gem Wrappers around JS Libs</h2>
<p>To prevent this sort of thing from happening in the future, there's a
now a lightweight gem wrapper for the following:</p>
<ul>
<li><a href="https://rubygems.org/gems/handlebars-source">handlebars-source</a></li>
<li><a href="https://rubygems.org/gems/ember-source">ember-source</a></li>
<li><a href="https://rubygems.org/gems/ember-data-source">ember-data-source</a></li>
<li><a href="https://rubygems.org/gems/emblem-source">emblem-source</a></li>
</ul>
<p>These gems contain nothing more than .js files and just enough Ruby code
to help you determine an absolute path to the .js file contained within
the gem. Example:</p>
<p><div class='bogus-wrapper'><notextile><figure class='code'> <div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
<span class='line-number'>14</span>
<span class='line-number'>15</span>
<span class='line-number'>16</span>
<span class='line-number'>17</span>
<span class='line-number'>18</span>
<span class='line-number'>19</span>
<span class='line-number'>20</span>
<span class='line-number'>21</span>
<span class='line-number'>22</span>
<span class='line-number'>23</span>
<span class='line-number'>24</span>
<span class='line-number'>25</span>
<span class='line-number'>26</span>
</pre></td><td class='code'><pre><code class='ruby'><span class='line'><span class="nb">require</span> <span class="s1">'handlebars/source'</span><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><p>context = ExecJS.compile(File.read(Handlebars::Source.bundled_path))</span>
</span><span class='line'><span class="sr">puts context.call 'Handlebars.precompile', '{{hello}}'</</span><span class="nb">p</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="n">h1</span><span class="o">>=><</span><span class="sr">/h1></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>function (Handlebars,depth0,helpers,partials,data) {</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="n">h1</span><span class="o">></span><span class="n">this</span><span class="o">.</span><span class="n">compilerInfo</span> <span class="o">=</span> <span class="o">[</span><span class="mi">2</span><span class="p">,</span><span class="s1">'>= 1.0.0-rc.3'</span><span class="o">]</span><span class="p">;</span><span class="o"><</span><span class="sr">/h1></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>helpers = helpers || Handlebars.helpers; data = data || {};</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="n">h1</span><span class="o">></span><span class="n">var</span> <span class="n">stack1</span><span class="p">,</span> <span class="n">functionType</span><span class="o">=</span><span class="s2">"function"</span><span class="p">,</span> <span class="n">escapeExpression</span><span class="o">=</span><span class="n">this</span><span class="o">.</span><span class="n">escapeExpression</span><span class="p">;</span><span class="o"><</span><span class="sr">/h1></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1></</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="n">h1</span><span class="o">></span><span class="k">if</span> <span class="p">(</span><span class="n">stack1</span> <span class="o">=</span> <span class="n">helpers</span><span class="o">.</span><span class="n">hello</span><span class="p">)</span> <span class="p">{</span> <span class="n">stack1</span> <span class="o">=</span> <span class="n">stack1</span><span class="o">.</span><span class="n">call</span><span class="p">(</span><span class="n">depth0</span><span class="p">,</span> <span class="p">{</span><span class="nb">hash</span><span class="p">:{},</span><span class="n">data</span><span class="ss">:data</span><span class="p">});</span> <span class="p">}</span><span class="o"><</span><span class="sr">/h1></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>else { stack1 = depth0.hello; stack1 = typeof stack1 === functionType ? stack1.apply(depth0) : stack1; }</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="n">h1</span><span class="o">></span><span class="k">return</span> <span class="n">escapeExpression</span><span class="p">(</span><span class="n">stack1</span><span class="p">);</span><span class="o"><</span><span class="sr">/h1></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>}</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="nb">p</span><span class="o">></span>
</span></code></pre></td></tr></table></div></figure></notextile></div></p>
<p>At the time of writing, most of the gems you'd ever use for your Ember
projects use these gems, and since they don't specify dependencies upon
any particular versions of these gems, the app using these gems has full
control over which versions of the JS libs these gems will use for
precompiling, asset packaging, etc.</p>
<p>So, coming back to the dependency hell scenario above, if you're writing
an app in Ember rc1, and Ember rc2 comes out with a dependency on a
new, backwards incompatible Handlebars, all you have to do to upgrade to
the latest Ember/Handlebars and have your precompilation /
asset-packaging libs do the same is put the following in your Gemfile:</p>
<p><code>
gem 'ember-source', '1.0.0.rc2'
</code></p>
<p>And run <code>bundle update ember-source</code>. <code>ember-source</code> has a dependency on
a particularly version range of <code>handlebars-source</code>, so that'll be
updated to an appropriate version as well, and all the gems that use
<code>ember-source</code> and <code>handlebars-source</code> will magically start using the
new .js files.</p>
<h2>Caveat</h2>
<p>The versions chosen for the <code>____-source</code> gems match as closely as possible
the current version of the bundled JS lib. The only problem with this is
that the latest Ember and Handlebars versions are release candidates,
and the letters in the versions (e.g. <code>1.0.0.rc1</code>) trigger special
(annoying) pre-release version resolution logic for both RubyGems and
Bundler. All this means is that you have to be very specific about
the version of <code>____-source</code> you want to use, and you won't be able to
use the pessimistic <code>~></code> version operator, since that'll kick out to the
nearest non-pre-release version of the gem it can find, rather than
staying within the bounds of an <code>rc</code> sub-version. So, TL;DR, do the
following:</p>
<p><div class='bogus-wrapper'><notextile><figure class='code'> <div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
</pre></td><td class='code'><pre><code class='ruby'><span class='line'><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>Gemfile</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="nb">p</span><span class="o">></span><span class="n">gem</span> <span class="s1">'ember-source'</span><span class="p">,</span> <span class="s1">'1.0.0.rc1.2'</span><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>This won't work.</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="n">h1</span><span class="o">></span><span class="n">gem</span> <span class="s1">'ember-source'</span><span class="p">,</span> <span class="s1">'~> 1.0.0.rc1.0'</span><span class="o"><</span><span class="sr">/h1></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><p></span>
</span></code></pre></td></tr></table></div></figure></notextile></div></p>
<h2>Appendix: Getting the .js files out of the <code>___-source</code> gems</h2>
<p>Handlebars:</p>
<p><div class='bogus-wrapper'><notextile><figure class='code'> <div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
</pre></td><td class='code'><pre><code class='ruby'><span class='line'><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>Gemfile</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="nb">p</span><span class="o">></span><span class="n">gem</span> <span class="s1">'handlebars-source'</span><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>Code</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="nb">p</span><span class="o">></span><span class="nb">require</span> <span class="s1">'handlebars/source'</span>
</span><span class='line'><span class="no">Handlebars</span><span class="o">::</span><span class="no">Source</span><span class="o">.</span><span class="n">bundled_path</span> <span class="c1"># => "/Users/.../handlebars.js"</span>
</span><span class='line'><span class="no">Handlebars</span><span class="o">::</span><span class="no">Source</span><span class="o">.</span><span class="n">runtime_bundled_path</span> <span class="c1"># => "/Users/.../handlebars.runtime.js"</span>
</span></code></pre></td></tr></table></div></figure></notextile></div></p>
<p>Ember / Ember Data:</p>
<p><div class='bogus-wrapper'><notextile><figure class='code'> <div class="highlight"><table><tr><td class="gutter"><pre class="line-numbers"><span class='line-number'>1</span>
<span class='line-number'>2</span>
<span class='line-number'>3</span>
<span class='line-number'>4</span>
<span class='line-number'>5</span>
<span class='line-number'>6</span>
<span class='line-number'>7</span>
<span class='line-number'>8</span>
<span class='line-number'>9</span>
<span class='line-number'>10</span>
<span class='line-number'>11</span>
<span class='line-number'>12</span>
<span class='line-number'>13</span>
</pre></td><td class='code'><pre><code class='ruby'><span class='line'><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>Gemfile</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="nb">p</span><span class="o">></span><span class="n">gem</span> <span class="s1">'ember-source'</span>
</span><span class='line'><span class="n">gem</span> <span class="s1">'ember-data-source'</span><span class="o"><</span><span class="sr">/p></span>
</span><span class='line'>
</span><span class='line'><span class="sr"><h1>Code</</span><span class="n">h1</span><span class="o">></span>
</span><span class='line'>
</span><span class='line'><span class="o"><</span><span class="nb">p</span><span class="o">></span><span class="nb">require</span> <span class="s1">'ember/source'</span>
</span><span class='line'><span class="nb">require</span> <span class="s1">'ember/data/source'</span>
</span><span class='line'><span class="no">Ember</span><span class="o">::</span><span class="no">Source</span><span class="o">.</span><span class="n">bundled_path_for</span><span class="p">(</span><span class="s2">"ember.js"</span><span class="p">)</span> <span class="c1"># => "/Users/.../ember.js"</span>
</span><span class='line'><span class="no">Ember</span><span class="o">::</span><span class="no">Data</span><span class="o">::</span><span class="no">Source</span><span class="o">.</span><span class="n">bundled_path_for</span><span class="p">(</span><span class="s2">"ember-data.js"</span><span class="p">)</span> <span class="c1"># => "/Users/.../ember-data.js"</span>
</span></code></pre></td></tr></table></div></figure></notextile></div></p>
]]></content>
</entry>
</feed>