rack-server-pages 0.0.1

data/.gitignore

@@ -0,0 +1,11 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store
+*.swp
+tmp/*
+.sass-cache
+coverage/
+.rbenv-version
+.rvmrc

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby

data/Gemfile

@@ -0,0 +1,53 @@
+source :rubygems
+
+gem 'rack'
+#gemspec #didn't work in heroku
+
+group :development do
+  gem 'rake'
+  gem 'thin'
+  gem 'guard'
+  gem 'guard-bundler'
+  gem 'guard-rspec'
+  #gem 'rb-readline'
+  #gem 'rb-inotify', :require => false
+  #gem 'rb-fsevent', :require => false
+  #gem 'rb-fchange', :require => false
+end
+
+group :test do
+  gem 'simplecov'
+  gem 'rack-test', :require => 'rack/test'
+  gem 'rspec'
+end
+
+group :development, :test do
+  gem 'tapp'
+#  gem 'ruby-debug', :platforms => :ruby_18
+#  gem 'ruby-debug19', :require => 'ruby-debug', :platforms => :ruby_19
+end
+
+# Tilt
+gem 'tilt'
+gem 'RedCloth'
+gem 'bluecloth'
+gem 'builder'
+gem 'coffee-script'
+gem 'contest'
+gem 'creole'
+gem 'erubis'
+gem 'haml'
+gem 'kramdown'
+gem 'less', :platforms => [:ruby_18, :ruby_19]
+gem 'liquid'
+gem 'markaby'
+gem 'maruku'
+gem 'nokogiri'
+gem 'radius'
+gem 'rdiscount'
+gem 'rdoc'
+#gem 'redcarpet'
+gem 'sass'
+gem 'wikicloth'
+gem 'yajl-ruby'
+gem 'slim'

data/Gemfile.lock

@@ -0,0 +1,127 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    RedCloth (4.2.9)
+    RedCloth (4.2.9-java)
+    bluecloth (2.2.0)
+    builder (3.0.0)
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.2.0)
+    commonjs (0.2.0)
+      therubyracer (~> 0.9.9)
+    contest (0.1.3)
+    creole (0.4.2)
+    daemons (1.1.5)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    eventmachine (0.12.10)
+    eventmachine (0.12.10-java)
+    execjs (1.2.13)
+      multi_json (~> 1.0)
+    expression_parser (0.9.0)
+    ffi (1.0.11)
+    ffi (1.0.11-java)
+    guard (0.9.4)
+      ffi (>= 0.5.0)
+      thor (~> 0.14.6)
+    guard-bundler (0.1.3)
+      bundler (>= 1.0.0)
+      guard (>= 0.2.2)
+    guard-rspec (0.5.10)
+      guard (>= 0.8.4)
+    haml (3.1.4)
+    json (1.6.4)
+    json (1.6.4-java)
+    kramdown (0.13.4)
+    less (2.0.8)
+      commonjs (~> 0.2.0)
+      therubyracer (~> 0.9.9)
+    libv8 (3.3.10.4)
+    liquid (2.3.0)
+    markaby (0.7.2)
+      builder (>= 2.0.0)
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    multi_json (1.0.4)
+    nokogiri (1.5.0)
+    nokogiri (1.5.0-java)
+    rack (1.4.0)
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    radius (0.7.1)
+    rake (0.9.2.2)
+    rdiscount (1.6.8)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.7.0)
+    sass (3.1.12)
+    simplecov (0.5.4)
+      multi_json (~> 1.0.3)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    slim (1.0.4)
+      temple (~> 0.3.4)
+      tilt (~> 1.3.2)
+    syntax (1.0.0)
+    tapp (1.3.0)
+      thor
+    temple (0.3.4)
+    therubyracer (0.9.9)
+      libv8 (~> 3.3.10)
+    thin (1.3.1)
+      daemons (>= 1.0.9)
+      eventmachine (>= 0.12.6)
+      rack (>= 1.0.0)
+    thor (0.14.6)
+    tilt (1.3.3)
+    wikicloth (0.7.1)
+      builder
+      expression_parser
+    yajl-ruby (1.1.0)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  RedCloth
+  bluecloth
+  builder
+  coffee-script
+  contest
+  creole
+  erubis
+  guard
+  guard-bundler
+  guard-rspec
+  haml
+  kramdown
+  less
+  liquid
+  markaby
+  maruku
+  nokogiri
+  rack
+  rack-test
+  radius
+  rake
+  rdiscount
+  rdoc
+  rspec
+  sass
+  simplecov
+  slim
+  tapp
+  thin
+  tilt
+  wikicloth
+  yajl-ruby

data/Guardfile

@@ -0,0 +1,16 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+group 'backend' do
+  guard 'bundler' do
+    watch('Gemfile')
+    # Uncomment next line if Gemfile contain `gemspec' command
+    # watch(/^.+\.gemspec/)
+  end
+  guard 'rspec', :cli => '--color --format nested', :bundler => true do
+    watch(%r{^lib/([\w/]+)\.rb}) { |m| "spec/lib/#{m[1]}_spec.rb" }
+
+    watch(%r{^spec/(.+)\_spec.rb}) { |m| "spec/#{m[1]}_spec.rb" }
+
+    watch('spec/spec_helper.rb') { "bundle exec rake spec" }
+  end
+end

data/README.md

@@ -0,0 +1,401 @@
+Rack Server Pages
+=================
+
+Rack middleware and application for serving dynamic pages in very simple way.  
+There are no controllers or models, just only views like a jsp, asp and php!
+
+<http://github.com/migrs/rack-server-pages>
+
+[![Build Status](https://secure.travis-ci.org/migrs/rack-server-pages.png)](http://travis-ci.org/migrs/rack-server-pages)
+
+## Features
+
+- Serving dynamic pages (default: ERB)
+- Serving static files
+- No requirements (except Rack)
+- Tilt support (optional)
+- Include a partial template
+- Layout template
+- Integrate with any rack applications (Rails, Sinatra, etc...)
+- Extremely simple and easy to use!
+
+## Requirements
+
+- [Ruby](http://ruby-lang.org/) 1.8.7 or 1.9.x
+- [Rack](http://github.com/rack/rack)
+
+## Install
+
+[RubyGems](http://rubygems.org/gems/rack-server-pages) available
+
+    gem install rack-server-pages
+
+## Basic usage
+
+### Run as Rack application
+
+Create `config.ru`
+
+    require 'rack-server-pages'
+    run Rack::ServerPages
+
+Create `public/index.erb`
+
+    <h1>Hello rack!</h1>
+    <p><%= Time.now %></p>
+
+Finally running `rackup`
+
+    rackup
+
+and visit <http://localhost:9292/>
+
+Valid requests,
+
+- <http://localhost:9292/>
+- <http://localhost:9292/index>
+- <http://localhost:9292/index.erb>
+- <http://localhost:9292/index.html>
+
+### Use as Rack middleware
+
+Edit `config.ru`
+
+    require 'rack-server-pages'
+    use Rack::ServerPages
+    run Rack::ServerPages::NotFound # or your MyApp
+
+And same as above.
+
+## Template bindings
+
+- CoreHelper
+  - layout(file)
+  - partial(file)
+  - redirect(target, status=302) (same as [Sinatra](http://www.sinatrarb.com/intro#Browser%20Redirect))
+  - halt(\*args) (same as [Sinatra](http://www.sinatrarb.com/intro#Halting))
+  - url(path)
+
+- [Rack::Request](http://rack.rubyforge.org/doc/Rack/Request.html)
+  - request
+  - env
+  - params
+  - session
+  - cookies
+  - logger
+
+- [Rack::Response](http://rack.rubyforge.org/doc/Rack/Response.html)
+  - response
+  - headers
+  - set\_cookies
+  - delete\_cookie
+
+- [ERB::Util](http://www.ruby-doc.org/stdlib-1.9.3/libdoc/erb/rdoc/ERB/Util.html)
+  - h (alias for: html\_escape)
+  - u (alias for: url\_encode)
+
+## Configurations
+
+### Rack middleware
+
+with parameter
+
+    use Rack::ServerPages, :view_path => 'public'
+
+with block
+
+    use Rack::ServerPages do |config|
+      config.view_path = 'public'
+    end
+
+### Rack application
+
+with parameter
+
+    run Rack::ServerPages[:view_path => 'public']
+
+with block
+
+    run Rack::ServerPages.new { |config|
+      config.view_path = 'public'
+    }
+
+### Options
+
+- view\_path
+  - Views folders to load templates from.
+  - default: [views, public]
+
+- effective\_path
+  - default: nil
+
+- default\_charset
+  - default: utf-8
+
+- cache\_control
+  - default: nil
+
+- failure\_app
+  - default: nil
+
+## Tilt support
+[Tilt](http://github.com/rtomayko/tilt) is generic interface to multiple Ruby template engines.  
+If you want to use Tilt, just `require 'tilt'` and require template engine libraries that you want.
+
+    require 'rack-server-pages'
+    require 'tilt'
+    require 'rdiscount' # markdown library
+    run Rack::ServerPages
+
+or put your `Gemfile`
+
+### [Markdown](http://daringfireball.net/projects/markdown/)
+
+`views/article.html.md`
+
+    A First Level Header
+    ====================
+
+    A Second Level Header
+    ---------------------
+
+    Now is the time for all good men to come to
+    the aid of their country. This is just a
+    regular paragraph.
+
+    ### Header 3
+
+    > This is a blockquote.
+    > Thank you
+
+    [source](http://github.com/migrs/rack-server-pages)
+
+<http://localhost:9292/article.html>
+
+    <h1>A First Level Header</h1>
+
+    <h2>A Second Level Header</h2>
+
+    <p>Now is the time for all good men to come to
+    the aid of their country. This is just a
+    regular paragraph.</p>
+
+    <h3>Header 3</h3>
+
+    <blockquote><p>This is a blockquote.
+    Thank you</p></blockquote>
+
+    <p><a href="http://github.com/migrs/rack-server-pages">source</a></p>
+
+
+### [Slim](http://slim-lang.com/)
+
+`views/about.html.slim`
+
+    doctype html
+    html
+      head
+        title Slim Core Example
+        meta name="keywords" content="template language"
+
+      body
+        h1 Markup examples
+
+        div id="content" class="example1"
+          p Nest by indentation
+
+<http://localhost:9292/about.html>
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Slim Core Example</title>
+        <meta content="template language" name="keywords" />
+      </head>
+      <body>
+        <h1>Markup examples</h1>
+        <div class="example1" id="content">
+          <p>Nest by indentation</p>
+        </div>
+      </body>
+    </html>
+
+### [Sass](http://sass-lang.com/)
+
+`views/betty.css.sass`
+
+    $blue: #3bbfce
+    $margin: 16px
+
+    .content-navigation
+      border-color: $blue
+      color: darken($blue, 9%)
+
+    .border
+      padding: $margin / 2
+      margin: $margin / 2
+      border-color: $blue
+
+<http://localhost:9292/betty.css>
+
+    .content-navigation {
+      border-color: #3bbfce;
+      color: #2ca2af; }
+
+    .border {
+      padding: 8px;
+      margin: 8px;
+      border-color: #3bbfce; }
+
+### [Builder](http://builder.rubyforge.org/)
+
+`views/contact.xml.builder`
+
+    xml.instruct!
+    xml.result do |result|
+      result.name "John"
+      result.phone "910-1974"
+    end
+
+<http://localhost:9292/contact.xml>
+
+    <result>
+      <name>John</name>
+      <phone>910-1974</phone>
+    </result>
+
+### [CoffeeScript](http://jashkenas.github.com/coffee-script/)
+
+`views/script.js.coffee`
+    number   = 42
+    opposite = true
+
+    number = -42 if opposite
+
+    square = (x) -> x * x
+
+    list = [1, 2, 3, 4, 5]
+
+    math =
+      root:   Math.sqrt
+      square: square
+      cube:   (x) -> x * square x
+
+<http://localhost:9292/script.js>
+
+    (function() {
+      var list, math, number, opposite, square;
+
+      number = 42;
+
+      opposite = true;
+
+      if (opposite) number = -42;
+
+      square = function(x) {
+        return x * x;
+      };
+
+      list = [1, 2, 3, 4, 5];
+
+      math = {
+        root: Math.sqrt,
+        square: square,
+        cube: function(x) {
+          return x * square(x);
+        }
+      };
+
+    }).call(this);
+
+see more <http://localhost:9292/examples/>
+
+## Integrate with Rack applications
+
+At first, create sample file: `public/hello.erb` or `views/hello.html.erb`
+
+    <p>Hello Rack Server Pages!</p>
+    <p><%= Time.now %></p>
+
+### Rails
+
+Add to `config/environment.rb` (Rails2) or `config/application.rb` (Rails3)
+
+    config.middleware.use Rack::ServerPages
+
+And run
+
+Rails2
+
+    script/server
+
+Rails3
+
+    rails s
+
+- <http://localhost:3000/> is Rails response
+- <http://localhost:3000/hello> is Rack Server Pages response
+
+### Sinatra
+
+Create `sinatra_sample.rb`
+
+    require 'sinatra'
+    require 'rack-server-pages'
+
+    get '/' do
+      '<p>Hello Sinatra!</p>'
+    end
+
+
+And run
+
+    ruby sinatra_sample.rb`
+
+- <http://localhost:4567/> is Sinatra response
+- <http://localhost:4567/hello> is Rack Server Pages response
+
+## Customization
+
+### Customize file extension associations
+
+#### e.g. .php as ERB
+
+ERBTemplate (default)
+
+    Rack::ServerPages::Template::ERBTemplate.extensions << 'php'
+
+TiltTemplate (see. [Template Mappings](http://github.com/rtomayko/tilt))
+
+    Tilt.register Tilt::ERBTemplate, 'php'
+
+And create `public/info.php` :)
+
+    <%= phpinfo(); %>
+
+<http://localhost:9292/info.php>
+
+## Demo site
+
+<http://rack-server-pages.heroku.com/>
+
+## ToDo
+
+### Implements
+- Before/After filter
+- Support Helpers
+- Static file generator (for designer)
+
+### Tasks
+  - Tutorials
+    - for PHP user
+    - for Designer
+    - for Windows user
+  - More documents
+    - Deployment using apache / passenger / nginx
+  - Complete Tilt examples
+  - Philosophy
+  - Benchmark
+
+## License
+[rack-server-pages](http://github.com/migrs/rack-server-pages) is Copyright (c) 2011 [Masato Igarashi](http://github.com/migrs)(@[migrs](http://twitter.com/migrs)) and distributed under the [MIT license](http://www.opensource.org/licenses/mit-license).