asset_hat 0.3.1 → 0.4.0
Sign up to get free protection for your applications and to get access to all the features.
- data/Gemfile +2 -0
- data/Gemfile.lock +37 -0
- data/HISTORY +10 -0
- data/README.rdoc +117 -75
- data/Rakefile +4 -4
- data/VERSION.yml +2 -2
- data/asset_hat.gemspec +69 -7
- data/config/assets.yml +46 -24
- data/doc/classes/AssetHat.html +183 -118
- data/doc/classes/AssetHat/CSS.html +21 -21
- data/doc/classes/AssetHat/CSS/Engines.html +10 -10
- data/doc/classes/AssetHat/JS.html +13 -13
- data/doc/classes/AssetHat/JS/Engines.html +10 -10
- data/doc/classes/AssetHat/JS/Vendors.html +85 -22
- data/doc/classes/AssetHatHelper.html +94 -19
- data/doc/created.rid +1 -1
- data/doc/files/HISTORY.html +20 -2
- data/doc/files/LICENSE.html +1 -1
- data/doc/files/README_rdoc.html +87 -31
- data/doc/files/lib/asset_hat/capistrano_rb.html +1 -1
- data/doc/files/lib/asset_hat/css_rb.html +1 -1
- data/doc/files/lib/asset_hat/initializers/action_view_rb.html +49 -0
- data/doc/files/lib/asset_hat/initializers/cache_last_commit_ids_rb.html +49 -0
- data/doc/files/lib/asset_hat/js/vendors_rb.html +1 -1
- data/doc/files/lib/asset_hat/js_rb.html +1 -1
- data/doc/files/lib/asset_hat/railtie_rb.html +61 -0
- data/doc/files/lib/asset_hat/tasks/css_rb.html +1 -1
- data/doc/files/lib/asset_hat/tasks/js_rb.html +1 -1
- data/doc/files/lib/asset_hat/tasks_rb.html +2 -1
- data/doc/files/lib/asset_hat/unicorn_rb.html +58 -0
- data/doc/files/lib/asset_hat/vcs_rb.html +1 -1
- data/doc/files/lib/asset_hat/version_rb.html +1 -1
- data/doc/files/{app/helpers → lib}/asset_hat_helper_rb.html +3 -3
- data/doc/files/lib/asset_hat_rb.html +9 -1
- data/doc/files/lib/tasks/asset_hat_rake.html +54 -0
- data/doc/fr_file_index.html +6 -1
- data/doc/fr_method_index.html +60 -52
- data/lib/asset_hat.rb +104 -59
- data/lib/asset_hat/initializers/action_view.rb +1 -0
- data/lib/asset_hat/initializers/cache_last_commit_ids.rb +1 -0
- data/lib/asset_hat/js/vendors.rb +198 -72
- data/lib/asset_hat/railtie.rb +19 -0
- data/lib/asset_hat/tasks.rb +5 -2
- data/lib/asset_hat/unicorn.rb +9 -0
- data/lib/asset_hat/vcs.rb +3 -2
- data/{app/helpers → lib}/asset_hat_helper.rb +184 -29
- data/{tasks → lib/tasks}/asset_hat.rake +0 -0
- data/rails/init.rb +2 -2
- data/test/asset_hat_helper_test.rb +731 -148
- data/test/asset_hat_test.rb +23 -2
- data/test/test_helper.rb +4 -8
- metadata +311 -30
data/config/assets.yml
CHANGED
|
@@ -1,34 +1,51 @@
|
|
|
1
|
-
#
|
|
2
|
-
#
|
|
1
|
+
# Here, you can upgrade your layouts and views to AssetHat. For example, find
|
|
2
|
+
# this sort of code in your app:
|
|
3
|
+
#
|
|
4
|
+
# stylesheet_link_tag 'reset', 'application'
|
|
5
|
+
# javascript_include_tag(
|
|
6
|
+
# Rails.env.production? ? '<Google CDN URL>' : 'jquery-1.5.2')
|
|
7
|
+
# javascript_include_tag 'utilities', 'application'
|
|
8
|
+
#
|
|
9
|
+
# Create matching bundles in this file (no `.css` or `.js` suffixes needed;
|
|
10
|
+
# ERb is supported if you need it):
|
|
3
11
|
#
|
|
4
12
|
# css:
|
|
5
|
-
# engine: cssmin
|
|
6
13
|
# bundles:
|
|
7
14
|
# application:
|
|
8
15
|
# - reset
|
|
9
16
|
# - application
|
|
10
|
-
# - clearfix
|
|
11
|
-
# admin:
|
|
12
|
-
# - reset
|
|
13
|
-
# - admin
|
|
14
|
-
# - clearfix
|
|
15
17
|
# js:
|
|
16
|
-
# engine: jsmin
|
|
17
18
|
# vendors:
|
|
18
19
|
# jquery:
|
|
19
|
-
# version: 1.
|
|
20
|
+
# version: 1.5.2
|
|
20
21
|
# bundles:
|
|
21
|
-
#
|
|
22
|
-
# - init
|
|
23
|
-
# - third-party-plugin.min
|
|
24
|
-
# # Here, the suffix `.min` indicates that the code has already
|
|
25
|
-
# # been minified, and should not be re-minified.
|
|
26
|
-
# common:
|
|
22
|
+
# application:
|
|
27
23
|
# - utilities
|
|
28
24
|
# - application
|
|
25
|
+
#
|
|
26
|
+
# Then, simplify your layouts and views to match your bundles:
|
|
27
|
+
#
|
|
28
|
+
# include_css :bundle => 'application'
|
|
29
|
+
# include_js :jquery, :bundle => 'application'
|
|
30
|
+
#
|
|
31
|
+
# This makes it really easy to reuse sets of CSS/JS files across layouts.
|
|
32
|
+
#
|
|
33
|
+
# Lastly, set up your deployment script to run `rake asset_hat:minify`
|
|
34
|
+
# automatically. This creates minified versions of your CSS/JS; your original
|
|
35
|
+
# code is untouched. If you deploy with Capistrano, here's an example recipe:
|
|
36
|
+
# https://github.com/mintdigital/asset_hat/blob/master/lib/asset_hat/capistrano.rb
|
|
37
|
+
#
|
|
38
|
+
# That's it! In development, individual CSS/JS files are loaded separately,
|
|
39
|
+
# and your local copy of jQuery is used. In production, your minified CSS/JS
|
|
40
|
+
# bundles are loaded, and jQuery is loaded from Google's CDN.
|
|
41
|
+
#
|
|
42
|
+
# More info: https://github.com/mintdigital/asset_hat/#readme
|
|
29
43
|
|
|
30
44
|
css:
|
|
31
45
|
engine: cssmin
|
|
46
|
+
# Available minification engines:
|
|
47
|
+
# http://mintdigital.github.com/asset_hat/doc/classes/AssetHat/CSS/Engines.html
|
|
48
|
+
|
|
32
49
|
bundles:
|
|
33
50
|
css-bundle-1:
|
|
34
51
|
- css-file-1-1
|
|
@@ -38,12 +55,21 @@ css:
|
|
|
38
55
|
- css-file-2-1
|
|
39
56
|
- css-file-2-2
|
|
40
57
|
- css-file-2-3
|
|
41
|
-
|
|
42
|
-
- css-file-3-1
|
|
43
|
-
- css-file-3-2
|
|
44
|
-
- css-file-3-3
|
|
58
|
+
|
|
45
59
|
js:
|
|
46
60
|
engine: jsmin
|
|
61
|
+
# Available minification engines:
|
|
62
|
+
# http://mintdigital.github.com/asset_hat/doc/classes/AssetHat/JS/Engines.html
|
|
63
|
+
|
|
64
|
+
# Enable if you're using jQuery or other popular JS:
|
|
65
|
+
#
|
|
66
|
+
# vendors:
|
|
67
|
+
# jquery:
|
|
68
|
+
# version: 1.5.2
|
|
69
|
+
#
|
|
70
|
+
# Supported vendors:
|
|
71
|
+
# http://mintdigital.github.com/asset_hat/doc/classes/AssetHat/JS/Vendors.html
|
|
72
|
+
|
|
47
73
|
bundles:
|
|
48
74
|
js-bundle-1:
|
|
49
75
|
- js-file-1-1
|
|
@@ -53,7 +79,3 @@ js:
|
|
|
53
79
|
- js-file-2-1
|
|
54
80
|
- js-file-2-2
|
|
55
81
|
- js-file-2-3
|
|
56
|
-
js-bundle-3:
|
|
57
|
-
- js-file-3-1
|
|
58
|
-
- js-file-3-2
|
|
59
|
-
- js-file-3-3
|
data/doc/classes/AssetHat.html
CHANGED
|
@@ -33,11 +33,14 @@
|
|
|
33
33
|
<li>
|
|
34
34
|
<a href="../files/lib/asset_hat/css_rb.html">lib/asset_hat/css.rb</a>
|
|
35
35
|
</li>
|
|
36
|
+
<li class='other'>
|
|
37
|
+
<a href="../files/lib/asset_hat/js_rb.html">lib/asset_hat/js.rb</a>
|
|
38
|
+
</li>
|
|
36
39
|
<li class='other'>
|
|
37
40
|
<a href="../files/lib/asset_hat/js/vendors_rb.html">lib/asset_hat/js/vendors.rb</a>
|
|
38
41
|
</li>
|
|
39
42
|
<li class='other'>
|
|
40
|
-
<a href="../files/lib/asset_hat/
|
|
43
|
+
<a href="../files/lib/asset_hat/railtie_rb.html">lib/asset_hat/railtie.rb</a>
|
|
41
44
|
</li>
|
|
42
45
|
<li class='other'>
|
|
43
46
|
<a href="../files/lib/asset_hat/vcs_rb.html">lib/asset_hat/vcs.rb</a>
|
|
@@ -57,67 +60,32 @@
|
|
|
57
60
|
<div id='text'>
|
|
58
61
|
<div id='description'>
|
|
59
62
|
<p>
|
|
60
|
-
Your assets are covered.
|
|
61
|
-
</
|
|
62
|
-
<p>
|
|
63
|
-
With Rails’ default asset caching, <a
|
|
64
|
-
href="AssetHat/CSS.html">CSS</a> and <a href="AssetHat/JS.html">JS</a> are
|
|
65
|
-
concatenated (not even minified) at runtime when that bundle is first
|
|
66
|
-
requested. Not good enough. <a href="AssetHat.html">AssetHat</a> can
|
|
67
|
-
automatically:
|
|
68
|
-
</p>
|
|
69
|
-
<ul>
|
|
70
|
-
<li>Easily <b>minify</b> and <b>bundle</b> <a href="AssetHat/CSS.html">CSS</a>
|
|
71
|
-
and <a href="AssetHat/JS.html">JS</a> on deploy to reduce file sizes and
|
|
72
|
-
HTTP requests.
|
|
73
|
-
|
|
74
|
-
</li>
|
|
75
|
-
<li>Load popular <strong>third-party JS</strong> (like jQuery and Prototype)
|
|
76
|
-
from <a href="http://code.google.com/apis/ajaxlibs/"><strong>Google's
|
|
77
|
-
CDN</strong></a> when in production, or from localhost in development.
|
|
78
|
-
|
|
79
|
-
</li>
|
|
80
|
-
<li>Force image URLs in your <a href="AssetHat/CSS.html">CSS</a> to use
|
|
81
|
-
<strong>CDN subdomains</strong>, not just the current host.
|
|
82
|
-
|
|
83
|
-
</li>
|
|
84
|
-
<li>Add an image’s last <a href="http://git-scm.com/">Git</a> commit ID
|
|
85
|
-
to its <a href="AssetHat/CSS.html">CSS</a> URLs to <strong>bust browser
|
|
86
|
-
caches</strong> (e.g., <tt>/images/foo.png?ab12cd3</tt>).
|
|
87
|
-
|
|
88
|
-
</li>
|
|
89
|
-
</ul>
|
|
90
|
-
<p>
|
|
91
|
-
After setup, you can use these in your layouts and views:
|
|
92
|
-
</p>
|
|
93
|
-
<pre><%= include_css :bundle => 'application' %>
 # => <link href="/stylesheets/bundles/application.min.css"
 # media="screen,projection" rel="stylesheet" type="text/css" />

