brochure 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Sam Stephenson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,52 @@
+Brochure
+========
+
+A Rack application for serving static sites with ERB templates.
+
+Sample application structure:
+
+    app/
+      helpers/
+        analytics_helper.rb
+        formatting_helper.rb
+      templates/
+        help/
+          index.html.erb
+        index.html.erb
+        shared/
+          _header.html.erb
+          _footer.html.erb
+        signup.html.erb
+    config.ru
+    public/
+      ...
+
+Sample `config.ru`:
+
+    require "brochure"
+    run Brochure::Application.new(File.dirname(__FILE__))
+
+URLs are automatically mapped to template names. So `/` will render
+`app/templates/index.html.erb`, `/signup` will render
+`app/templates/signup.html.erb`, `/help/` will render
+`app/templates/help/index.html.erb`, and so on.
+
+Helpers should define a module that maps to their filename. So
+`analytics_helper.rb` defines `AnalyticsHelper`,
+`html/forms_helper.rb` defines `Html::FormsHelper`, and so on.
+
+Templates can render partials. Partials are denoted by a leading
+underscore in their filename. So `<%= render "shared/header" %>` will
+render `app/templates/shared/_header.html.erb` inline.
+
+# Installation
+
+    $ gem install brochure
+
+Requires [Tilt](http://github.com/rtomayko/tilt).
+
+# License
+
+Copyright (c) 2010 Sam Stephenson.
+
+Released under the MIT license. See `LICENSE` for details.

data/lib/brochure.rb

@@ -0,0 +1,115 @@
+require "tilt"
+
+module Brochure
+  class Application
+    def initialize(root)
+      @app_root      = File.expand_path(root)
+      @helper_root   = File.join(@app_root, "app", "helpers")
+      @template_root = File.join(@app_root, "app", "templates")
+      @context_class = Context.for(helpers)
+      @templates     = {}
+    end
+
+    def helpers
+      @helpers ||= Dir[File.join(@helper_root, "**", "*.rb")].map do |helper_path|
+        base_name    = helper_path[(@helper_root.length + 1)..-1][/(.*?)\.rb$/, 1]
+        module_names = base_name.split("/").map { |n| Brochure.camelize(n) }
+        load helper_path
+        module_names.inject(Kernel) { |mod, name| mod.const_get(name) }
+      end    
+    end
+
+    def call(env)
+      logical_path = env["PATH_INFO"][/[^.]+/]
+      success render(logical_path)
+    rescue TemplateNotFound => e
+      not_found
+    rescue StandardError => e
+      error e
+    end
+
+    def find_template_path(logical_path, options = {})
+      if options[:partial]
+        path_parts   = logical_path.split("/")
+        logical_path = (path_parts[0..-2] + ["_" + path_parts[-1]]).join("/")
+      else
+        return false if File.basename(logical_path)[/^_/]
+      end
+
+      template_path = if File.directory?(File.join(@template_root, logical_path))
+        File.join(@template_root, logical_path, "index.html.erb")
+      else
+        File.join(@template_root, logical_path + ".html.erb")
+      end
+
+      File.exists?(template_path) && template_path
+    end
+
+    def render(logical_path, options = {})
+      if template_path = find_template_path(logical_path, options)
+        context = @context_class.new(self)
+        locals  = options[:locals] || {}
+        template_for(template_path).render(context, locals)
+      else
+        raise TemplateNotFound, "no such template '#{logical_path}'"
+      end
+    end
+
+    def template_for(template_path)
+      @templates[template_path] ||= Tilt.new(template_path)
+    end
+
+    def respond_with(status, body, content_type = "text/html, charset=utf-8")
+      headers = {
+        "Content-Type"   => content_type,
+        "Content-Length" => body.length.to_s
+      }
+      [status, headers, body]
+    end
+
+    def success(body)
+      respond_with 200, body
+    end
+
+    def not_found
+      respond_with 404, <<-HTML
+        <!DOCTYPE html>
+        <html><head><title>Not Found</title></head>
+        <body><h1>404 Not Found</h1></body></html>
+      HTML
+    end
+
+    def error(exception)
+      warn ["#{exception.class.name}: #{exception}", *exception.backtrace].join("\n  ")
+      respond_with 500, <<-HTML
+        <!DOCTYPE html>
+        <html><head><title>Internal Server Error</title></head>
+        <body><h1>500 Internal Server Error</h1></body></html>
+      HTML
+    end
+  end
+
+  class Context
+    include Tilt::CompileSite
+
+    def self.for(helpers)
+      context = Class.new(self)
+      context.send(:include, *helpers) if helpers.any?
+      context
+    end
+
+    def initialize(application)
+      @application = application
+    end
+
+    def render(logical_path, locals = {})
+      @application.render(logical_path, :partial => true, :locals => locals)
+    end
+  end
+
+  class TemplateNotFound < StandardError; end
+
+  def self.camelize(string)
+    string.gsub(/(^|_)(\w)/) { $2.upcase }
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification 
+name: brochure
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Sam Stephenson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-12 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: tilt
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rack-test
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: A Rack application for serving static sites with ERB templates.
+email: 
+- sstephenson@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/brochure.rb
+- README.md
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/sstephenson/brochure
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Rack + ERB static sites
+test_files: []
+