Capcode 0.8.6 → 0.8.7
Sign up to get free protection for your applications and to get access to all the features.
- data/README.rdoc +72 -1
- data/doc/rdoc/classes/Capcode.html +549 -444
- data/doc/rdoc/classes/Capcode/Helpers.html +293 -133
- data/doc/rdoc/classes/Capcode/Helpers/Authorization.html +60 -29
- data/doc/rdoc/created.rid +1 -1
- data/doc/rdoc/files/README_rdoc.html +94 -8
- data/doc/rdoc/files/lib/capcode/configuration_rb.html +101 -0
- data/doc/rdoc/files/lib/capcode/helpers/auth_rb.html +1 -32
- data/doc/rdoc/files/lib/capcode/render/erb_rb.html +1 -1
- data/doc/rdoc/files/lib/capcode/render/haml_rb.html +1 -1
- data/doc/rdoc/files/lib/capcode/render/markaby_rb.html +1 -1
- data/doc/rdoc/files/lib/capcode/render/sass_rb.html +1 -1
- data/doc/rdoc/files/lib/capcode/render/text_rb.html +1 -1
- data/doc/rdoc/files/lib/capcode_rb.html +8 -1
- data/doc/rdoc/fr_file_index.html +1 -0
- data/doc/rdoc/fr_method_index.html +19 -11
- data/examples/blog-couchdb.rb +4 -3
- data/examples/erb/cf.rhtml +1 -0
- data/examples/haml/cf.haml +4 -1
- data/examples/render-erb.rb +4 -1
- data/examples/render-haml_sass.rb +6 -2
- data/examples/render-image.rb +70 -0
- data/examples/render-static.rb +4 -1
- data/examples/render-static.ru +0 -2
- data/examples/render-use.rb +31 -0
- data/examples/static/coderay.css +131 -0
- data/examples/static/index.html +19 -0
- data/lib/capcode.rb +125 -76
- data/lib/capcode/configuration.rb +39 -0
- data/lib/capcode/helpers/auth.rb +22 -23
- data/lib/capcode/render/erb.rb +25 -18
- data/lib/capcode/render/haml.rb +28 -19
- data/lib/capcode/render/markaby.rb +2 -1
- data/lib/capcode/render/sass.rb +19 -13
- data/lib/capcode/render/text.rb +1 -1
- data/lib/capcode/version.rb +1 -1
- metadata +8 -2
data/README.rdoc
CHANGED
|
@@ -12,6 +12,12 @@ Capcode is a web microframework
|
|
|
12
12
|
|
|
13
13
|
== FEATURES/PROBLEMS:
|
|
14
14
|
|
|
15
|
+
=== 0.8.7
|
|
16
|
+
* Route's captures are now passed to all methods in a coontroller
|
|
17
|
+
* Add :content_type option to renderers (see render-image.rb)
|
|
18
|
+
* Add Capcode.set for configuration. So Capcode::Herpers#erb_path=, Capcode::Herpers#sass_path= and Capcode::Herpers#haml_path= are deprecated, you must now use `set :erb, ...', `set :sass, ...' and `set :haml, ...' (see render-erb.rb and render-haml_sass.rb)
|
|
19
|
+
* Add Capcode.use to allow usage of Rack middlewares (see render-use.rb)
|
|
20
|
+
|
|
15
21
|
=== 0.8.6
|
|
16
22
|
* HUGE bug correction
|
|
17
23
|
|
|
@@ -291,7 +297,72 @@ See <tt>examples/blog-dm.rb</tt> and/or <tt>examples/blog-couchdb.rb</tt> for co
|
|
|
291
297
|
|
|
292
298
|
end
|
|
293
299
|
|
|
294
|
-
Capcode.run( )
|
|
300
|
+
Capcode.run( )
|
|
301
|
+
|
|
302
|
+
=== HTTP Authentication
|
|
303
|
+
|
|
304
|
+
# file: sample.rb
|
|
305
|
+
require 'rubygems'
|
|
306
|
+
require 'capcode'
|
|
307
|
+
|
|
308
|
+
module Capcode
|
|
309
|
+
class Public < Route '/public'
|
|
310
|
+
def get
|
|
311
|
+
render "This page is not protected"
|
|
312
|
+
end
|
|
313
|
+
end
|
|
314
|
+
|
|
315
|
+
class Private < Route '/private'
|
|
316
|
+
def get
|
|
317
|
+
http_authentication( :type => :digest, :realm => "Private part" ) {
|
|
318
|
+
{ "greg" => "p4ssw0rd" }
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
render "This page is private - Hello #{request.env['REMOTE_USER']}"
|
|
322
|
+
end
|
|
323
|
+
end
|
|
324
|
+
end
|
|
325
|
+
|
|
326
|
+
Capcode.run( )
|
|
327
|
+
|
|
328
|
+
Second example :
|
|
329
|
+
|
|
330
|
+
# file: sample.rb
|
|
331
|
+
require 'rubygems'
|
|
332
|
+
require 'capcode'
|
|
333
|
+
|
|
334
|
+
module Capcode
|
|
335
|
+
|
|
336
|
+
http_authentication( :type => :digest, :realm => "Private part", :routes => ['/admin', '/private'] ) {
|
|
337
|
+
{ "greg" => "p4ssw0rd" }
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
class Public < Route '/public'
|
|
341
|
+
def get
|
|
342
|
+
render "This page is not protected"
|
|
343
|
+
end
|
|
344
|
+
end
|
|
345
|
+
|
|
346
|
+
class Private < Route '/private'
|
|
347
|
+
def get
|
|
348
|
+
render "This page is private - Hello #{request.env['REMOTE_USER']}"
|
|
349
|
+
end
|
|
350
|
+
end
|
|
351
|
+
|
|
352
|
+
class PrivateAgain < Route '/private/again'
|
|
353
|
+
def get
|
|
354
|
+
render "This page is also private - Hello #{request.env['REMOTE_USER']}"
|
|
355
|
+
end
|
|
356
|
+
end
|
|
357
|
+
|
|
358
|
+
class Admin < Route '/admin'
|
|
359
|
+
def get
|
|
360
|
+
render "This page is private - Hello #{request.env['REMOTE_USER']}"
|
|
361
|
+
end
|
|
362
|
+
end
|
|
363
|
+
end
|
|
364
|
+
|
|
365
|
+
Capcode.run( )
|
|
295
366
|
|
|
296
367
|
== DEPLOYMENT
|
|
297
368
|
|
|
@@ -62,6 +62,10 @@
|
|
|
62
62
|
<a href="../files/lib/capcode/base/db_rb.html">
|
|
63
63
|
lib/capcode/base/db.rb
|
|
64
64
|
</a>
|
|
65
|
+
<br />
|
|
66
|
+
<a href="../files/lib/capcode/configuration_rb.html">
|
|
67
|
+
lib/capcode/configuration.rb
|
|
68
|
+
</a>
|
|
65
69
|
<br />
|
|
66
70
|
<a href="../files/lib/capcode/render/erb_rb.html">
|
|
67
71
|
lib/capcode/render/erb.rb
|
|
@@ -116,37 +120,6 @@
|
|
|
116
120
|
|
|
117
121
|
<div id="contextContent">
|
|
118
122
|
|
|
119
|
-
<div id="description">
|
|
120
|
-
<p>
|
|
121
|
-
Because this helper was trully inspired by this post : <a
|
|
122
|
-
href="http://www.gittr.com/index.php/archive/sinatra-basic-authentication-selectively-applied">www.gittr.com/index.php/archive/sinatra-basic-authentication-selectively-applied</a>/
|
|
123
|
-
and because the code in this post was extracted out of Wink, this file
|
|
124
|
-
follow the Wink license :
|
|
125
|
-
</p>
|
|
126
|
-
<p>
|
|
127
|
-
Permission is hereby granted, free of charge, to any person obtaining a
|
|
128
|
-
copy of this software and associated documentation files (the
|
|
129
|
-
"Software"), to deal in the Software without restriction,
|
|
130
|
-
including without limitation the rights to use, copy, modify, merge,
|
|
131
|
-
publish, distribute, sublicense, and/or sell copies of the Software, and to
|
|
132
|
-
permit persons to whom the Software is furnished to do so, subject to the
|
|
133
|
-
following conditions:
|
|
134
|
-
</p>
|
|
135
|
-
<p>
|
|
136
|
-
The above copyright notice and this permission notice shall be included in
|
|
137
|
-
all copies or substantial portions of the Software.
|
|
138
|
-
</p>
|
|
139
|
-
<p>
|
|
140
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
141
|
-
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
142
|
-
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
|
|
143
|
-
NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
|
|
144
|
-
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
|
145
|
-
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
|
|
146
|
-
USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
147
|
-
</p>
|
|
148
|
-
|
|
149
|
-
</div>
|
|
150
123
|
|
|
151
124
|
|
|
152
125
|
</div>
|
|
@@ -156,15 +129,18 @@ USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
156
129
|
|
|
157
130
|
<div class="name-list">
|
|
158
131
|
<a href="#M000001">Route</a>
|
|
159
|
-
<a href="#
|
|
132
|
+
<a href="#M000010">application</a>
|
|
133
|
+
<a href="#M000013">config</a>
|
|
160
134
|
<a href="#M000003">env</a>
|
|
161
|
-
<a href="#
|
|
135
|
+
<a href="#M000009">http_authentication</a>
|
|
162
136
|
<a href="#M000007">map</a>
|
|
163
137
|
<a href="#M000002">params</a>
|
|
164
138
|
<a href="#M000005">request</a>
|
|
165
139
|
<a href="#M000006">response</a>
|
|
166
|
-
<a href="#
|
|
140
|
+
<a href="#M000011">run</a>
|
|
167
141
|
<a href="#M000004">session</a>
|
|
142
|
+
<a href="#M000012">set</a>
|
|
143
|
+
<a href="#M000008">use</a>
|
|
168
144
|
</div>
|
|
169
145
|
</div>
|
|
170
146
|
|
|
@@ -244,10 +220,12 @@ Add routes to a controller class
|
|
|
244
220
|
<p>
|
|
245
221
|
In the <tt>get</tt> method, you will receive the maximum of parameters
|
|
246
222
|
declared by the routes. In this example, you will receive 2 parameters. So
|
|
247
|
-
if you go to <tt>/hello/world#friend</tt> then <tt>arg1</tt> will be
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
223
|
+
if you go to <tt>/hello/world#friend</tt> then <tt>arg1</tt> will be <a
|
|
224
|
+
href="Capcode.html#M000012">set</a> to <tt>world</tt> and <tt>arg2</tt>
|
|
225
|
+
will be <a href="Capcode.html#M000012">set</a> to <tt>friend</tt>. Now if
|
|
226
|
+
you go to <tt>/hello/you</tt>, then <tt>arg1</tt> will be <a
|
|
227
|
+
href="Capcode.html#M000012">set</a> to <tt>you</tt> and <tt>arg2</tt> will
|
|
228
|
+
be <a href="Capcode.html#M000012">set</a> to <tt>nil</tt>
|
|
251
229
|
</p>
|
|
252
230
|
<p>
|
|
253
231
|
If the regexp in the route does not match, all arguments will be
|
|
@@ -257,179 +235,179 @@ If the regexp in the route does not match, all arguments will be
|
|
|
257
235
|
onclick="toggleCode('M000001-source');return false;">[Source]</a></p>
|
|
258
236
|
<div class="method-source-code" id="M000001-source">
|
|
259
237
|
<pre>
|
|
260
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
399: <span class="ruby-identifier">finalNArgs</span> = <span class="ruby-identifier">diffNArgs</span>
|
|
377
|
-
400: <span class="ruby-identifier">finalArgs</span> = <span class="ruby-identifier">diffArgs</span>
|
|
378
|
-
401: <span class="ruby-keyword kw">end</span>
|
|
379
|
-
402: <span class="ruby-keyword kw">end</span>
|
|
380
|
-
403:
|
|
381
|
-
404: <span class="ruby-keyword kw">end</span>
|
|
382
|
-
405:
|
|
383
|
-
406: <span class="ruby-identifier">nargs</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">__urls__</span>[<span class="ruby-value">1</span>]
|
|
384
|
-
407: <span class="ruby-identifier">regexp</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">__urls__</span>[<span class="ruby-value">0</span>][<span class="ruby-identifier">finalPath</span>] )
|
|
385
|
-
408: <span class="ruby-identifier">args</span> = <span class="ruby-identifier">regexp</span>.<span class="ruby-identifier">match</span>( <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Utils</span>.<span class="ruby-identifier">unescape</span>(<span class="ruby-ivar">@request</span>.<span class="ruby-identifier">path</span>).<span class="ruby-identifier">gsub</span>( <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>( <span class="ruby-node">"^#{finalPath}"</span> ), <span class="ruby-value str">""</span> ).<span class="ruby-identifier">gsub</span>( <span class="ruby-regexp re">/^\//</span>, <span class="ruby-value str">""</span> ) )
|
|
386
|
-
409: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">nil?</span>
|
|
387
|
-
410: <span class="ruby-identifier">raise</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">ParameterError</span>, <span class="ruby-node">"Path info `#{@request.path_info}' does not match route regexp `#{regexp.source}'"</span>
|
|
388
|
-
411: <span class="ruby-keyword kw">else</span>
|
|
389
|
-
412: <span class="ruby-identifier">args</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">captures</span>.<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">x</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>)<span class="ruby-operator">?</span><span class="ruby-keyword kw">nil</span><span class="ruby-operator">:</span><span class="ruby-identifier">x</span> }
|
|
390
|
-
413: <span class="ruby-keyword kw">end</span>
|
|
391
|
-
414:
|
|
392
|
-
415: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-identifier">nargs</span>
|
|
393
|
-
416: <span class="ruby-identifier">args</span> <span class="ruby-operator"><<</span> <span class="ruby-keyword kw">nil</span>
|
|
238
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 302</span>
|
|
239
|
+
302: <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Route</span> <span class="ruby-operator">*</span><span class="ruby-identifier">routes_paths</span>
|
|
240
|
+
303: <span class="ruby-constant">Class</span>.<span class="ruby-identifier">new</span> {
|
|
241
|
+
304: <span class="ruby-identifier">meta_def</span>(<span class="ruby-identifier">:__urls__</span>) {
|
|
242
|
+
305: <span class="ruby-comment cmt"># < Route '/hello/world/([^\/]*)/id(\d*)', '/hello/(.*)', :agent => /Songbird (\d\.\d)[\d\/]*?/</span>
|
|
243
|
+
306: <span class="ruby-comment cmt"># # => [ {'/hello/world' => '([^\/]*)/id(\d*)', '/hello' => '(.*)'}, </span>
|
|
244
|
+
307: <span class="ruby-comment cmt"># 2, </span>
|
|
245
|
+
308: <span class="ruby-comment cmt"># <Capcode::Klass>, </span>
|
|
246
|
+
309: <span class="ruby-comment cmt"># {:agent => /Songbird (\d\.\d)[\d\/]*?/} ]</span>
|
|
247
|
+
310: <span class="ruby-identifier">hash_of_routes</span> = {}
|
|
248
|
+
311: <span class="ruby-identifier">max_captures_for_routes</span> = <span class="ruby-value">0</span>
|
|
249
|
+
312: <span class="ruby-identifier">routes_paths</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">current_route_path</span><span class="ruby-operator">|</span>
|
|
250
|
+
313: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">current_route_path</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">String</span>
|
|
251
|
+
314: <span class="ruby-identifier">m</span> = <span class="ruby-regexp re">/\/([^\/]*\(.*)/</span>.<span class="ruby-identifier">match</span>( <span class="ruby-identifier">current_route_path</span> )
|
|
252
|
+
315: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">m</span>.<span class="ruby-identifier">nil?</span>
|
|
253
|
+
316: <span class="ruby-identifier">raise</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">RouteError</span>, <span class="ruby-node">"Route `#{current_route_path}' already defined with regexp `#{hash_of_routes[current_route_path]}' !"</span>, <span class="ruby-identifier">caller</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash_of_routes</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">current_route_path</span>)
|
|
254
|
+
317: <span class="ruby-identifier">hash_of_routes</span>[<span class="ruby-identifier">current_route_path</span>] = <span class="ruby-value str">''</span>
|
|
255
|
+
318: <span class="ruby-keyword kw">else</span>
|
|
256
|
+
319: <span class="ruby-identifier">_pre</span> = <span class="ruby-identifier">m</span>.<span class="ruby-identifier">pre_match</span>
|
|
257
|
+
320: <span class="ruby-identifier">_pre</span> = <span class="ruby-value str">"/"</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">_pre</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
|
|
258
|
+
321: <span class="ruby-identifier">raise</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">RouteError</span>, <span class="ruby-node">"Route `#{_pre}' already defined with regexp `#{hash_of_routes[_pre]}' !"</span>, <span class="ruby-identifier">caller</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">hash_of_routes</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">_pre</span>)
|
|
259
|
+
322: <span class="ruby-identifier">hash_of_routes</span>[<span class="ruby-identifier">_pre</span>] = <span class="ruby-identifier">m</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">0</span>]
|
|
260
|
+
323: <span class="ruby-identifier">max_captures_for_routes</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">m</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">0</span>]).<span class="ruby-identifier">number_of_captures</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">max_captures_for_routes</span> <span class="ruby-operator"><</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">m</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">0</span>]).<span class="ruby-identifier">number_of_captures</span>
|
|
261
|
+
324: <span class="ruby-keyword kw">end</span>
|
|
262
|
+
325: <span class="ruby-keyword kw">else</span>
|
|
263
|
+
326: <span class="ruby-identifier">raise</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">ParameterError</span>, <span class="ruby-value str">"Bad route declaration !"</span>, <span class="ruby-identifier">caller</span>
|
|
264
|
+
327: <span class="ruby-keyword kw">end</span>
|
|
265
|
+
328: <span class="ruby-keyword kw">end</span>
|
|
266
|
+
329: [<span class="ruby-identifier">hash_of_routes</span>, <span class="ruby-identifier">max_captures_for_routes</span>, <span class="ruby-keyword kw">self</span>]
|
|
267
|
+
330: }
|
|
268
|
+
331:
|
|
269
|
+
332: <span class="ruby-comment cmt"># Hash containing all the request parameters (GET or POST)</span>
|
|
270
|
+
333: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">params</span>
|
|
271
|
+
334: <span class="ruby-ivar">@request</span>.<span class="ruby-identifier">params</span>
|
|
272
|
+
335: <span class="ruby-keyword kw">end</span>
|
|
273
|
+
336:
|
|
274
|
+
337: <span class="ruby-comment cmt"># Hash containing all the environment variables</span>
|
|
275
|
+
338: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">env</span>
|
|
276
|
+
339: <span class="ruby-ivar">@env</span>
|
|
277
|
+
340: <span class="ruby-keyword kw">end</span>
|
|
278
|
+
341:
|
|
279
|
+
342: <span class="ruby-comment cmt"># Session hash</span>
|
|
280
|
+
343: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">session</span>
|
|
281
|
+
344: <span class="ruby-ivar">@env</span>[<span class="ruby-value str">'rack.session'</span>]
|
|
282
|
+
345: <span class="ruby-keyword kw">end</span>
|
|
283
|
+
346:
|
|
284
|
+
347: <span class="ruby-comment cmt"># Return the Rack::Request object</span>
|
|
285
|
+
348: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">request</span>
|
|
286
|
+
349: <span class="ruby-ivar">@request</span>
|
|
287
|
+
350: <span class="ruby-keyword kw">end</span>
|
|
288
|
+
351:
|
|
289
|
+
352: <span class="ruby-comment cmt"># Return the Rack::Response object</span>
|
|
290
|
+
353: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">response</span>
|
|
291
|
+
354: <span class="ruby-ivar">@response</span>
|
|
292
|
+
355: <span class="ruby-keyword kw">end</span>
|
|
293
|
+
356:
|
|
294
|
+
357: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">call</span>( <span class="ruby-identifier">e</span> ) <span class="ruby-comment cmt">#:nodoc:</span>
|
|
295
|
+
358: <span class="ruby-ivar">@env</span> = <span class="ruby-identifier">e</span>
|
|
296
|
+
359: <span class="ruby-ivar">@response</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Response</span>.<span class="ruby-identifier">new</span>
|
|
297
|
+
360: <span class="ruby-ivar">@request</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Request</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@env</span>)
|
|
298
|
+
361:
|
|
299
|
+
362: <span class="ruby-comment cmt"># __k = self.class.to_s.split( /::/ )[-1].downcase.to_sym</span>
|
|
300
|
+
363: <span class="ruby-comment cmt"># @@__FILTERS.each do |f|</span>
|
|
301
|
+
364: <span class="ruby-comment cmt"># proc = f.delete(:action)</span>
|
|
302
|
+
365: <span class="ruby-comment cmt"># __run = true</span>
|
|
303
|
+
366: <span class="ruby-comment cmt"># if f[:only]</span>
|
|
304
|
+
367: <span class="ruby-comment cmt"># __run = f[:only].include?(__k)</span>
|
|
305
|
+
368: <span class="ruby-comment cmt"># end</span>
|
|
306
|
+
369: <span class="ruby-comment cmt"># if f[:except]</span>
|
|
307
|
+
370: <span class="ruby-comment cmt"># __run = !f[:except].include?(__k)</span>
|
|
308
|
+
371: <span class="ruby-comment cmt"># end</span>
|
|
309
|
+
372: <span class="ruby-comment cmt"># </span>
|
|
310
|
+
373: <span class="ruby-comment cmt"># # proc.call(self) if __run</span>
|
|
311
|
+
374: <span class="ruby-comment cmt"># puts "call #{proc} for #{__k}"</span>
|
|
312
|
+
375: <span class="ruby-comment cmt"># end</span>
|
|
313
|
+
376:
|
|
314
|
+
377: <span class="ruby-comment cmt"># Check authz</span>
|
|
315
|
+
378: <span class="ruby-identifier">authz_options</span> = <span class="ruby-keyword kw">nil</span>
|
|
316
|
+
379: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">__auth__</span> <span class="ruby-keyword kw">and</span> <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">__auth__</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">0</span>
|
|
317
|
+
380: <span class="ruby-identifier">authz_options</span> = <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">__auth__</span>[<span class="ruby-ivar">@request</span>.<span class="ruby-identifier">path</span>]<span class="ruby-operator">||</span><span class="ruby-keyword kw">nil</span>
|
|
318
|
+
381: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">authz_options</span>.<span class="ruby-identifier">nil?</span>
|
|
319
|
+
382: <span class="ruby-identifier">route</span> = <span class="ruby-keyword kw">nil</span>
|
|
320
|
+
383:
|
|
321
|
+
384: <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">__auth__</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">r</span>, <span class="ruby-identifier">o</span><span class="ruby-operator">|</span>
|
|
322
|
+
385: <span class="ruby-identifier">regexp</span> = <span class="ruby-node">"^#{r.gsub(/\/$/, "")}([/]{1}.*)?$"</span>
|
|
323
|
+
386: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">regexp</span>).<span class="ruby-identifier">match</span>( <span class="ruby-ivar">@request</span>.<span class="ruby-identifier">path</span> )
|
|
324
|
+
387: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">route</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">r</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-identifier">route</span>.<span class="ruby-identifier">size</span>
|
|
325
|
+
388: <span class="ruby-identifier">route</span> = <span class="ruby-identifier">r</span>
|
|
326
|
+
389: <span class="ruby-identifier">authz_options</span> = <span class="ruby-identifier">o</span>
|
|
327
|
+
390: <span class="ruby-keyword kw">end</span>
|
|
328
|
+
391: <span class="ruby-keyword kw">end</span>
|
|
329
|
+
392: <span class="ruby-keyword kw">end</span>
|
|
330
|
+
393: <span class="ruby-keyword kw">end</span>
|
|
331
|
+
394: <span class="ruby-keyword kw">end</span>
|
|
332
|
+
395:
|
|
333
|
+
396: <span class="ruby-identifier">r</span> = <span class="ruby-identifier">catch</span>(<span class="ruby-identifier">:halt</span>) {
|
|
334
|
+
397: <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">authz_options</span>.<span class="ruby-identifier">nil?</span>
|
|
335
|
+
398: <span class="ruby-identifier">http_authentication</span>( <span class="ruby-identifier">:type</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">authz_options</span>[<span class="ruby-identifier">:type</span>], <span class="ruby-identifier">:realm</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">authz_options</span>[<span class="ruby-identifier">:realm</span>], <span class="ruby-identifier">:opaque</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">authz_options</span>[<span class="ruby-identifier">:realm</span>] ) {
|
|
336
|
+
399: <span class="ruby-identifier">authz_options</span>[<span class="ruby-identifier">:autz</span>]
|
|
337
|
+
400: }
|
|
338
|
+
401: <span class="ruby-keyword kw">end</span>
|
|
339
|
+
402:
|
|
340
|
+
403: <span class="ruby-identifier">finalPath</span> = <span class="ruby-keyword kw">nil</span>
|
|
341
|
+
404: <span class="ruby-identifier">finalArgs</span> = <span class="ruby-keyword kw">nil</span>
|
|
342
|
+
405: <span class="ruby-identifier">finalNArgs</span> = <span class="ruby-keyword kw">nil</span>
|
|
343
|
+
406:
|
|
344
|
+
407: <span class="ruby-identifier">aPath</span> = <span class="ruby-ivar">@request</span>.<span class="ruby-identifier">path</span>.<span class="ruby-identifier">gsub</span>( <span class="ruby-regexp re">/^\//</span>, <span class="ruby-value str">""</span> ).<span class="ruby-identifier">split</span>( <span class="ruby-value str">"/"</span> )
|
|
345
|
+
408: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">__urls__</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">p</span>, <span class="ruby-identifier">r</span><span class="ruby-operator">|</span>
|
|
346
|
+
409: <span class="ruby-identifier">xPath</span> = <span class="ruby-identifier">p</span>.<span class="ruby-identifier">gsub</span>( <span class="ruby-regexp re">/^\//</span>, <span class="ruby-value str">""</span> ).<span class="ruby-identifier">split</span>( <span class="ruby-value str">"/"</span> )
|
|
347
|
+
410: <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">xPath</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">aPath</span>).<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
|
|
348
|
+
411: <span class="ruby-identifier">diffArgs</span> = <span class="ruby-identifier">aPath</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">xPath</span>
|
|
349
|
+
412: <span class="ruby-identifier">diffNArgs</span> = <span class="ruby-identifier">diffArgs</span>.<span class="ruby-identifier">size</span>
|
|
350
|
+
413: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">finalNArgs</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">finalNArgs</span> <span class="ruby-operator">></span> <span class="ruby-identifier">diffNArgs</span>
|
|
351
|
+
414: <span class="ruby-identifier">finalPath</span> = <span class="ruby-identifier">p</span>
|
|
352
|
+
415: <span class="ruby-identifier">finalNArgs</span> = <span class="ruby-identifier">diffNArgs</span>
|
|
353
|
+
416: <span class="ruby-identifier">finalArgs</span> = <span class="ruby-identifier">diffArgs</span>
|
|
394
354
|
417: <span class="ruby-keyword kw">end</span>
|
|
395
|
-
418:
|
|
396
|
-
419:
|
|
397
|
-
420:
|
|
398
|
-
421:
|
|
399
|
-
422:
|
|
400
|
-
423:
|
|
401
|
-
424:
|
|
402
|
-
425:
|
|
403
|
-
426:
|
|
404
|
-
427:
|
|
405
|
-
428:
|
|
406
|
-
429: <span class="ruby-
|
|
407
|
-
430:
|
|
408
|
-
431: <span class="ruby-
|
|
409
|
-
432: <span class="ruby-
|
|
355
|
+
418: <span class="ruby-keyword kw">end</span>
|
|
356
|
+
419:
|
|
357
|
+
420: <span class="ruby-keyword kw">end</span>
|
|
358
|
+
421:
|
|
359
|
+
422: <span class="ruby-identifier">nargs</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">__urls__</span>[<span class="ruby-value">1</span>]
|
|
360
|
+
423: <span class="ruby-identifier">regexp</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">__urls__</span>[<span class="ruby-value">0</span>][<span class="ruby-identifier">finalPath</span>] )
|
|
361
|
+
424: <span class="ruby-identifier">args</span> = <span class="ruby-identifier">regexp</span>.<span class="ruby-identifier">match</span>( <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Utils</span>.<span class="ruby-identifier">unescape</span>(<span class="ruby-ivar">@request</span>.<span class="ruby-identifier">path</span>).<span class="ruby-identifier">gsub</span>( <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>( <span class="ruby-node">"^#{finalPath}"</span> ), <span class="ruby-value str">""</span> ).<span class="ruby-identifier">gsub</span>( <span class="ruby-regexp re">/^\//</span>, <span class="ruby-value str">""</span> ) )
|
|
362
|
+
425: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">nil?</span>
|
|
363
|
+
426: <span class="ruby-identifier">raise</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">ParameterError</span>, <span class="ruby-node">"Path info `#{@request.path_info}' does not match route regexp `#{regexp.source}'"</span>
|
|
364
|
+
427: <span class="ruby-keyword kw">else</span>
|
|
365
|
+
428: <span class="ruby-identifier">args</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">captures</span>.<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">x</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>)<span class="ruby-operator">?</span><span class="ruby-keyword kw">nil</span><span class="ruby-operator">:</span><span class="ruby-identifier">x</span> }
|
|
366
|
+
429: <span class="ruby-keyword kw">end</span>
|
|
367
|
+
430:
|
|
368
|
+
431: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><</span> <span class="ruby-identifier">nargs</span>
|
|
369
|
+
432: <span class="ruby-identifier">args</span> <span class="ruby-operator"><<</span> <span class="ruby-keyword kw">nil</span>
|
|
410
370
|
433: <span class="ruby-keyword kw">end</span>
|
|
411
|
-
434:
|
|
412
|
-
435:
|
|
413
|
-
436:
|
|
414
|
-
437:
|
|
415
|
-
438:
|
|
416
|
-
439:
|
|
417
|
-
440:
|
|
418
|
-
441:
|
|
419
|
-
442:
|
|
420
|
-
443:
|
|
421
|
-
444:
|
|
422
|
-
445:
|
|
371
|
+
434:
|
|
372
|
+
435: <span class="ruby-keyword kw">case</span> <span class="ruby-ivar">@env</span>[<span class="ruby-value str">"REQUEST_METHOD"</span>]
|
|
373
|
+
436: <span class="ruby-keyword kw">when</span> <span class="ruby-value str">"GET"</span>
|
|
374
|
+
437: <span class="ruby-identifier">get</span>( <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> )
|
|
375
|
+
438: <span class="ruby-keyword kw">when</span> <span class="ruby-value str">"POST"</span>
|
|
376
|
+
439: <span class="ruby-identifier">_method</span> = <span class="ruby-identifier">params</span>.<span class="ruby-identifier">delete</span>( <span class="ruby-value str">"_method"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">_</span><span class="ruby-operator">|</span> <span class="ruby-value str">"post"</span> }
|
|
377
|
+
440: <span class="ruby-identifier">send</span>( <span class="ruby-identifier">_method</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> )
|
|
378
|
+
441: <span class="ruby-keyword kw">else</span>
|
|
379
|
+
442: <span class="ruby-identifier">_method</span> = <span class="ruby-ivar">@env</span>[<span class="ruby-value str">"REQUEST_METHOD"</span>]
|
|
380
|
+
443: <span class="ruby-identifier">send</span>( <span class="ruby-identifier">_method</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> )
|
|
381
|
+
444: <span class="ruby-keyword kw">end</span>
|
|
382
|
+
445: }
|
|
383
|
+
446: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">r</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_ary</span>)
|
|
384
|
+
447: <span class="ruby-ivar">@response</span>.<span class="ruby-identifier">status</span> = <span class="ruby-identifier">r</span>.<span class="ruby-identifier">shift</span> <span class="ruby-comment cmt">#r[0]</span>
|
|
385
|
+
448: <span class="ruby-comment cmt">#r[1].each do |k,v|</span>
|
|
386
|
+
449: <span class="ruby-identifier">r</span>.<span class="ruby-identifier">shift</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
|
|
387
|
+
450: <span class="ruby-ivar">@response</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">v</span>
|
|
388
|
+
451: <span class="ruby-keyword kw">end</span>
|
|
389
|
+
452: <span class="ruby-ivar">@response</span>.<span class="ruby-identifier">body</span> = <span class="ruby-identifier">r</span>.<span class="ruby-identifier">shift</span> <span class="ruby-comment cmt">#r[2]</span>
|
|
390
|
+
453: <span class="ruby-keyword kw">else</span>
|
|
391
|
+
454: <span class="ruby-ivar">@response</span>.<span class="ruby-identifier">write</span> <span class="ruby-identifier">r</span>
|
|
392
|
+
455: <span class="ruby-keyword kw">end</span>
|
|
393
|
+
456:
|
|
394
|
+
457: <span class="ruby-ivar">@response</span>.<span class="ruby-identifier">finish</span>
|
|
395
|
+
458: <span class="ruby-keyword kw">end</span>
|
|
396
|
+
459:
|
|
397
|
+
460: <span class="ruby-identifier">include</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">Helpers</span>
|
|
398
|
+
461: <span class="ruby-identifier">include</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">Views</span>
|
|
399
|
+
462: }
|
|
400
|
+
463: <span class="ruby-keyword kw">end</span>
|
|
423
401
|
</pre>
|
|
424
402
|
</div>
|
|
425
403
|
</div>
|
|
426
404
|
</div>
|
|
427
405
|
|
|
428
|
-
<div id="method-
|
|
429
|
-
<a name="
|
|
406
|
+
<div id="method-M000010" class="method-detail">
|
|
407
|
+
<a name="M000010"></a>
|
|
430
408
|
|
|
431
409
|
<div class="method-heading">
|
|
432
|
-
<a href="#
|
|
410
|
+
<a href="#M000010" class="method-signature">
|
|
433
411
|
<span class="method-name">application</span><span class="method-args">( args = {} ) {|self| ...}</span>
|
|
434
412
|
</a>
|
|
435
413
|
</div>
|
|
@@ -439,62 +417,104 @@ If the regexp in the route does not match, all arguments will be
|
|
|
439
417
|
Return the Rack App.
|
|
440
418
|
</p>
|
|
441
419
|
<p>
|
|
442
|
-
Options :
|
|
420
|
+
Options : see <a href="Capcode.html#M000012">Capcode.set</a>
|
|
421
|
+
</p>
|
|
422
|
+
<p>
|
|
423
|
+
Options <a href="Capcode.html#M000012">set</a> here replace the ones <a
|
|
424
|
+
href="Capcode.html#M000012">set</a> globally
|
|
443
425
|
</p>
|
|
444
426
|
<p><a class="source-toggle" href="#"
|
|
445
|
-
onclick="toggleCode('
|
|
446
|
-
<div class="method-source-code" id="
|
|
427
|
+
onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
|
|
428
|
+
<div class="method-source-code" id="M000010-source">
|
|
447
429
|
<pre>
|
|
448
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
430
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 549</span>
|
|
431
|
+
549: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">application</span>( <span class="ruby-identifier">args</span> = {} )
|
|
432
|
+
550: <span class="ruby-identifier">conf</span> = <span class="ruby-identifier">configuration</span>(<span class="ruby-identifier">args</span>)
|
|
433
|
+
551:
|
|
434
|
+
552: <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">constants</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
|
|
435
|
+
553: <span class="ruby-keyword kw">begin</span>
|
|
436
|
+
554: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">eval</span> <span class="ruby-node">"Capcode::#{k}.public_methods(true).include?( '__urls__' )"</span>
|
|
437
|
+
555: <span class="ruby-identifier">hash_of_routes</span>, <span class="ruby-identifier">max_captures_for_routes</span>, <span class="ruby-identifier">klass</span> = <span class="ruby-identifier">eval</span> <span class="ruby-node">"Capcode::#{k}.__urls__"</span>
|
|
438
|
+
556: <span class="ruby-identifier">hash_of_routes</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">current_route_path</span><span class="ruby-operator">|</span>
|
|
439
|
+
557: <span class="ruby-comment cmt">#raise Capcode::RouteError, "Route `#{current_route_path}' already define !", caller if @@__ROUTES.keys.include?(current_route_path)</span>
|
|
440
|
+
558: <span class="ruby-identifier">raise</span> <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">RouteError</span>, <span class="ruby-node">"Route `#{current_route_path}' already define !"</span>, <span class="ruby-identifier">caller</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">routes</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">current_route_path</span>)
|
|
441
|
+
559: <span class="ruby-comment cmt">#@@__ROUTES[current_route_path] = klass.new</span>
|
|
442
|
+
560: <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">routes</span>[<span class="ruby-identifier">current_route_path</span>] = <span class="ruby-identifier">klass</span>.<span class="ruby-identifier">new</span>
|
|
443
|
+
561: <span class="ruby-keyword kw">end</span>
|
|
444
|
+
562: <span class="ruby-keyword kw">end</span>
|
|
445
|
+
563: <span class="ruby-keyword kw">rescue</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">e</span>
|
|
446
|
+
564: <span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">message</span>
|
|
447
|
+
565: <span class="ruby-keyword kw">end</span>
|
|
448
|
+
566: <span class="ruby-keyword kw">end</span>
|
|
449
|
+
567:
|
|
450
|
+
568: <span class="ruby-comment cmt"># Set Static directory</span>
|
|
451
|
+
569: <span class="ruby-comment cmt">#@@__STATIC_DIR = (conf[:static][0].chr == "/")?conf[:static]:"/"+conf[:static] unless conf[:static].nil?</span>
|
|
452
|
+
570: <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">static</span> = (<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">chr</span> <span class="ruby-operator">==</span> <span class="ruby-value str">"/"</span>)<span class="ruby-operator">?</span><span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>]<span class="ruby-operator">:</span><span class="ruby-value str">"/"</span><span class="ruby-operator">+</span><span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>].<span class="ruby-identifier">nil?</span>
|
|
453
|
+
571:
|
|
454
|
+
572: <span class="ruby-comment cmt"># Initialize Rack App</span>
|
|
455
|
+
573: <span class="ruby-identifier">puts</span> <span class="ruby-value str">"** Map routes."</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>]
|
|
456
|
+
574: <span class="ruby-comment cmt">#app = Rack::URLMap.new(@@__ROUTES)</span>
|
|
457
|
+
575: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">URLMap</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">routes</span>)
|
|
458
|
+
576: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Initialize static directory (#{conf[:static]})"</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>]
|
|
459
|
+
577: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Static</span>.<span class="ruby-identifier">new</span>(
|
|
460
|
+
578: <span class="ruby-identifier">app</span>,
|
|
461
|
+
579: <span class="ruby-comment cmt">#:urls => [@@__STATIC_DIR], </span>
|
|
462
|
+
580: <span class="ruby-identifier">:urls</span> =<span class="ruby-operator">></span> [<span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">static</span>],
|
|
463
|
+
581: <span class="ruby-identifier">:root</span> =<span class="ruby-operator">></span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:root</span>])
|
|
464
|
+
582: ) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>].<span class="ruby-identifier">nil?</span>
|
|
465
|
+
583: <span class="ruby-identifier">puts</span> <span class="ruby-value str">"** Initialize session"</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>]
|
|
466
|
+
584: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Session</span><span class="ruby-operator">::</span><span class="ruby-constant">Cookie</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">app</span>, <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:session</span>] )
|
|
467
|
+
585: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Capcode</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTPError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">app</span>)
|
|
468
|
+
586: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ContentLength</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">app</span>)
|
|
469
|
+
587: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Lint</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">app</span>)
|
|
470
|
+
588: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">ShowExceptions</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">app</span>)
|
|
471
|
+
589: <span class="ruby-comment cmt">#app = Rack::Reloader.new(app) ## -- NE RELOAD QUE capcode.rb -- So !!!</span>
|
|
472
|
+
590: <span class="ruby-comment cmt"># app = Rack::CommonLogger.new( app, Logger.new(conf[:log]) )</span>
|
|
473
|
+
591:
|
|
474
|
+
592: <span class="ruby-identifier">middlewares</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">mw</span><span class="ruby-operator">|</span>
|
|
475
|
+
593: <span class="ruby-identifier">middleware</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">block</span> = <span class="ruby-identifier">mw</span>
|
|
476
|
+
594: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Load middleware #{middleware}"</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>]
|
|
477
|
+
595: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block</span>
|
|
478
|
+
596: <span class="ruby-identifier">app</span> = <span class="ruby-identifier">middleware</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">app</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span> )
|
|
479
|
+
597: <span class="ruby-keyword kw">else</span>
|
|
480
|
+
598: <span class="ruby-identifier">app</span> = <span class="ruby-identifier">middleware</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">app</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span> )
|
|
481
|
+
599: <span class="ruby-keyword kw">end</span>
|
|
482
|
+
600: <span class="ruby-keyword kw">end</span>
|
|
483
|
+
601:
|
|
484
|
+
602: <span class="ruby-comment cmt"># Start database</span>
|
|
485
|
+
603: <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">methods</span>.<span class="ruby-identifier">include?</span> <span class="ruby-value str">"db_connect"</span>
|
|
486
|
+
604: <span class="ruby-identifier">db_connect</span>( <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:db_config</span>], <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:log</span>] )
|
|
487
|
+
605: <span class="ruby-keyword kw">end</span>
|
|
488
|
+
606:
|
|
489
|
+
607: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
|
|
490
|
+
608: <span class="ruby-keyword kw">yield</span>( <span class="ruby-keyword kw">self</span> )
|
|
491
|
+
609: <span class="ruby-keyword kw">end</span>
|
|
492
|
+
610:
|
|
493
|
+
611: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">app</span>
|
|
494
|
+
612: <span class="ruby-keyword kw">end</span>
|
|
495
|
+
</pre>
|
|
496
|
+
</div>
|
|
497
|
+
</div>
|
|
498
|
+
</div>
|
|
499
|
+
|
|
500
|
+
<div id="method-M000013" class="method-detail">
|
|
501
|
+
<a name="M000013"></a>
|
|
502
|
+
|
|
503
|
+
<div class="method-heading">
|
|
504
|
+
<a href="#M000013" class="method-signature">
|
|
505
|
+
<span class="method-name">config</span><span class="method-args">()</span>
|
|
506
|
+
</a>
|
|
507
|
+
</div>
|
|
508
|
+
|
|
509
|
+
<div class="method-description">
|
|
510
|
+
<p><a class="source-toggle" href="#"
|
|
511
|
+
onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
|
|
512
|
+
<div class="method-source-code" id="M000013-source">
|
|
513
|
+
<pre>
|
|
514
|
+
<span class="ruby-comment cmt"># File lib/capcode/configuration.rb, line 35</span>
|
|
515
|
+
35: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">config</span>
|
|
516
|
+
36: <span class="ruby-ivar">@configuration</span> <span class="ruby-operator">||=</span> {}
|
|
517
|
+
37: <span class="ruby-keyword kw">end</span>
|
|
498
518
|
</pre>
|
|
499
519
|
</div>
|
|
500
520
|
</div>
|
|
@@ -517,20 +537,20 @@ Hash containing all the environment variables
|
|
|
517
537
|
onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
|
|
518
538
|
<div class="method-source-code" id="M000003-source">
|
|
519
539
|
<pre>
|
|
520
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
540
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 338</span>
|
|
541
|
+
338: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">env</span>
|
|
542
|
+
339: <span class="ruby-ivar">@env</span>
|
|
543
|
+
340: <span class="ruby-keyword kw">end</span>
|
|
524
544
|
</pre>
|
|
525
545
|
</div>
|
|
526
546
|
</div>
|
|
527
547
|
</div>
|
|
528
548
|
|
|
529
|
-
<div id="method-
|
|
530
|
-
<a name="
|
|
549
|
+
<div id="method-M000009" class="method-detail">
|
|
550
|
+
<a name="M000009"></a>
|
|
531
551
|
|
|
532
552
|
<div class="method-heading">
|
|
533
|
-
<a href="#
|
|
553
|
+
<a href="#M000009" class="method-signature">
|
|
534
554
|
<span class="method-name">http_authentication</span><span class="method-args">( opts = {}, &b )</span>
|
|
535
555
|
</a>
|
|
536
556
|
</div>
|
|
@@ -551,8 +571,10 @@ Options :
|
|
|
551
571
|
<li><tt>:realm</tt> : realm ;) - default : "Capcode.app"
|
|
552
572
|
|
|
553
573
|
</li>
|
|
554
|
-
<li><tt>:opaque</tt> : Your secret passphrase. You MUST
|
|
555
|
-
|
|
574
|
+
<li><tt>:opaque</tt> : Your secret passphrase. You MUST <a
|
|
575
|
+
href="Capcode.html#M000012">set</a> it if you <a
|
|
576
|
+
href="Capcode.html#M000008">use</a> Digest Auth - default :
|
|
577
|
+
"opaque"
|
|
556
578
|
|
|
557
579
|
</li>
|
|
558
580
|
<li><tt>:routes</tt> : Routes - default : "/"
|
|
@@ -570,30 +592,30 @@ The block must return a Hash of username => password like that :
|
|
|
570
592
|
}
|
|
571
593
|
</pre>
|
|
572
594
|
<p><a class="source-toggle" href="#"
|
|
573
|
-
onclick="toggleCode('
|
|
574
|
-
<div class="method-source-code" id="
|
|
595
|
+
onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
|
|
596
|
+
<div class="method-source-code" id="M000009-source">
|
|
575
597
|
<pre>
|
|
576
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
598
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 506</span>
|
|
599
|
+
506: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">http_authentication</span>( <span class="ruby-identifier">opts</span> = {}, <span class="ruby-operator">&</span><span class="ruby-identifier">b</span> )
|
|
600
|
+
507: <span class="ruby-identifier">options</span> = {
|
|
601
|
+
508: <span class="ruby-identifier">:type</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">:basic</span>,
|
|
602
|
+
509: <span class="ruby-identifier">:realm</span> =<span class="ruby-operator">></span> <span class="ruby-value str">"Capcode.app"</span>,
|
|
603
|
+
510: <span class="ruby-identifier">:opaque</span> =<span class="ruby-operator">></span> <span class="ruby-value str">"opaque"</span>,
|
|
604
|
+
511: <span class="ruby-identifier">:routes</span> =<span class="ruby-operator">></span> <span class="ruby-value str">"/"</span>
|
|
605
|
+
512: }.<span class="ruby-identifier">merge</span>( <span class="ruby-identifier">opts</span> )
|
|
606
|
+
513:
|
|
607
|
+
514: <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:autz</span>] = <span class="ruby-identifier">b</span>.<span class="ruby-identifier">call</span>()
|
|
608
|
+
515:
|
|
609
|
+
516: <span class="ruby-ivar">@__auth__</span> <span class="ruby-operator">||=</span> {}
|
|
610
|
+
517:
|
|
611
|
+
518: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:routes</span>].<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Array</span>
|
|
612
|
+
519: <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:routes</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">r</span><span class="ruby-operator">|</span>
|
|
613
|
+
520: <span class="ruby-ivar">@__auth__</span>[<span class="ruby-identifier">r</span>] = <span class="ruby-identifier">options</span>
|
|
614
|
+
521: <span class="ruby-keyword kw">end</span>
|
|
615
|
+
522: <span class="ruby-keyword kw">else</span>
|
|
616
|
+
523: <span class="ruby-ivar">@__auth__</span>[<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:routes</span>]] = <span class="ruby-identifier">options</span>
|
|
617
|
+
524: <span class="ruby-keyword kw">end</span>
|
|
618
|
+
525: <span class="ruby-keyword kw">end</span>
|
|
597
619
|
</pre>
|
|
598
620
|
</div>
|
|
599
621
|
</div>
|
|
@@ -622,10 +644,11 @@ Rack or What you want Helper
|
|
|
622
644
|
onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
|
|
623
645
|
<div class="method-source-code" id="M000007-source">
|
|
624
646
|
<pre>
|
|
625
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
647
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 470</span>
|
|
648
|
+
470: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">map</span>( <span class="ruby-identifier">route</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">b</span> )
|
|
649
|
+
471: <span class="ruby-comment cmt">#@@__ROUTES[route] = yield</span>
|
|
650
|
+
472: <span class="ruby-constant">Capcode</span>.<span class="ruby-identifier">routes</span>[<span class="ruby-identifier">route</span>] = <span class="ruby-keyword kw">yield</span>
|
|
651
|
+
473: <span class="ruby-keyword kw">end</span>
|
|
629
652
|
</pre>
|
|
630
653
|
</div>
|
|
631
654
|
</div>
|
|
@@ -649,10 +672,10 @@ parameters (GET or POST)
|
|
|
649
672
|
onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
|
|
650
673
|
<div class="method-source-code" id="M000002-source">
|
|
651
674
|
<pre>
|
|
652
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
675
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 333</span>
|
|
676
|
+
333: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">params</span>
|
|
677
|
+
334: <span class="ruby-ivar">@request</span>.<span class="ruby-identifier">params</span>
|
|
678
|
+
335: <span class="ruby-keyword kw">end</span>
|
|
656
679
|
</pre>
|
|
657
680
|
</div>
|
|
658
681
|
</div>
|
|
@@ -675,10 +698,10 @@ Return the Rack::Request object
|
|
|
675
698
|
onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
|
|
676
699
|
<div class="method-source-code" id="M000005-source">
|
|
677
700
|
<pre>
|
|
678
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
701
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 348</span>
|
|
702
|
+
348: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">request</span>
|
|
703
|
+
349: <span class="ruby-ivar">@request</span>
|
|
704
|
+
350: <span class="ruby-keyword kw">end</span>
|
|
682
705
|
</pre>
|
|
683
706
|
</div>
|
|
684
707
|
</div>
|
|
@@ -701,27 +724,202 @@ Return the Rack::Response object
|
|
|
701
724
|
onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
|
|
702
725
|
<div class="method-source-code" id="M000006-source">
|
|
703
726
|
<pre>
|
|
704
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
727
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 353</span>
|
|
728
|
+
353: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">response</span>
|
|
729
|
+
354: <span class="ruby-ivar">@response</span>
|
|
730
|
+
355: <span class="ruby-keyword kw">end</span>
|
|
708
731
|
</pre>
|
|
709
732
|
</div>
|
|
710
733
|
</div>
|
|
711
734
|
</div>
|
|
712
735
|
|
|
713
|
-
<div id="method-
|
|
714
|
-
<a name="
|
|
736
|
+
<div id="method-M000011" class="method-detail">
|
|
737
|
+
<a name="M000011"></a>
|
|
715
738
|
|
|
716
739
|
<div class="method-heading">
|
|
717
|
-
<a href="#
|
|
740
|
+
<a href="#M000011" class="method-signature">
|
|
718
741
|
<span class="method-name">run</span><span class="method-args">( args = {} ) {|self| ...}</span>
|
|
719
742
|
</a>
|
|
720
743
|
</div>
|
|
721
744
|
|
|
722
745
|
<div class="method-description">
|
|
723
746
|
<p>
|
|
724
|
-
Start your <a href="Capcode.html#
|
|
747
|
+
Start your <a href="Capcode.html#M000010">application</a>.
|
|
748
|
+
</p>
|
|
749
|
+
<p>
|
|
750
|
+
Options : see <a href="Capcode.html#M000012">Capcode.set</a>
|
|
751
|
+
</p>
|
|
752
|
+
<p>
|
|
753
|
+
Options <a href="Capcode.html#M000012">set</a> here replace the ones <a
|
|
754
|
+
href="Capcode.html#M000012">set</a> globally
|
|
755
|
+
</p>
|
|
756
|
+
<p><a class="source-toggle" href="#"
|
|
757
|
+
onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
|
|
758
|
+
<div class="method-source-code" id="M000011-source">
|
|
759
|
+
<pre>
|
|
760
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 619</span>
|
|
761
|
+
619: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run</span>( <span class="ruby-identifier">args</span> = {} )
|
|
762
|
+
620: <span class="ruby-identifier">conf</span> = <span class="ruby-identifier">configuration</span>(<span class="ruby-identifier">args</span>)
|
|
763
|
+
621:
|
|
764
|
+
622: <span class="ruby-comment cmt"># Parse options</span>
|
|
765
|
+
623: <span class="ruby-identifier">opts</span> = <span class="ruby-constant">OptionParser</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">opts</span><span class="ruby-operator">|</span>
|
|
766
|
+
624: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">banner</span> = <span class="ruby-node">"Usage: #{File.basename($0)} [options]"</span>
|
|
767
|
+
625: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">""</span>
|
|
768
|
+
626: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">"Specific options:"</span>
|
|
769
|
+
627:
|
|
770
|
+
628: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-C"</span>, <span class="ruby-value str">"--console"</span>, <span class="ruby-value str">"Run in console mode with IRB (default: false)"</span> ) {
|
|
771
|
+
629: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:console</span>] = <span class="ruby-keyword kw">true</span>
|
|
772
|
+
630: }
|
|
773
|
+
631: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-h"</span>, <span class="ruby-value str">"--host HOSTNAME"</span>, <span class="ruby-node">"Host for web server to bind to (default: #{conf[:host]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">h</span><span class="ruby-operator">|</span>
|
|
774
|
+
632: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:host</span>] = <span class="ruby-identifier">h</span>
|
|
775
|
+
633: }
|
|
776
|
+
634: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-p"</span>, <span class="ruby-value str">"--port NUM"</span>, <span class="ruby-node">"Port for web server (default: #{conf[:port]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span>
|
|
777
|
+
635: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:port</span>] = <span class="ruby-identifier">p</span>
|
|
778
|
+
636: }
|
|
779
|
+
637: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-d"</span>, <span class="ruby-value str">"--daemonize [true|false]"</span>, <span class="ruby-node">"Daemonize (default: #{conf[:daemonize]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span>
|
|
780
|
+
638: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:daemonize</span>] = <span class="ruby-identifier">d</span>
|
|
781
|
+
639: }
|
|
782
|
+
640: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-r"</span>, <span class="ruby-value str">"--root PATH"</span>, <span class="ruby-node">"Working directory (default: #{conf[:root]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">w</span><span class="ruby-operator">|</span>
|
|
783
|
+
641: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:root</span>] = <span class="ruby-identifier">w</span>
|
|
784
|
+
642: }
|
|
785
|
+
643: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-s"</span>, <span class="ruby-value str">"--static PATH"</span>, <span class="ruby-node">"Static directory -- relative to the root directory (default: #{conf[:static]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">r</span><span class="ruby-operator">|</span>
|
|
786
|
+
644: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>] = <span class="ruby-identifier">r</span>
|
|
787
|
+
645: }
|
|
788
|
+
646:
|
|
789
|
+
647: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">""</span>
|
|
790
|
+
648: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">"Common options:"</span>
|
|
791
|
+
649:
|
|
792
|
+
650: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>(<span class="ruby-value str">"-?"</span>, <span class="ruby-value str">"--help"</span>, <span class="ruby-value str">"Show this message"</span>) <span class="ruby-keyword kw">do</span>
|
|
793
|
+
651: <span class="ruby-identifier">puts</span> <span class="ruby-identifier">opts</span>
|
|
794
|
+
652: <span class="ruby-identifier">exit</span>
|
|
795
|
+
653: <span class="ruby-keyword kw">end</span>
|
|
796
|
+
654: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>(<span class="ruby-value str">"-v"</span>, <span class="ruby-value str">"--version"</span>, <span class="ruby-value str">"Show versions"</span>) <span class="ruby-keyword kw">do</span>
|
|
797
|
+
655: <span class="ruby-identifier">puts</span> <span class="ruby-node">"Capcode version #{Capcode::CAPCOD_VERION} (ruby v#{RUBY_VERSION})"</span>
|
|
798
|
+
656: <span class="ruby-identifier">exit</span>
|
|
799
|
+
657: <span class="ruby-keyword kw">end</span>
|
|
800
|
+
658: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on_tail</span>( <span class="ruby-value str">"-V"</span>, <span class="ruby-value str">"--verbose"</span>, <span class="ruby-value str">"Run in verbose mode"</span> ) <span class="ruby-keyword kw">do</span>
|
|
801
|
+
659: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>] = <span class="ruby-keyword kw">true</span>
|
|
802
|
+
660: <span class="ruby-keyword kw">end</span>
|
|
803
|
+
661: <span class="ruby-keyword kw">end</span>
|
|
804
|
+
662:
|
|
805
|
+
663: <span class="ruby-keyword kw">begin</span>
|
|
806
|
+
664: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">parse!</span> <span class="ruby-constant">ARGV</span>
|
|
807
|
+
665: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">ParseError</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">ex</span>
|
|
808
|
+
666: <span class="ruby-identifier">puts</span> <span class="ruby-node">"!! #{ex.message}"</span>
|
|
809
|
+
667: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** use `#{File.basename($0)} --help` for more details..."</span>
|
|
810
|
+
668: <span class="ruby-identifier">exit</span> <span class="ruby-value">1</span>
|
|
811
|
+
669: <span class="ruby-keyword kw">end</span>
|
|
812
|
+
670:
|
|
813
|
+
671: <span class="ruby-comment cmt"># Run in the Working directory</span>
|
|
814
|
+
672: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Go on root directory (#{File.expand_path(conf[:root])})"</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>]
|
|
815
|
+
673: <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>( <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:root</span>] ) <span class="ruby-keyword kw">do</span>
|
|
816
|
+
674:
|
|
817
|
+
675: <span class="ruby-comment cmt"># Check that mongrel exists </span>
|
|
818
|
+
676: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>].<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">"mongrel"</span>
|
|
819
|
+
677: <span class="ruby-keyword kw">begin</span>
|
|
820
|
+
678: <span class="ruby-identifier">require</span> <span class="ruby-value str">'mongrel'</span>
|
|
821
|
+
679: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>] = <span class="ruby-value str">"mongrel"</span>
|
|
822
|
+
680: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">LoadError</span>
|
|
823
|
+
681: <span class="ruby-identifier">puts</span> <span class="ruby-value str">"!! could not load mongrel. Falling back to webrick."</span>
|
|
824
|
+
682: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>] = <span class="ruby-value str">"webrick"</span>
|
|
825
|
+
683: <span class="ruby-keyword kw">end</span>
|
|
826
|
+
684: <span class="ruby-keyword kw">end</span>
|
|
827
|
+
685:
|
|
828
|
+
686: <span class="ruby-comment cmt"># From rackup !!!</span>
|
|
829
|
+
687: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:daemonize</span>]
|
|
830
|
+
688: <span class="ruby-keyword kw">if</span> <span class="ruby-regexp re">/java/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-constant">RUBY_PLATFORM</span>).<span class="ruby-identifier">nil?</span>
|
|
831
|
+
689: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">RUBY_VERSION</span> <span class="ruby-operator"><</span> <span class="ruby-value str">"1.9"</span>
|
|
832
|
+
690: <span class="ruby-identifier">exit</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fork</span>
|
|
833
|
+
691: <span class="ruby-constant">Process</span>.<span class="ruby-identifier">setsid</span>
|
|
834
|
+
692: <span class="ruby-identifier">exit</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fork</span>
|
|
835
|
+
693: <span class="ruby-comment cmt"># Dir.chdir "/"</span>
|
|
836
|
+
694: <span class="ruby-constant">File</span>.<span class="ruby-identifier">umask</span> <span class="ruby-value">0000</span>
|
|
837
|
+
695: <span class="ruby-constant">STDIN</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">"/dev/null"</span>
|
|
838
|
+
696: <span class="ruby-constant">STDOUT</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">"/dev/null"</span>, <span class="ruby-value str">"a"</span>
|
|
839
|
+
697: <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">"/dev/null"</span>, <span class="ruby-value str">"a"</span>
|
|
840
|
+
698: <span class="ruby-keyword kw">else</span>
|
|
841
|
+
699: <span class="ruby-constant">Process</span>.<span class="ruby-identifier">daemon</span>
|
|
842
|
+
700: <span class="ruby-keyword kw">end</span>
|
|
843
|
+
701: <span class="ruby-keyword kw">else</span>
|
|
844
|
+
702: <span class="ruby-identifier">puts</span> <span class="ruby-node">"!! daemonize option unavailable on #{RUBY_PLATFORM} platform."</span>
|
|
845
|
+
703: <span class="ruby-keyword kw">end</span>
|
|
846
|
+
704:
|
|
847
|
+
705: <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:pid</span>], <span class="ruby-value str">'w'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">"#{Process.pid}"</span>) }
|
|
848
|
+
706: <span class="ruby-identifier">at_exit</span> { <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:pid</span>]) <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:pid</span>]) }
|
|
849
|
+
707: <span class="ruby-keyword kw">end</span>
|
|
850
|
+
708:
|
|
851
|
+
709: <span class="ruby-identifier">app</span> = <span class="ruby-keyword kw">nil</span>
|
|
852
|
+
710: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
|
|
853
|
+
711: <span class="ruby-identifier">app</span> = <span class="ruby-identifier">application</span>(<span class="ruby-identifier">conf</span>) { <span class="ruby-keyword kw">yield</span>( <span class="ruby-keyword kw">self</span> ) }
|
|
854
|
+
712: <span class="ruby-keyword kw">else</span>
|
|
855
|
+
713: <span class="ruby-identifier">app</span> = <span class="ruby-identifier">application</span>(<span class="ruby-identifier">conf</span>)
|
|
856
|
+
714: <span class="ruby-keyword kw">end</span>
|
|
857
|
+
715: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">CommonLogger</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">app</span>, <span class="ruby-constant">Logger</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:log</span>]) )
|
|
858
|
+
716:
|
|
859
|
+
717: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:console</span>]
|
|
860
|
+
718: <span class="ruby-identifier">puts</span> <span class="ruby-value str">"Run console..."</span>
|
|
861
|
+
719: <span class="ruby-constant">IRB</span>.<span class="ruby-identifier">start</span>
|
|
862
|
+
720: <span class="ruby-identifier">exit</span>
|
|
863
|
+
721: <span class="ruby-keyword kw">end</span>
|
|
864
|
+
722:
|
|
865
|
+
723: <span class="ruby-comment cmt"># Start server</span>
|
|
866
|
+
724: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>]
|
|
867
|
+
725: <span class="ruby-keyword kw">when</span> <span class="ruby-value str">"mongrel"</span>
|
|
868
|
+
726: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Starting Mongrel on #{conf[:host]}:#{conf[:port]}"</span>
|
|
869
|
+
727: <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Handler</span><span class="ruby-operator">::</span><span class="ruby-constant">Mongrel</span>.<span class="ruby-identifier">run</span>( <span class="ruby-identifier">app</span>, {<span class="ruby-identifier">:Port</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:port</span>], <span class="ruby-identifier">:Host</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:host</span>]} ) { <span class="ruby-operator">|</span><span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
|
|
870
|
+
728: <span class="ruby-identifier">trap</span> <span class="ruby-value str">"SIGINT"</span>, <span class="ruby-identifier">proc</span> { <span class="ruby-identifier">server</span>.<span class="ruby-identifier">stop</span> }
|
|
871
|
+
729: }
|
|
872
|
+
730: <span class="ruby-keyword kw">when</span> <span class="ruby-value str">"webrick"</span>
|
|
873
|
+
731: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Starting WEBrick on #{conf[:host]}:#{conf[:port]}"</span>
|
|
874
|
+
732: <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Handler</span><span class="ruby-operator">::</span><span class="ruby-constant">WEBrick</span>.<span class="ruby-identifier">run</span>( <span class="ruby-identifier">app</span>, {<span class="ruby-identifier">:Port</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:port</span>], <span class="ruby-identifier">:BindAddress</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:host</span>]} ) { <span class="ruby-operator">|</span><span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
|
|
875
|
+
733: <span class="ruby-identifier">trap</span> <span class="ruby-value str">"SIGINT"</span>, <span class="ruby-identifier">proc</span> { <span class="ruby-identifier">server</span>.<span class="ruby-identifier">shutdown</span> }
|
|
876
|
+
734: }
|
|
877
|
+
735: <span class="ruby-keyword kw">end</span>
|
|
878
|
+
736: <span class="ruby-keyword kw">end</span>
|
|
879
|
+
737: <span class="ruby-keyword kw">end</span>
|
|
880
|
+
</pre>
|
|
881
|
+
</div>
|
|
882
|
+
</div>
|
|
883
|
+
</div>
|
|
884
|
+
|
|
885
|
+
<div id="method-M000004" class="method-detail">
|
|
886
|
+
<a name="M000004"></a>
|
|
887
|
+
|
|
888
|
+
<div class="method-heading">
|
|
889
|
+
<a href="#M000004" class="method-signature">
|
|
890
|
+
<span class="method-name">session</span><span class="method-args">()</span>
|
|
891
|
+
</a>
|
|
892
|
+
</div>
|
|
893
|
+
|
|
894
|
+
<div class="method-description">
|
|
895
|
+
<p>
|
|
896
|
+
Session hash
|
|
897
|
+
</p>
|
|
898
|
+
<p><a class="source-toggle" href="#"
|
|
899
|
+
onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
|
|
900
|
+
<div class="method-source-code" id="M000004-source">
|
|
901
|
+
<pre>
|
|
902
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 343</span>
|
|
903
|
+
343: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">session</span>
|
|
904
|
+
344: <span class="ruby-ivar">@env</span>[<span class="ruby-value str">'rack.session'</span>]
|
|
905
|
+
345: <span class="ruby-keyword kw">end</span>
|
|
906
|
+
</pre>
|
|
907
|
+
</div>
|
|
908
|
+
</div>
|
|
909
|
+
</div>
|
|
910
|
+
|
|
911
|
+
<div id="method-M000012" class="method-detail">
|
|
912
|
+
<a name="M000012"></a>
|
|
913
|
+
|
|
914
|
+
<div class="method-heading">
|
|
915
|
+
<a href="#M000012" class="method-signature">
|
|
916
|
+
<span class="method-name">set</span><span class="method-args">( key, value )</span>
|
|
917
|
+
</a>
|
|
918
|
+
</div>
|
|
919
|
+
|
|
920
|
+
<div class="method-description">
|
|
921
|
+
<p>
|
|
922
|
+
Set global configuration options
|
|
725
923
|
</p>
|
|
726
924
|
<p>
|
|
727
925
|
Options :
|
|
@@ -747,177 +945,84 @@ See Rack::Session for more informations
|
|
|
747
945
|
|
|
748
946
|
</li>
|
|
749
947
|
<li><tt>:daemonize</tt> = Daemonize <a
|
|
750
|
-
href="Capcode.html#
|
|
948
|
+
href="Capcode.html#M000010">application</a> (default: false)
|
|
751
949
|
|
|
752
950
|
</li>
|
|
753
951
|
<li><tt>:db_config</tt> = database configuration file (default: database.yml)
|
|
754
952
|
|
|
755
953
|
</li>
|
|
756
|
-
<li><tt>:static</tt> = Static directory (default:
|
|
757
|
-
working directory)
|
|
954
|
+
<li><tt>:static</tt> = Static directory (default: the working directory)
|
|
758
955
|
|
|
759
956
|
</li>
|
|
760
957
|
<li><tt>:root</tt> = Root directory (default: directory of the main.rb) —
|
|
761
958
|
This is also the working directory !
|
|
762
959
|
|
|
763
960
|
</li>
|
|
764
|
-
<li><tt>:verbose</tt> = <a href="Capcode.html#
|
|
961
|
+
<li><tt>:verbose</tt> = <a href="Capcode.html#M000011">run</a> in verbose mode
|
|
765
962
|
|
|
766
963
|
</li>
|
|
767
964
|
<li><tt>:auth</tt> = HTTP Basic Authentication options
|
|
768
965
|
|
|
769
966
|
</li>
|
|
770
967
|
</ul>
|
|
968
|
+
<p>
|
|
969
|
+
It can exist specifics options depending on a renderer, a helper, …
|
|
970
|
+
</p>
|
|
971
|
+
<p>
|
|
972
|
+
Example :
|
|
973
|
+
</p>
|
|
974
|
+
<pre>
|
|
975
|
+
module Capcode
|
|
976
|
+
set :erb, "/path/to/erb/files"
|
|
977
|
+
...
|
|
978
|
+
end
|
|
979
|
+
</pre>
|
|
771
980
|
<p><a class="source-toggle" href="#"
|
|
772
|
-
onclick="toggleCode('
|
|
773
|
-
<div class="method-source-code" id="
|
|
981
|
+
onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
|
|
982
|
+
<div class="method-source-code" id="M000012-source">
|
|
774
983
|
<pre>
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
580: <span class="ruby-comment cmt"># Parse options</span>
|
|
780
|
-
581: <span class="ruby-identifier">opts</span> = <span class="ruby-constant">OptionParser</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">opts</span><span class="ruby-operator">|</span>
|
|
781
|
-
582: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">banner</span> = <span class="ruby-node">"Usage: #{File.basename($0)} [options]"</span>
|
|
782
|
-
583: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">""</span>
|
|
783
|
-
584: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">"Specific options:"</span>
|
|
784
|
-
585:
|
|
785
|
-
586: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-C"</span>, <span class="ruby-value str">"--console"</span>, <span class="ruby-value str">"Run in console mode with IRB (default: false)"</span> ) {
|
|
786
|
-
587: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:console</span>] = <span class="ruby-keyword kw">true</span>
|
|
787
|
-
588: }
|
|
788
|
-
589: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-h"</span>, <span class="ruby-value str">"--host HOSTNAME"</span>, <span class="ruby-node">"Host for web server to bind to (default: #{conf[:host]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">h</span><span class="ruby-operator">|</span>
|
|
789
|
-
590: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:host</span>] = <span class="ruby-identifier">h</span>
|
|
790
|
-
591: }
|
|
791
|
-
592: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-p"</span>, <span class="ruby-value str">"--port NUM"</span>, <span class="ruby-node">"Port for web server (default: #{conf[:port]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span>
|
|
792
|
-
593: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:port</span>] = <span class="ruby-identifier">p</span>
|
|
793
|
-
594: }
|
|
794
|
-
595: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-d"</span>, <span class="ruby-value str">"--daemonize [true|false]"</span>, <span class="ruby-node">"Daemonize (default: #{conf[:daemonize]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span>
|
|
795
|
-
596: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:daemonize</span>] = <span class="ruby-identifier">d</span>
|
|
796
|
-
597: }
|
|
797
|
-
598: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-r"</span>, <span class="ruby-value str">"--root PATH"</span>, <span class="ruby-node">"Working directory (default: #{conf[:root]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">w</span><span class="ruby-operator">|</span>
|
|
798
|
-
599: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:root</span>] = <span class="ruby-identifier">w</span>
|
|
799
|
-
600: }
|
|
800
|
-
601: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>( <span class="ruby-value str">"-s"</span>, <span class="ruby-value str">"--static PATH"</span>, <span class="ruby-node">"Static directory -- relative to the root directory (default: #{conf[:static]})"</span> ) { <span class="ruby-operator">|</span><span class="ruby-identifier">r</span><span class="ruby-operator">|</span>
|
|
801
|
-
602: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:static</span>] = <span class="ruby-identifier">r</span>
|
|
802
|
-
603: }
|
|
803
|
-
604:
|
|
804
|
-
605: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">""</span>
|
|
805
|
-
606: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">separator</span> <span class="ruby-value str">"Common options:"</span>
|
|
806
|
-
607:
|
|
807
|
-
608: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>(<span class="ruby-value str">"-?"</span>, <span class="ruby-value str">"--help"</span>, <span class="ruby-value str">"Show this message"</span>) <span class="ruby-keyword kw">do</span>
|
|
808
|
-
609: <span class="ruby-identifier">puts</span> <span class="ruby-identifier">opts</span>
|
|
809
|
-
610: <span class="ruby-identifier">exit</span>
|
|
810
|
-
611: <span class="ruby-keyword kw">end</span>
|
|
811
|
-
612: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on</span>(<span class="ruby-value str">"-v"</span>, <span class="ruby-value str">"--version"</span>, <span class="ruby-value str">"Show versions"</span>) <span class="ruby-keyword kw">do</span>
|
|
812
|
-
613: <span class="ruby-identifier">puts</span> <span class="ruby-node">"Capcode version #{Capcode::CAPCOD_VERION} (ruby v#{RUBY_VERSION})"</span>
|
|
813
|
-
614: <span class="ruby-identifier">exit</span>
|
|
814
|
-
615: <span class="ruby-keyword kw">end</span>
|
|
815
|
-
616: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">on_tail</span>( <span class="ruby-value str">"-V"</span>, <span class="ruby-value str">"--verbose"</span>, <span class="ruby-value str">"Run in verbose mode"</span> ) <span class="ruby-keyword kw">do</span>
|
|
816
|
-
617: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>] = <span class="ruby-keyword kw">true</span>
|
|
817
|
-
618: <span class="ruby-keyword kw">end</span>
|
|
818
|
-
619: <span class="ruby-keyword kw">end</span>
|
|
819
|
-
620:
|
|
820
|
-
621: <span class="ruby-keyword kw">begin</span>
|
|
821
|
-
622: <span class="ruby-identifier">opts</span>.<span class="ruby-identifier">parse!</span> <span class="ruby-constant">ARGV</span>
|
|
822
|
-
623: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">ParseError</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">ex</span>
|
|
823
|
-
624: <span class="ruby-identifier">puts</span> <span class="ruby-node">"!! #{ex.message}"</span>
|
|
824
|
-
625: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** use `#{File.basename($0)} --help` for more details..."</span>
|
|
825
|
-
626: <span class="ruby-identifier">exit</span> <span class="ruby-value">1</span>
|
|
826
|
-
627: <span class="ruby-keyword kw">end</span>
|
|
827
|
-
628:
|
|
828
|
-
629: <span class="ruby-comment cmt"># Run in the Working directory</span>
|
|
829
|
-
630: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Go on root directory (#{File.expand_path(conf[:root])})"</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:verbose</span>]
|
|
830
|
-
631: <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>( <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:root</span>] ) <span class="ruby-keyword kw">do</span>
|
|
831
|
-
632:
|
|
832
|
-
633: <span class="ruby-comment cmt"># Check that mongrel exists </span>
|
|
833
|
-
634: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>].<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">"mongrel"</span>
|
|
834
|
-
635: <span class="ruby-keyword kw">begin</span>
|
|
835
|
-
636: <span class="ruby-identifier">require</span> <span class="ruby-value str">'mongrel'</span>
|
|
836
|
-
637: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>] = <span class="ruby-value str">"mongrel"</span>
|
|
837
|
-
638: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">LoadError</span>
|
|
838
|
-
639: <span class="ruby-identifier">puts</span> <span class="ruby-value str">"!! could not load mongrel. Falling back to webrick."</span>
|
|
839
|
-
640: <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>] = <span class="ruby-value str">"webrick"</span>
|
|
840
|
-
641: <span class="ruby-keyword kw">end</span>
|
|
841
|
-
642: <span class="ruby-keyword kw">end</span>
|
|
842
|
-
643:
|
|
843
|
-
644: <span class="ruby-comment cmt"># From rackup !!!</span>
|
|
844
|
-
645: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:daemonize</span>]
|
|
845
|
-
646: <span class="ruby-keyword kw">if</span> <span class="ruby-regexp re">/java/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-constant">RUBY_PLATFORM</span>).<span class="ruby-identifier">nil?</span>
|
|
846
|
-
647: <span class="ruby-keyword kw">if</span> <span class="ruby-constant">RUBY_VERSION</span> <span class="ruby-operator"><</span> <span class="ruby-value str">"1.9"</span>
|
|
847
|
-
648: <span class="ruby-identifier">exit</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fork</span>
|
|
848
|
-
649: <span class="ruby-constant">Process</span>.<span class="ruby-identifier">setsid</span>
|
|
849
|
-
650: <span class="ruby-identifier">exit</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fork</span>
|
|
850
|
-
651: <span class="ruby-comment cmt"># Dir.chdir "/"</span>
|
|
851
|
-
652: <span class="ruby-constant">File</span>.<span class="ruby-identifier">umask</span> <span class="ruby-value">0000</span>
|
|
852
|
-
653: <span class="ruby-constant">STDIN</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">"/dev/null"</span>
|
|
853
|
-
654: <span class="ruby-constant">STDOUT</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">"/dev/null"</span>, <span class="ruby-value str">"a"</span>
|
|
854
|
-
655: <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">reopen</span> <span class="ruby-value str">"/dev/null"</span>, <span class="ruby-value str">"a"</span>
|
|
855
|
-
656: <span class="ruby-keyword kw">else</span>
|
|
856
|
-
657: <span class="ruby-constant">Process</span>.<span class="ruby-identifier">daemon</span>
|
|
857
|
-
658: <span class="ruby-keyword kw">end</span>
|
|
858
|
-
659: <span class="ruby-keyword kw">else</span>
|
|
859
|
-
660: <span class="ruby-identifier">puts</span> <span class="ruby-node">"!! daemonize option unavailable on #{RUBY_PLATFORM} platform."</span>
|
|
860
|
-
661: <span class="ruby-keyword kw">end</span>
|
|
861
|
-
662:
|
|
862
|
-
663: <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:pid</span>], <span class="ruby-value str">'w'</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">write</span>(<span class="ruby-node">"#{Process.pid}"</span>) }
|
|
863
|
-
664: <span class="ruby-identifier">at_exit</span> { <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:pid</span>]) <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:pid</span>]) }
|
|
864
|
-
665: <span class="ruby-keyword kw">end</span>
|
|
865
|
-
666:
|
|
866
|
-
667: <span class="ruby-identifier">app</span> = <span class="ruby-keyword kw">nil</span>
|
|
867
|
-
668: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
|
|
868
|
-
669: <span class="ruby-identifier">app</span> = <span class="ruby-identifier">application</span>(<span class="ruby-identifier">conf</span>) { <span class="ruby-keyword kw">yield</span>( <span class="ruby-keyword kw">self</span> ) }
|
|
869
|
-
670: <span class="ruby-keyword kw">else</span>
|
|
870
|
-
671: <span class="ruby-identifier">app</span> = <span class="ruby-identifier">application</span>(<span class="ruby-identifier">conf</span>)
|
|
871
|
-
672: <span class="ruby-keyword kw">end</span>
|
|
872
|
-
673: <span class="ruby-identifier">app</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">CommonLogger</span>.<span class="ruby-identifier">new</span>( <span class="ruby-identifier">app</span>, <span class="ruby-constant">Logger</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:log</span>]) )
|
|
873
|
-
674:
|
|
874
|
-
675: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:console</span>]
|
|
875
|
-
676: <span class="ruby-identifier">puts</span> <span class="ruby-value str">"Run console..."</span>
|
|
876
|
-
677: <span class="ruby-constant">IRB</span>.<span class="ruby-identifier">start</span>
|
|
877
|
-
678: <span class="ruby-identifier">exit</span>
|
|
878
|
-
679: <span class="ruby-keyword kw">end</span>
|
|
879
|
-
680:
|
|
880
|
-
681: <span class="ruby-comment cmt"># Start server</span>
|
|
881
|
-
682: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:server</span>]
|
|
882
|
-
683: <span class="ruby-keyword kw">when</span> <span class="ruby-value str">"mongrel"</span>
|
|
883
|
-
684: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Starting Mongrel on #{conf[:host]}:#{conf[:port]}"</span>
|
|
884
|
-
685: <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Handler</span><span class="ruby-operator">::</span><span class="ruby-constant">Mongrel</span>.<span class="ruby-identifier">run</span>( <span class="ruby-identifier">app</span>, {<span class="ruby-identifier">:Port</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:port</span>], <span class="ruby-identifier">:Host</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:host</span>]} ) { <span class="ruby-operator">|</span><span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
|
|
885
|
-
686: <span class="ruby-identifier">trap</span> <span class="ruby-value str">"SIGINT"</span>, <span class="ruby-identifier">proc</span> { <span class="ruby-identifier">server</span>.<span class="ruby-identifier">stop</span> }
|
|
886
|
-
687: }
|
|
887
|
-
688: <span class="ruby-keyword kw">when</span> <span class="ruby-value str">"webrick"</span>
|
|
888
|
-
689: <span class="ruby-identifier">puts</span> <span class="ruby-node">"** Starting WEBrick on #{conf[:host]}:#{conf[:port]}"</span>
|
|
889
|
-
690: <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">Handler</span><span class="ruby-operator">::</span><span class="ruby-constant">WEBrick</span>.<span class="ruby-identifier">run</span>( <span class="ruby-identifier">app</span>, {<span class="ruby-identifier">:Port</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:port</span>], <span class="ruby-identifier">:BindAddress</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">conf</span>[<span class="ruby-identifier">:host</span>]} ) { <span class="ruby-operator">|</span><span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
|
|
890
|
-
691: <span class="ruby-identifier">trap</span> <span class="ruby-value str">"SIGINT"</span>, <span class="ruby-identifier">proc</span> { <span class="ruby-identifier">server</span>.<span class="ruby-identifier">shutdown</span> }
|
|
891
|
-
692: }
|
|
892
|
-
693: <span class="ruby-keyword kw">end</span>
|
|
893
|
-
694: <span class="ruby-keyword kw">end</span>
|
|
894
|
-
695: <span class="ruby-keyword kw">end</span>
|
|
984
|
+
<span class="ruby-comment cmt"># File lib/capcode/configuration.rb, line 27</span>
|
|
985
|
+
27: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set</span>( <span class="ruby-identifier">key</span>, <span class="ruby-identifier">value</span> )
|
|
986
|
+
28: <span class="ruby-identifier">config</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">value</span>
|
|
987
|
+
29: <span class="ruby-keyword kw">end</span>
|
|
895
988
|
</pre>
|
|
896
989
|
</div>
|
|
897
990
|
</div>
|
|
898
991
|
</div>
|
|
899
992
|
|
|
900
|
-
<div id="method-
|
|
901
|
-
<a name="
|
|
993
|
+
<div id="method-M000008" class="method-detail">
|
|
994
|
+
<a name="M000008"></a>
|
|
902
995
|
|
|
903
996
|
<div class="method-heading">
|
|
904
|
-
<a href="#
|
|
905
|
-
<span class="method-name">
|
|
997
|
+
<a href="#M000008" class="method-signature">
|
|
998
|
+
<span class="method-name">use</span><span class="method-args">(middleware, *args, &block)</span>
|
|
906
999
|
</a>
|
|
907
1000
|
</div>
|
|
908
1001
|
|
|
909
1002
|
<div class="method-description">
|
|
910
1003
|
<p>
|
|
911
|
-
|
|
1004
|
+
This method allow you to <a href="Capcode.html#M000008">use</a> a Rack
|
|
1005
|
+
middleware
|
|
1006
|
+
</p>
|
|
1007
|
+
<p>
|
|
1008
|
+
Example :
|
|
912
1009
|
</p>
|
|
1010
|
+
<pre>
|
|
1011
|
+
module Capcode
|
|
1012
|
+
...
|
|
1013
|
+
use Rack::Codehighlighter, :coderay, :element => "pre",
|
|
1014
|
+
:pattern => /\A:::(\w+)\s*\n/, :logging => false
|
|
1015
|
+
...
|
|
1016
|
+
end
|
|
1017
|
+
</pre>
|
|
913
1018
|
<p><a class="source-toggle" href="#"
|
|
914
|
-
onclick="toggleCode('
|
|
915
|
-
<div class="method-source-code" id="
|
|
1019
|
+
onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
|
|
1020
|
+
<div class="method-source-code" id="M000008-source">
|
|
916
1021
|
<pre>
|
|
917
|
-
<span class="ruby-comment cmt"># File lib/capcode.rb, line
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
1022
|
+
<span class="ruby-comment cmt"># File lib/capcode.rb, line 485</span>
|
|
1023
|
+
485: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">use</span>(<span class="ruby-identifier">middleware</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&</span><span class="ruby-identifier">block</span>)
|
|
1024
|
+
486: <span class="ruby-identifier">middlewares</span> <span class="ruby-operator"><<</span> [<span class="ruby-identifier">middleware</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">block</span>]
|
|
1025
|
+
487: <span class="ruby-keyword kw">end</span>
|
|
921
1026
|
</pre>
|
|
922
1027
|
</div>
|
|
923
1028
|
</div>
|