<%= include_js :bundles => ['plugins', 'common'] %>
 # => <script src="/javascripts/bundles/plugins.min.js"
 # type="text/javascript"></script>
 # <script src="/javascripts/bundles/common.min.js"
 # type="text/javascript"></script></pre>
|
|
94
|
-
<p>
|
|
95
|
-
And this in your deploy script:
|
|
96
|
-
</p>
|
|
97
|
-
<pre>rake asset_hat:minify</pre>
|
|
98
|
-
<p>
|
|
99
|
-
See <a href="../files/README_rdoc.html">README.rdoc</a> for more.
|
|
63
|
+
Your assets are covered. See <a
|
|
64
|
+
href="../files/README_rdoc.html">README.rdoc</a> for more.
|
|
100
65
|
</p>
|
|
101
66
|
</div>
|
|
102
67
|
<div id='method-list'>
|
|
103
68
|
<h2>Methods</h2>
|
|
104
69
|
<h3>public class</h3>
|
|
105
70
|
<ol>
|
|
106
|
-
<li><a href="#
|
|
71
|
+
<li><a href="#M000010">asset_exists?</a></li>
|
|
107
72
|
<li><a href="#M000006">assets_dir</a></li>
|
|
108
|
-
<li><a href="#
|
|
109
|
-
<li><a href="#
|
|
110
|
-
<li><a href="#
|
|
111
|
-
<li><a href="#
|
|
112
|
-
<li><a href="#
|
|
113
|
-
<li><a href="#
|
|
114
|
-
<li><a href="#
|
|
73
|
+
<li><a href="#M000007">assets_path</a></li>
|
|
74
|
+
<li><a href="#M000014">bundle_filenames</a></li>
|
|
75
|
+
<li><a href="#M000015">bundle_filepaths</a></li>
|
|
76
|
+
<li><a href="#M000008">bundles_dir</a></li>
|
|
77
|
+
<li><a href="#M000009">bundles_path</a></li>
|
|
78
|
+
<li><a href="#M000011">cache?</a></li>
|
|
79
|
+
<li><a href="#M000004">cache_last_commit_ids</a></li>
|
|
80
|
+
<li><a href="#M000018">clear_html_cache</a></li>
|
|
81
|
+
<li><a href="#M000016">compute_asset_host</a></li>
|
|
115
82
|
<li><a href="#M000005">config</a></li>
|
|
116
|
-
<li><a href="#
|
|
117
|
-
<li><a href="#
|
|
118
|
-
<li><a href="#
|
|
119
|
-
<li><a href="#
|
|
120
|
-
<li><a href="#
|
|
83
|
+
<li><a href="#M000012">consider_all_requests_local?</a></li>
|
|
84
|
+
<li><a href="#M000003">last_bundle_commit_id</a></li>
|
|
85
|
+
<li><a href="#M000002">last_commit_id</a></li>
|
|
86
|
+
<li><a href="#M000013">min_filepath</a></li>
|
|
87
|
+
<li><a href="#M000017">ssl_asset_host_differs?</a></li>
|
|
88
|
+
<li><a href="#M000001">version</a></li>
|
|
121
89
|
</ol>
|
|
122
90
|
</div>
|
|
123
91
|
<div id='section'>
|
|
@@ -153,13 +121,33 @@
|
|
|
153
121
|
<tr class='top-aligned-row context-row'>
|
|
154
122
|
<td class='context-item-name'>ASSETS_DIR</td>
|
|
155
123
|
<td>=</td>
|
|
156
|
-
<td class='context-item-value'>defined?(Rails.public_path) ? Rails.public_path : 'public'</td>
|
|
124
|
+
<td class='context-item-value'>defined?(Rails.public_path) && Rails.public_path.present? ? Rails.public_path : 'public'</td>
|
|
157
125
|
<td> </td>
|
|
158
126
|
<td class='context-item-desc'>
|
|
159
127
|
|
|
160
128
|
Base directory in which all assets are kept, e.g., ‘public/’.
|
|
161
129
|
</td>
|
|
162
130
|
</tr>
|
|
131
|
+
<tr class='top-aligned-row context-row'>
|
|
132
|
+
<td class='context-item-name'>STYLESHEETS_PATH</td>
|
|
133
|
+
<td>=</td>
|
|
134
|
+
<td class='context-item-value'>'/stylesheets'</td>
|
|
135
|
+
<td> </td>
|
|
136
|
+
<td class='context-item-desc'>
|
|
137
|
+
|
|
138
|
+
Root URL path for all stylesheets. For public-facing use.
|
|
139
|
+
</td>
|
|
140
|
+
</tr>
|
|
141
|
+
<tr class='top-aligned-row context-row'>
|
|
142
|
+
<td class='context-item-name'>JAVASCRIPTS_PATH</td>
|
|
143
|
+
<td>=</td>
|
|
144
|
+
<td class='context-item-value'>'/javascripts'</td>
|
|
145
|
+
<td> </td>
|
|
146
|
+
<td class='context-item-desc'>
|
|
147
|
+
|
|
148
|
+
Root URL path for all JavaScripts. For public-facing use.
|
|
149
|
+
</td>
|
|
150
|
+
</tr>
|
|
163
151
|
<tr class='top-aligned-row context-row'>
|
|
164
152
|
<td class='context-item-name'>STYLESHEETS_DIR</td>
|
|
165
153
|
<td>=</td>
|
|
@@ -168,7 +156,7 @@
|
|
|
168
156
|
<td class='context-item-desc'>
|
|
169
157
|
|
|
170
158
|
Directory in which all stylesheets are kept, e.g.,
|
|
171
|
-
‘public/stylesheets
|
|
159
|
+
‘public/stylesheets’. For internal filesystem use.
|
|
172
160
|
</td>
|
|
173
161
|
</tr>
|
|
174
162
|
<tr class='top-aligned-row context-row'>
|
|
@@ -179,7 +167,7 @@
|
|
|
179
167
|
<td class='context-item-desc'>
|
|
180
168
|
|
|
181
169
|
Directory in which all JavaScripts are kept, e.g.,
|
|
182
|
-
‘public/javascripts
|
|
170
|
+
‘public/javascripts’. For internal filesystem use.
|
|
183
171
|
</td>
|
|
184
172
|
</tr>
|
|
185
173
|
<tr class='top-aligned-row context-row'>
|
|
@@ -207,8 +195,8 @@
|
|
|
207
195
|
</div>
|
|
208
196
|
<div id='methods'>
|
|
209
197
|
<h2>Public class methods</h2>
|
|
210
|
-
<div class='method public-class' id='method-
|
|
211
|
-
<a name='
|
|
198
|
+
<div class='method public-class' id='method-M000010'>
|
|
199
|
+
<a name='M000010'></a>
|
|
212
200
|
<div class='synopsis'>
|
|
213
201
|
<span class='name'>asset_exists?</span>
|
|
214
202
|
<span class='arguments'>(filename, type)</span>
|
|
@@ -223,10 +211,10 @@
|
|
|
223
211
|
</p>
|
|
224
212
|
</div>
|
|
225
213
|
<div class='source'>
|
|
226
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
214
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000010-source'); return false">
|
|
227
215
|
[show source]
|
|
228
216
|
</a>
|
|
229
|
-
<pre id='
|
|
217
|
+
<pre id='M000010-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 154</span>
154: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">asset_exists?</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">type</span>)
155: <span class="ruby-comment cmt"># Process arguments</span>
156: <span class="ruby-identifier">type</span> = <span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>
157: <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">type</span>)
158: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
159: <span class="ruby-keyword kw">return</span>
160: <span class="ruby-keyword kw">end</span>
161: 
162: <span class="ruby-comment cmt"># Default to `{:css => {}, :js => {}}`</span>
163: <span class="ruby-ivar">@asset_exists</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">inject</span>({}) { <span class="ruby-operator">|</span><span class="ruby-identifier">hsh</span>, <span class="ruby-identifier">t</span><span class="ruby-operator">|</span> <span class="ruby-identifier">hsh</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">t</span> =<span class="ruby-operator">></span> {}) }
164: 
165: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@asset_exists</span>[<span class="ruby-identifier">type</span>][<span class="ruby-identifier">filename</span>].<span class="ruby-identifier">nil?</span>
166: <span class="ruby-ivar">@asset_exists</span>[<span class="ruby-identifier">type</span>][<span class="ruby-identifier">filename</span>] =
167: <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">assets_dir</span>(<span class="ruby-identifier">type</span>), <span class="ruby-identifier">filename</span>))
168: <span class="ruby-keyword kw">end</span>
169: <span class="ruby-ivar">@asset_exists</span>[<span class="ruby-identifier">type</span>][<span class="ruby-identifier">filename</span>]
170: <span class="ruby-keyword kw">end</span></pre>
|
|
230
218
|
</div>
|
|
231
219
|
</div>
|
|
232
220
|
<div class='method public-class' id='method-M000006'>
|
|
@@ -239,7 +227,7 @@
|
|
|
239
227
|
<p>
|
|
240
228
|
Returns the relative path to the directory where the original <a
|
|
241
229
|
href="AssetHat/CSS.html">CSS</a> or <a href="AssetHat/JS.html">JS</a> files
|
|
242
|
-
are stored.
|
|
230
|
+
are stored. For internal filesystem use.
|
|
243
231
|
</p>
|
|
244
232
|
<p>
|
|
245
233
|
<tt>type</tt> argument: <tt>:css</tt> or <tt>:js</tt>
|
|
@@ -249,11 +237,34 @@
|
|
|
249
237
|
<a class='source-toggle' href='#' onclick="toggleCode('M000006-source'); return false">
|
|
250
238
|
[show source]
|
|
251
239
|
</a>
|
|
252
|
-
<pre id='M000006-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line
|
|
240
|
+
<pre id='M000006-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 63</span>
63: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">assets_dir</span>(<span class="ruby-identifier">type</span>)
64: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>
65: <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:css</span> ; <span class="ruby-constant">STYLESHEETS_DIR</span>
66: <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:js</span> ; <span class="ruby-constant">JAVASCRIPTS_DIR</span>
67: <span class="ruby-keyword kw">else</span>
68: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
69: <span class="ruby-keyword kw">nil</span>
70: <span class="ruby-keyword kw">end</span>
71: <span class="ruby-keyword kw">end</span></pre>
|
|
253
241
|
</div>
|
|
254
242
|
</div>
|
|
255
|
-
<div class='method public-class' id='method-
|
|
256
|
-
<a name='
|
|
243
|
+
<div class='method public-class' id='method-M000007'>
|
|
244
|
+
<a name='M000007'></a>
|
|
245
|
+
<div class='synopsis'>
|
|
246
|
+
<span class='name'>assets_path</span>
|
|
247
|
+
<span class='arguments'>(type)</span>
|
|
248
|
+
</div>
|
|
249
|
+
<div class='description'>
|
|
250
|
+
<p>
|
|
251
|
+
Returns the root URL path where the original <a
|
|
252
|
+
href="AssetHat/CSS.html">CSS</a> or <a href="AssetHat/JS.html">JS</a> files
|
|
253
|
+
are stored. For external URL-building use.
|
|
254
|
+
</p>
|
|
255
|
+
<p>
|
|
256
|
+
<tt>type</tt> argument: <tt>:css</tt> or <tt>:js</tt>
|
|
257
|
+
</p>
|
|
258
|
+
</div>
|
|
259
|
+
<div class='source'>
|
|
260
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000007-source'); return false">
|
|
261
|
+
[show source]
|
|
262
|
+
</a>
|
|
263
|
+
<pre id='M000007-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 77</span>
77: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">assets_path</span>(<span class="ruby-identifier">type</span>)
78: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>
79: <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:css</span> ; <span class="ruby-constant">STYLESHEETS_PATH</span>
80: <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:js</span> ; <span class="ruby-constant">JAVASCRIPTS_PATH</span>
81: <span class="ruby-keyword kw">else</span>
82: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
83: <span class="ruby-keyword kw">nil</span>
84: <span class="ruby-keyword kw">end</span>
85: <span class="ruby-keyword kw">end</span></pre>
|
|
264
|
+
</div>
|
|
265
|
+
</div>
|
|
266
|
+
<div class='method public-class' id='method-M000014'>
|
|
267
|
+
<a name='M000014'></a>
|
|
257
268
|
<div class='synopsis'>
|
|
258
269
|
<span class='name'>bundle_filenames</span>
|
|
259
270
|
<span class='arguments'>(bundle, type)</span>
|
|
@@ -262,17 +273,17 @@
|
|
|
262
273
|
<p>
|
|
263
274
|
Returns the extension-less names of files in the given bundle:
|
|
264
275
|
</p>
|
|
265
|
-
<pre>AssetHat.bundle_filenames('application', :css)
 # => ['reset', 'application'
|
|
276
|
+
<pre>AssetHat.bundle_filenames('application', :css)
 # => ['reset', 'application']
AssetHat.bundle_filenames('non-existent-file', :css)
 # => nil</pre>
|
|
266
277
|
</div>
|
|
267
278
|
<div class='source'>
|
|
268
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
279
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000014-source'); return false">
|
|
269
280
|
[show source]
|
|
270
281
|
</a>
|
|
271
|
-
<pre id='
|
|
282
|
+
<pre id='M000014-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 210</span>
210: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bundle_filenames</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>)
211: <span class="ruby-comment cmt"># Process arguments</span>
212: <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>)
213: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
214: <span class="ruby-keyword kw">return</span>
215: <span class="ruby-keyword kw">end</span>
216: 
217: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">config</span>[<span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_s</span>][<span class="ruby-value str">'bundles'</span>][<span class="ruby-identifier">bundle</span>.<span class="ruby-identifier">to_s</span>] <span class="ruby-keyword kw">rescue</span> <span class="ruby-keyword kw">nil</span>
218: <span class="ruby-keyword kw">end</span></pre>
|
|
272
283
|
</div>
|
|
273
284
|
</div>
|
|
274
|
-
<div class='method public-class' id='method-
|
|
275
|
-
<a name='
|
|
285
|
+
<div class='method public-class' id='method-M000015'>
|
|
286
|
+
<a name='M000015'></a>
|
|
276
287
|
<div class='synopsis'>
|
|
277
288
|
<span class='name'>bundle_filepaths</span>
|
|
278
289
|
<span class='arguments'>(bundle, type)</span>
|
|
@@ -281,17 +292,17 @@
|
|
|
281
292
|
<p>
|
|
282
293
|
Returns the full paths of files in the given bundle:
|
|
283
294
|
</p>
|
|
284
|
-
<pre>AssetHat.bundle_filenames('application', :css)
 # => ['/path/to/app/public/stylesheets/reset.css',
 '/path/to/app/public/stylesheets/application.css'
|
|
295
|
+
<pre>AssetHat.bundle_filenames('application', :css)
 # => ['/path/to/app/public/stylesheets/reset.css',
 '/path/to/app/public/stylesheets/application.css']
AssetHat.bundle_filenames('non-existent-file', :css)
 # => nil</pre>
|
|
285
296
|
</div>
|
|
286
297
|
<div class='source'>
|
|
287
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
298
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000015-source'); return false">
|
|
288
299
|
[show source]
|
|
289
300
|
</a>
|
|
290
|
-
<pre id='
|
|
301
|
+
<pre id='M000015-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 227</span>
227: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bundle_filepaths</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>)
228: <span class="ruby-comment cmt"># Process arguments</span>
229: <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>)
230: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
231: <span class="ruby-keyword kw">return</span>
232: <span class="ruby-keyword kw">end</span>
233: 
234: <span class="ruby-identifier">dir</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">assets_dir</span>(<span class="ruby-identifier">type</span>)
235: <span class="ruby-identifier">filenames</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bundle_filenames</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>)
236: <span class="ruby-identifier">filepaths</span> = <span class="ruby-identifier">filenames</span>.<span class="ruby-identifier">present?</span> <span class="ruby-value">?
237: </span> <span class="ruby-identifier">filenames</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>, <span class="ruby-node">"#{fn}.#{type}"</span>) } <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
238: <span class="ruby-keyword kw">end</span></pre>
|
|
291
302
|
</div>
|
|
292
303
|
</div>
|
|
293
|
-
<div class='method public-class' id='method-
|
|
294
|
-
<a name='
|
|
304
|
+
<div class='method public-class' id='method-M000008'>
|
|
305
|
+
<a name='M000008'></a>
|
|
295
306
|
<div class='synopsis'>
|
|
296
307
|
<span class='name'>bundles_dir</span>
|
|
297
308
|
<span class='arguments'>(*args)</span>
|
|
@@ -300,7 +311,7 @@
|
|
|
300
311
|
<p>
|
|
301
312
|
Returns the relative path to the directory where <a
|
|
302
313
|
href="AssetHat/CSS.html">CSS</a> or <a href="AssetHat/JS.html">JS</a>
|
|
303
|
-
bundles are stored.
|
|
314
|
+
bundles are stored. For internal filesystem use.
|
|
304
315
|
</p>
|
|
305
316
|
<p>
|
|
306
317
|
Usage:
|
|
@@ -317,14 +328,47 @@
|
|
|
317
328
|
</dl>
|
|
318
329
|
</div>
|
|
319
330
|
<div class='source'>
|
|
320
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
331
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000008-source'); return false">
|
|
321
332
|
[show source]
|
|
322
333
|
</a>
|
|
323
|
-
<pre id='
|
|
334
|
+
<pre id='M000008-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 105</span>
105: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bundles_dir</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
106: <span class="ruby-identifier">options</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">extract_options!</span>
107: <span class="ruby-identifier">options</span>.<span class="ruby-identifier">symbolize_keys!</span>.<span class="ruby-identifier">reverse_merge!</span>(<span class="ruby-identifier">:ssl</span> =<span class="ruby-operator">></span> <span class="ruby-keyword kw">false</span>)
108: <span class="ruby-identifier">type</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span>
109: 
110: <span class="ruby-identifier">dir</span> = <span class="ruby-identifier">type</span>.<span class="ruby-identifier">present?</span> <span class="ruby-value">? </span><span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">assets_dir</span>(<span class="ruby-identifier">type</span>), <span class="ruby-value str">'bundles'</span>) <span class="ruby-operator">:</span> <span class="ruby-value str">'bundles'</span>
111: <span class="ruby-identifier">dir</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">dir</span>, <span class="ruby-value str">'ssl'</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:ssl</span>]
112: <span class="ruby-identifier">dir</span>
113: <span class="ruby-keyword kw">end</span></pre>
|
|
324
335
|
</div>
|
|
325
336
|
</div>
|
|
326
337
|
<div class='method public-class' id='method-M000009'>
|
|
327
338
|
<a name='M000009'></a>
|
|
339
|
+
<div class='synopsis'>
|
|
340
|
+
<span class='name'>bundles_path</span>
|
|
341
|
+
<span class='arguments'>(type, options={})</span>
|
|
342
|
+
</div>
|
|
343
|
+
<div class='description'>
|
|
344
|
+
<p>
|
|
345
|
+
Returns the root URL path where <a href="AssetHat/CSS.html">CSS</a> or <a
|
|
346
|
+
href="AssetHat/JS.html">JS</a> bundles are stored. For external
|
|
347
|
+
URL-building use.
|
|
348
|
+
</p>
|
|
349
|
+
<p>
|
|
350
|
+
Usage:
|
|
351
|
+
</p>
|
|
352
|
+
<pre>AssetHat.bundles_path(:css)
 # => 'public/stylesheets/bundles'
AssetHat.bundles_path(:js, :ssl => true)
 # => 'public/javascripts/bundles/ssl</pre>
|
|
353
|
+
<p>
|
|
354
|
+
Options:
|
|
355
|
+
</p>
|
|
356
|
+
<dl>
|
|
357
|
+
<dt>ssl</dt><dd>Set this to <tt>true</tt> if the stylesheet references images via SSL.
|
|
358
|
+
Defaults to <tt>false</tt>.
|
|
359
|
+
|
|
360
|
+
</dd>
|
|
361
|
+
</dl>
|
|
362
|
+
</div>
|
|
363
|
+
<div class='source'>
|
|
364
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000009-source'); return false">
|
|
365
|
+
[show source]
|
|
366
|
+
</a>
|
|
367
|
+
<pre id='M000009-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 129</span>
129: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bundles_path</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">options</span>={})
130: <span class="ruby-identifier">type</span> = <span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>
131: <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">type</span>)
132: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
133: <span class="ruby-keyword kw">return</span>
134: <span class="ruby-keyword kw">end</span>
135: 
136: <span class="ruby-identifier">path</span> = <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">type</span>
137: <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:css</span> ; <span class="ruby-constant">STYLESHEETS_PATH</span>
138: <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:js</span> ; <span class="ruby-constant">JAVASCRIPTS_PATH</span>
139: <span class="ruby-keyword kw">else</span> <span class="ruby-keyword kw">nil</span>
140: <span class="ruby-keyword kw">end</span>
141: <span class="ruby-identifier">path</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">'/bundles'</span>
142: <span class="ruby-identifier">path</span> <span class="ruby-operator">+=</span> <span class="ruby-value str">'/ssl'</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:ssl</span>]
143: <span class="ruby-identifier">path</span>
144: <span class="ruby-keyword kw">end</span></pre>
|
|
368
|
+
</div>
|
|
369
|
+
</div>
|
|
370
|
+
<div class='method public-class' id='method-M000011'>
|
|
371
|
+
<a name='M000011'></a>
|
|
328
372
|
<div class='synopsis'>
|
|
329
373
|
<span class='name'>cache?</span>
|
|
330
374
|
<span class='arguments'>()</span>
|
|
@@ -334,19 +378,19 @@
|
|
|
334
378
|
Returns <tt>true</tt> if bundles should be included as single minified
|
|
335
379
|
files (e.g., in production), or <tt>false</tt> if bundles should be
|
|
336
380
|
included as separate, unminified files (e.g., in development). To modify
|
|
337
|
-
this value, set <tt>config.action_controller.perform_caching
|
|
338
|
-
your environment.
|
|
381
|
+
this value, set <tt>config.action_controller.perform_caching</tt> (boolean)
|
|
382
|
+
in your environment.
|
|
339
383
|
</p>
|
|
340
384
|
</div>
|
|
341
385
|
<div class='source'>
|
|
342
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
386
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000011-source'); return false">
|
|
343
387
|
[show source]
|
|
344
388
|
</a>
|
|
345
|
-
<pre id='
|
|
389
|
+
<pre id='M000011-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 178</span>
178: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">cache?</span> ; <span class="ruby-constant">ActionController</span><span class="ruby-operator">::</span><span class="ruby-constant">Base</span>.<span class="ruby-identifier">perform_caching</span> ; <span class="ruby-keyword kw">end</span></pre>
|
|
346
390
|
</div>
|
|
347
391
|
</div>
|
|
348
|
-
<div class='method public-class' id='method-
|
|
349
|
-
<a name='
|
|
392
|
+
<div class='method public-class' id='method-M000004'>
|
|
393
|
+
<a name='M000004'></a>
|
|
350
394
|
<div class='synopsis'>
|
|
351
395
|
<span class='name'>cache_last_commit_ids</span>
|
|
352
396
|
<span class='arguments'>()</span>
|
|
@@ -358,27 +402,27 @@
|
|
|
358
402
|
</p>
|
|
359
403
|
</div>
|
|
360
404
|
<div class='source'>
|
|
361
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
405
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000004-source'); return false">
|
|
362
406
|
[show source]
|
|
363
407
|
</a>
|
|
364
|
-
<pre id='
|
|
408
|
+
<pre id='M000004-source'> <span class="ruby-comment cmt"># File lib/asset_hat/vcs.rb, line 75</span>
75: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">cache_last_commit_ids</span>
76: <span class="ruby-constant">AssetHat</span><span class="ruby-operator">::</span><span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">type</span><span class="ruby-operator">|</span>
77: <span class="ruby-keyword kw">next</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">config</span>[<span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_s</span>].<span class="ruby-identifier">blank?</span> <span class="ruby-operator">||</span>
78: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">config</span>[<span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_s</span>][<span class="ruby-value str">'bundles'</span>].<span class="ruby-identifier">blank?</span>
79: 
80: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">config</span>[<span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_s</span>][<span class="ruby-value str">'bundles'</span>].<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">bundle</span><span class="ruby-operator">|</span>
81: <span class="ruby-comment cmt"># Memoize commit ID for this bundle</span>
82: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">last_bundle_commit_id</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">cache?</span>
83: 
84: <span class="ruby-comment cmt"># Memoize commit IDs for each file in this bundle</span>
85: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">bundle_filepaths</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filepath</span><span class="ruby-operator">|</span>
86: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">last_commit_id</span>(<span class="ruby-identifier">filepath</span>)
87: <span class="ruby-keyword kw">end</span>
88: <span class="ruby-keyword kw">end</span>
89: <span class="ruby-keyword kw">end</span>
90: <span class="ruby-keyword kw">end</span></pre>
|
|
365
409
|
</div>
|
|
366
410
|
</div>
|
|
367
|
-
<div class='method public-class' id='method-
|
|
368
|
-
<a name='
|
|
411
|
+
<div class='method public-class' id='method-M000018'>
|
|
412
|
+
<a name='M000018'></a>
|
|
369
413
|
<div class='synopsis'>
|
|
370
414
|
<span class='name'>clear_html_cache</span>
|
|
371
415
|
<span class='arguments'>()</span>
|
|
372
416
|
</div>
|
|
373
417
|
<div class='source'>
|
|
374
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
418
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000018-source'); return false">
|
|
375
419
|
[show source]
|
|
376
420
|
</a>
|
|
377
|
-
<pre id='
|
|
421
|
+
<pre id='M000018-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 294</span>
294: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">clear_html_cache</span>
295: <span class="ruby-identifier">html_cache</span> = {}
296: <span class="ruby-keyword kw">end</span></pre>
|
|
378
422
|
</div>
|
|
379
423
|
</div>
|
|
380
|
-
<div class='method public-class' id='method-
|
|
381
|
-
<a name='
|
|
424
|
+
<div class='method public-class' id='method-M000016'>
|
|
425
|
+
<a name='M000016'></a>
|
|
382
426
|
<div class='synopsis'>
|
|
383
427
|
<span class='name'>compute_asset_host</span>
|
|
384
428
|
<span class='arguments'>(asset_host, source, options={})</span>
|
|
@@ -387,7 +431,7 @@
|
|
|
387
431
|
<p>
|
|
388
432
|
Reads <tt>ActionController::Base.asset_host</tt>, which can be a String or
|
|
389
433
|
Proc, and returns a String. Should behave just like Rails 2.3.x’s
|
|
390
|
-
private `<a href="AssetHat.html#
|
|
434
|
+
private `<a href="AssetHat.html#M000016">compute_asset_host</a>` method,
|
|
391
435
|
but with a simulated request.
|
|
392
436
|
</p>
|
|
393
437
|
<p>
|
|
@@ -410,10 +454,10 @@
|
|
|
410
454
|
</dl>
|
|
411
455
|
</div>
|
|
412
456
|
<div class='source'>
|
|
413
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
457
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000016-source'); return false">
|
|
414
458
|
[show source]
|
|
415
459
|
</a>
|
|
416
|
-
<pre id='
|
|
460
|
+
<pre id='M000016-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 263</span>
263: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">compute_asset_host</span>(<span class="ruby-identifier">asset_host</span>, <span class="ruby-identifier">source</span>, <span class="ruby-identifier">options</span>={})
264: <span class="ruby-identifier">host</span> = <span class="ruby-identifier">asset_host</span>
265: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">host</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Proc</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">host</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:call</span>)
266: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">host</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Proc</span>) <span class="ruby-operator">?</span>
267: <span class="ruby-identifier">host</span>.<span class="ruby-identifier">arity</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">host</span>.<span class="ruby-identifier">method</span>(<span class="ruby-identifier">:call</span>).<span class="ruby-identifier">arity</span>
268: <span class="ruby-keyword kw">when</span> <span class="ruby-value">2</span>
269: <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">ActionDispatch</span>)
270: <span class="ruby-identifier">request_class</span> = <span class="ruby-constant">ActionDispatch</span><span class="ruby-operator">::</span><span class="ruby-constant">Request</span>
271: <span class="ruby-keyword kw">else</span> <span class="ruby-comment cmt"># Rails 2.x</span>
272: <span class="ruby-identifier">request_class</span> = <span class="ruby-constant">ActionController</span><span class="ruby-operator">::</span><span class="ruby-constant">Request</span>
273: <span class="ruby-keyword kw">end</span>
274: <span class="ruby-identifier">request</span> = <span class="ruby-identifier">request_class</span>.<span class="ruby-identifier">new</span>(
275: <span class="ruby-value str">'HTTPS'</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:ssl</span>] <span class="ruby-operator">?</span> <span class="ruby-value str">'on'</span> <span class="ruby-operator">:</span> <span class="ruby-value str">'off'</span>)
276: <span class="ruby-identifier">host</span> = <span class="ruby-identifier">host</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">source</span>, <span class="ruby-identifier">request</span>)
277: <span class="ruby-keyword kw">else</span>
278: <span class="ruby-identifier">host</span> = <span class="ruby-identifier">host</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">source</span>)
279: <span class="ruby-keyword kw">end</span>
280: <span class="ruby-keyword kw">else</span>
281: <span class="ruby-identifier">host</span> <span class="ruby-operator">%=</span> (<span class="ruby-identifier">source</span>.<span class="ruby-identifier">hash</span> <span class="ruby-operator">%</span> <span class="ruby-value">4</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">host</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/%d/</span>
282: <span class="ruby-keyword kw">end</span>
283: <span class="ruby-identifier">host</span>
284: <span class="ruby-keyword kw">end</span></pre>
|
|
417
461
|
</div>
|
|
418
462
|
</div>
|
|
419
463
|
<div class='method public-class' id='method-M000005'>
|
|
@@ -431,11 +475,32 @@
|
|
|
431
475
|
<a class='source-toggle' href='#' onclick="toggleCode('M000005-source'); return false">
|
|
432
476
|
[show source]
|
|
433
477
|
</a>
|
|
434
|
-
<pre id='M000005-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line
|
|
478
|
+
<pre id='M000005-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 47</span>
47: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">config</span>
48: <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-constant">CONFIG_FILEPATH</span>)
49: <span class="ruby-identifier">raise</span> <span class="ruby-value str">'`config/assets.yml` is missing! '</span> <span class="ruby-operator">+</span>
50: <span class="ruby-value str">'Run `rake asset_hat:config` to generate it.'</span> <span class="ruby-keyword kw">and</span> <span class="ruby-keyword kw">return</span>
51: <span class="ruby-keyword kw">end</span>
52: 
53: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">cache?</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@config</span>.<span class="ruby-identifier">blank?</span>
54: <span class="ruby-ivar">@config</span> = <span class="ruby-constant">YAML</span>.<span class="ruby-identifier">load</span>(<span class="ruby-constant">ERB</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">read</span>(<span class="ruby-constant">CONFIG_FILEPATH</span>)).<span class="ruby-identifier">result</span>)
55: <span class="ruby-keyword kw">end</span>
56: <span class="ruby-ivar">@config</span>
57: <span class="ruby-keyword kw">end</span></pre>
|
|
435
479
|
</div>
|
|
436
480
|
</div>
|
|
437
|
-
<div class='method public-class' id='method-
|
|
438
|
-
<a name='
|
|
481
|
+
<div class='method public-class' id='method-M000012'>
|
|
482
|
+
<a name='M000012'></a>
|
|
483
|
+
<div class='synopsis'>
|
|
484
|
+
<span class='name'>consider_all_requests_local?</span>
|
|
485
|
+
<span class='arguments'>()</span>
|
|
486
|
+
</div>
|
|
487
|
+
<div class='description'>
|
|
488
|
+
<p>
|
|
489
|
+
Returns the value of
|
|
490
|
+
<tt>Rails.application.config.consider_all_requests_local</tt> or its
|
|
491
|
+
equivalent in older versions of Rails. To modify this value, set
|
|
492
|
+
<tt>config.consider_all_requests_local</tt> (boolean) in your environment.
|
|
493
|
+
</p>
|
|
494
|
+
</div>
|
|
495
|
+
<div class='source'>
|
|
496
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000012-source'); return false">
|
|
497
|
+
[show source]
|
|
498
|
+
</a>
|
|
499
|
+
<pre id='M000012-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 185</span>
185: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">consider_all_requests_local?</span>
186: <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">defined?</span>(<span class="ruby-constant">Rails</span>) <span class="ruby-operator">&&</span> <span class="ruby-constant">Rails</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:application</span>)
187: <span class="ruby-constant">Rails</span>.<span class="ruby-identifier">application</span>.<span class="ruby-identifier">config</span>.<span class="ruby-identifier">consider_all_requests_local</span>
188: <span class="ruby-keyword kw">else</span> <span class="ruby-comment cmt"># Rails 2.x</span>
189: <span class="ruby-constant">ActionController</span><span class="ruby-operator">::</span><span class="ruby-constant">Base</span>.<span class="ruby-identifier">consider_all_requests_local</span>
190: <span class="ruby-keyword kw">end</span>
191: <span class="ruby-keyword kw">end</span></pre>
|
|
500
|
+
</div>
|
|
501
|
+
</div>
|
|
502
|
+
<div class='method public-class' id='method-M000003'>
|
|
503
|
+
<a name='M000003'></a>
|
|
439
504
|
<div class='synopsis'>
|
|
440
505
|
<span class='name'>last_bundle_commit_id</span>
|
|
441
506
|
<span class='arguments'>(bundle, type)</span>
|
|
@@ -452,14 +517,14 @@
|
|
|
452
517
|
</p>
|
|
453
518
|
</div>
|
|
454
519
|
<div class='source'>
|
|
455
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
520
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000003-source'); return false">
|
|
456
521
|
[show source]
|
|
457
522
|
</a>
|
|
458
|
-
<pre id='
|
|
523
|
+
<pre id='M000003-source'> <span class="ruby-comment cmt"># File lib/asset_hat/vcs.rb, line 45</span>
45: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">last_bundle_commit_id</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>)
46: <span class="ruby-comment cmt"># Process arguments</span>
47: <span class="ruby-identifier">type</span> = <span class="ruby-identifier">type</span>.<span class="ruby-identifier">to_sym</span>
48: <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">type</span>)
49: <span class="ruby-identifier">raise</span> <span class="ruby-node">%{Unknown type "#{type}"; should be one of: #{TYPES.join(', ')}.}</span>
50: <span class="ruby-keyword kw">return</span>
51: <span class="ruby-keyword kw">end</span>
52: 
53: <span class="ruby-comment cmt"># Default to `{:css => {}, :js => {}}`</span>
54: <span class="ruby-ivar">@last_bundle_commit_ids</span> <span class="ruby-operator">||=</span>
55: <span class="ruby-constant">TYPES</span>.<span class="ruby-identifier">inject</span>({}) { <span class="ruby-operator">|</span><span class="ruby-identifier">hsh</span>, <span class="ruby-identifier">t</span><span class="ruby-operator">|</span> <span class="ruby-identifier">hsh</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">t</span> =<span class="ruby-operator">></span> {}) }
56: 
57: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@last_bundle_commit_ids</span>[<span class="ruby-identifier">type</span>][<span class="ruby-identifier">bundle</span>].<span class="ruby-identifier">blank?</span>
58: <span class="ruby-identifier">dir</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">assets_dir</span>(<span class="ruby-identifier">type</span>)
59: <span class="ruby-identifier">filepaths</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">bundle_filepaths</span>(<span class="ruby-identifier">bundle</span>, <span class="ruby-identifier">type</span>)
60: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">filepaths</span>.<span class="ruby-identifier">present?</span>
61: <span class="ruby-ivar">@last_bundle_commit_ids</span>[<span class="ruby-identifier">type</span>][<span class="ruby-identifier">bundle</span>] =
62: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">last_commit_id</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">filepaths</span>)
63: <span class="ruby-keyword kw">end</span>
64: <span class="ruby-keyword kw">end</span>
65: 
66: <span class="ruby-ivar">@last_bundle_commit_ids</span>[<span class="ruby-identifier">type</span>][<span class="ruby-identifier">bundle</span>]
67: <span class="ruby-keyword kw">end</span></pre>
|
|
459
524
|
</div>
|
|
460
525
|
</div>
|
|
461
|
-
<div class='method public-class' id='method-
|
|
462
|
-
<a name='
|
|
526
|
+
<div class='method public-class' id='method-M000002'>
|
|
527
|
+
<a name='M000002'></a>
|
|
463
528
|
<div class='synopsis'>
|
|
464
529
|
<span class='name'>last_commit_id</span>
|
|
465
530
|
<span class='arguments'>(*args)</span>
|
|
@@ -481,14 +546,14 @@
|
|
|
481
546
|
</dl>
|
|
482
547
|
</div>
|
|
483
548
|
<div class='source'>
|
|
484
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
549
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000002-source'); return false">
|
|
485
550
|
[show source]
|
|
486
551
|
</a>
|
|
487
|
-
<pre id='
|
|
552
|
+
<pre id='M000002-source'> <span class="ruby-comment cmt"># File lib/asset_hat/vcs.rb, line 18</span>
18: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">last_commit_id</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
19: <span class="ruby-comment cmt"># Process arguments</span>
20: <span class="ruby-identifier">options</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">extract_options!</span>
21: <span class="ruby-identifier">options</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">symbolize_keys</span>.<span class="ruby-identifier">reverse_merge</span>(<span class="ruby-identifier">:vcs</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">:git</span>)
22: <span class="ruby-identifier">filepaths</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">' '</span>)
23: 
24: <span class="ruby-comment cmt"># Validate options</span>
25: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:vcs</span>] <span class="ruby-operator">!=</span> <span class="ruby-identifier">:git</span>
26: <span class="ruby-identifier">raise</span> <span class="ruby-value str">'Git is currently the only supported VCS.'</span> <span class="ruby-keyword kw">and</span> <span class="ruby-keyword kw">return</span>
27: <span class="ruby-keyword kw">end</span>
28: 
29: <span class="ruby-ivar">@last_commit_ids</span> <span class="ruby-operator">||=</span> {}
30: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@last_commit_ids</span>[<span class="ruby-identifier">filepaths</span>].<span class="ruby-identifier">blank?</span>
31: <span class="ruby-identifier">h</span> = <span class="ruby-node">`git log -1 --pretty=format:%h #{filepaths} 2>/dev/null`</span>
32: <span class="ruby-comment cmt"># `h` has either the abbreviated Git commit hash or an empty string</span>
33: <span class="ruby-ivar">@last_commit_ids</span>[<span class="ruby-identifier">filepaths</span>] = <span class="ruby-identifier">h</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">h</span>.<span class="ruby-identifier">present?</span>
34: <span class="ruby-keyword kw">end</span>
35: <span class="ruby-ivar">@last_commit_ids</span>[<span class="ruby-identifier">filepaths</span>]
36: <span class="ruby-keyword kw">end</span></pre>
|
|
488
553
|
</div>
|
|
489
554
|
</div>
|
|
490
|
-
<div class='method public-class' id='method-
|
|
491
|
-
<a name='
|
|
555
|
+
<div class='method public-class' id='method-M000013'>
|
|
556
|
+
<a name='M000013'></a>
|
|
492
557
|
<div class='synopsis'>
|
|
493
558
|
<span class='name'>min_filepath</span>
|
|
494
559
|
<span class='arguments'>(filepath, extension)</span>
|
|
@@ -500,19 +565,19 @@
|
|
|
500
565
|
<pre>AssetHat.min_filepath('public/stylesheets/bundles/application.css', 'css')
 # => 'public/stylesheets/bundles/application.min.css'</pre>
|
|
501
566
|
<p>
|
|
502
567
|
See also <tt><a
|
|
503
|
-
href="AssetHat/CSS.html#
|
|
504
|
-
<tt><a href="AssetHat/JS.html#
|
|
568
|
+
href="AssetHat/CSS.html#M000019">AssetHat::CSS.min_filepath</a></tt> and
|
|
569
|
+
<tt><a href="AssetHat/JS.html#M000025">AssetHat::JS.min_filepath</a></tt>.
|
|
505
570
|
</p>
|
|
506
571
|
</div>
|
|
507
572
|
<div class='source'>
|
|
508
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
573
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000013-source'); return false">
|
|
509
574
|
[show source]
|
|
510
575
|
</a>
|
|
511
|
-
<pre id='
|
|
576
|
+
<pre id='M000013-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 200</span>
200: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min_filepath</span>(<span class="ruby-identifier">filepath</span>, <span class="ruby-identifier">extension</span>)
201: <span class="ruby-identifier">filepath</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-node">/([^\.]*).#{extension}$/</span>, <span class="ruby-node">"\\1.min.#{extension}"</span>)
202: <span class="ruby-keyword kw">end</span></pre>
|
|
512
577
|
</div>
|
|
513
578
|
</div>
|
|
514
|
-
<div class='method public-class' id='method-
|
|
515
|
-
<a name='
|
|
579
|
+
<div class='method public-class' id='method-M000017'>
|
|
580
|
+
<a name='M000017'></a>
|
|
516
581
|
<div class='synopsis'>
|
|
517
582
|
<span class='name'>ssl_asset_host_differs?</span>
|
|
518
583
|
<span class='arguments'>()</span>
|
|
@@ -524,14 +589,14 @@
|
|
|
524
589
|
</p>
|
|
525
590
|
</div>
|
|
526
591
|
<div class='source'>
|
|
527
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
592
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000017-source'); return false">
|
|
528
593
|
[show source]
|
|
529
594
|
</a>
|
|
530
|
-
<pre id='
|
|
595
|
+
<pre id='M000017-source'> <span class="ruby-comment cmt"># File lib/asset_hat.rb, line 288</span>
288: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">ssl_asset_host_differs?</span>
289: <span class="ruby-identifier">asset_host</span> = <span class="ruby-constant">ActionController</span><span class="ruby-operator">::</span><span class="ruby-constant">Base</span>.<span class="ruby-identifier">asset_host</span>
290: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">compute_asset_host</span>(<span class="ruby-identifier">asset_host</span>, <span class="ruby-value str">'x.png'</span>) <span class="ruby-operator">!=</span>
291: <span class="ruby-constant">AssetHat</span>.<span class="ruby-identifier">compute_asset_host</span>(<span class="ruby-identifier">asset_host</span>, <span class="ruby-value str">'x.png'</span>, <span class="ruby-identifier">:ssl</span> =<span class="ruby-operator">></span> <span class="ruby-keyword kw">true</span>)
292: <span class="ruby-keyword kw">end</span></pre>
|
|
531
596
|
</div>
|
|
532
597
|
</div>
|
|
533
|
-
<div class='method public-class' id='method-
|
|
534
|
-
<a name='
|
|
598
|
+
<div class='method public-class' id='method-M000001'>
|
|
599
|
+
<a name='M000001'></a>
|
|
535
600
|
<div class='synopsis'>
|
|
536
601
|
<span class='name'>version</span>
|
|
537
602
|
<span class='arguments'>()</span>
|
|
@@ -542,10 +607,10 @@
|
|
|
542
607
|
</p>
|
|
543
608
|
</div>
|
|
544
609
|
<div class='source'>
|
|
545
|
-
<a class='source-toggle' href='#' onclick="toggleCode('
|
|
610
|
+
<a class='source-toggle' href='#' onclick="toggleCode('M000001-source'); return false">
|
|
546
611
|
[show source]
|
|
547
612
|
</a>
|
|
548
|
-
<pre id='
|
|
613
|
+
<pre id='M000001-source'> <span class="ruby-comment cmt"># File lib/asset_hat/version.rb, line 3</span>
3: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">version</span>
4: <span class="ruby-identifier">data_filepath</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">dirname</span>(<span class="ruby-keyword kw">__FILE__</span>), <span class="ruby-node">%w[.. .. VERSION.yml]</span>)
5: <span class="ruby-identifier">data</span> = <span class="ruby-constant">YAML</span>.<span class="ruby-identifier">load</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">data_filepath</span>, <span class="ruby-value str">'r'</span>))
6: [<span class="ruby-identifier">:major</span>, <span class="ruby-identifier">:minor</span>, <span class="ruby-identifier">:patch</span>, <span class="ruby-identifier">:build</span>].
7: <span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span> <span class="ruby-identifier">data</span>[<span class="ruby-identifier">x</span>] }.<span class="ruby-identifier">reject</span>(<span class="ruby-operator">&</span><span class="ruby-identifier">:blank?</span>).<span class="ruby-identifier">join</span>(<span class="ruby-value str">'.'</span>)
8: <span class="ruby-keyword kw">end</span></pre>
|
|
549
614
|
</div>
|
|
550
615
|
</div>
|
|
551
616
|
</div>
|