middleman 2.0.4 → 2.0.5

data/lib/middleman/vendor/padrino-core-0.10.0/lib/padrino-core/application.rb

@@ -0,0 +1,259 @@
+module Padrino
+  class ApplicationSetupError < RuntimeError #:nodoc:
+  end
+
+  ##
+  # Subclasses of this become independent Padrino applications (stemming from Sinatra::Application)
+  # These subclassed applications can be easily mounted into other Padrino applications as well.
+  #
+  class Application < Sinatra::Base
+    register Padrino::Routing   # Support for advanced routing, controllers, url_for
+
+    class << self
+
+      def inherited(base) #:nodoc:
+        logger.devel "Setup #{base}"
+        CALLERS_TO_IGNORE.concat(PADRINO_IGNORE_CALLERS)
+        base.default_configuration!
+        base.prerequisites.concat([
+          File.join(base.root, "/models.rb"),
+          File.join(base.root, "/models/**/*.rb"),
+          File.join(base.root, "/lib.rb"),
+          File.join(base.root, "/lib/**/*.rb")
+        ]).uniq!
+        Padrino.require_dependencies(base.prerequisites)
+        super(base) # Loading the subclass inherited method
+      end
+
+      ##
+      # Hooks into when a new instance of the application is created
+      # This is used because putting the configuration into inherited doesn't
+      # take into account overwritten app settings inside subclassed definitions
+      # Only performs the setup first time application is initialized.
+      #
+      def new(*args, &bk)
+        setup_application!
+        logging, logging_was = false, logging
+        show_exceptions, show_exceptions_was = false, show_exceptions
+        super(*args, &bk)
+      ensure
+        logging, show_exceptions = logging_was, show_exceptions_was
+      end
+
+      ##
+      # Reloads the application files from all defined load paths
+      #
+      # This method is used from our Padrino Reloader during development mode
+      # in order to reload the source files.
+      #
+      # ==== Examples
+      #
+      #   MyApp.reload!
+      #
+      def reload!
+        logger.devel "Reloading #{self}"
+        @_dependencies = nil # Reset dependencies
+        reset! # Reset sinatra app
+        reset_routes! # Remove all existing user-defined application routes
+        Padrino.require_dependencies(self.app_file, :force => true) # Reload the app file
+        require_dependencies # Reload dependencies
+        register_initializers # Reload our middlewares
+        default_filters! # Reload filters
+        default_errors!  # Reload our errors
+        I18n.reload! if defined?(I18n) # Reload also our translations
+      end
+
+      ##
+      # Resets application routes to only routes not defined by the user
+      #
+      # ==== Examples
+      #
+      #   MyApp.reset_routes!
+      #
+      def reset_routes!
+        reset_router!
+        default_routes!
+      end
+
+      ##
+      # Returns the routes of our app.
+      #
+      # ==== Examples
+      #
+      #   MyApp.routes
+      #
+      def routes
+        router.routes
+      end
+
+      ##
+      # Setup the application by registering initializers, load paths and logger
+      # Invoked automatically when an application is first instantiated
+      #
+      def setup_application!
+        return if @_configured
+        self.register_initializers
+        self.require_dependencies
+        self.disable :logging # We need do that as default because Sinatra use commonlogger.
+        self.default_filters!
+        self.default_routes!
+        self.default_errors!
+        if defined?(I18n)
+          I18n.load_path << self.locale_path
+          I18n.reload!
+        end
+        @_configured = true
+      end
+
+      ##
+      # Run the Padrino app as a self-hosted server using
+      # Thin, Mongrel or WEBrick (in that order)
+      #
+      def run!(options={})
+        return unless Padrino.load!
+        Padrino.mount(self.to_s).to("/")
+        Padrino.run!(options)
+      end
+
+      ##
+      # Returns the used $LOAD_PATHS from this application
+      #
+      def load_paths
+        @_load_paths ||= %w(models lib mailers controllers helpers).map { |path| File.join(self.root, path) }
+      end
+
+      ##
+      # Returns default list of path globs to load as dependencies
+      # Appends custom dependency patterns to the be loaded for your Application
+      #
+      # ==== Examples
+      #   MyApp.dependencies << "#{Padrino.root}/uploaders/**/*.rb"
+      #   MyApp.dependencies << Padrino.root('other_app', 'controllers.rb')
+      #
+      def dependencies
+        @_dependencies ||= [
+          "urls.rb", "config/urls.rb", "mailers/*.rb", "mailers.rb",
+          "controllers/**/*.rb", "controllers.rb", "helpers/**/*.rb", "helpers.rb"
+        ].map { |file| Dir[File.join(self.root, file)] }.flatten
+      end
+
+      ##
+      # An array of file to load before your app.rb, basically are files wich our app depends on.
+      #
+      # By default we look for files:
+      #
+      #   yourapp/models.rb
+      #   yourapp/models/**/*.rb
+      #   yourapp/lib.rb
+      #   yourapp/lib/**/*.rb
+      #
+      # ==== Examples
+      #   MyApp.prerequisites << Padrino.root('my_app', 'custom_model.rb')
+      #
+      def prerequisites
+        @_prerequisites ||= []
+      end
+
+      protected
+        ##
+        # Defines default settings for Padrino application
+        #
+        def default_configuration!
+          # Overwriting Sinatra defaults
+          set :app_file, File.expand_path(caller_files.first || $0) # Assume app file is first caller
+          set :environment, Padrino.env
+          set :reload, Proc.new { development? }
+          set :logging, Proc.new { development? }
+          set :method_override, true
+          set :sessions, false
+          set :public, Proc.new { Padrino.root('public', uri_root) }
+          set :views, Proc.new { File.join(root,   "views") }
+          set :images_path, Proc.new { File.join(public, "images") }
+          # Padrino specific
+          set :uri_root, "/"
+          set :app_name, self.to_s.underscore.to_sym
+          set :default_builder, 'StandardFormBuilder'
+          set :flash, defined?(Rack::Flash)
+          set :authentication, false
+          # Padrino locale
+          set :locale_path, Proc.new { Dir[File.join(self.root, "/locale/**/*.{rb,yml}")] }
+          # Load the Global Configurations
+          class_eval(&Padrino.apps_configuration) if Padrino.apps_configuration
+        end
+
+        ##
+        # We need to add almost __sinatra__ images.
+        #
+        def default_routes!
+          configure :development do
+            get '/__sinatra__/:image.png' do
+              content_type :png
+              filename = File.dirname(__FILE__) + "/images/#{params[:image]}.png"
+              send_file filename
+            end
+          end
+        end
+
+        ##
+        # This filter it's used for know the format of the request, and automatically set the content type.
+        #
+        def default_filters!
+          before do
+            unless @_content_type
+              @_content_type = :html
+              response['Content-Type'] = 'text/html;charset=utf-8'
+            end
+          end
+        end
+
+        ##
+        # This log errors for production environments
+        #
+        def default_errors!
+          configure :production do
+            error ::Exception do
+              boom = env['sinatra.error']
+              logger.error ["#{boom.class} - #{boom.message}:", *boom.backtrace].join("\n ")
+              response.status = 500
+              content_type 'text/html'
+              '<h1>Internal Server Error</h1>'
+            end
+          end
+        end
+
+        ##
+        # Requires the Padrino middleware
+        #
+        def register_initializers
+          use Padrino::ShowExceptions         if show_exceptions?
+          use Padrino::Logger::Rack, uri_root if Padrino.logger && logging?
+          use Padrino::Reloader::Rack         if reload?
+          use Rack::Flash, :sweep => true     if flash?
+        end
+
+        ##
+        # Requires all files within the application load paths
+        #
+        def require_dependencies
+          Padrino.set_load_paths(*load_paths)
+          Padrino.require_dependencies(dependencies, :force => true)
+        end
+    end # self
+
+    # TODO Remove deprecated render inclusion in a few versions
+    # Detects if a user is incorrectly using 'render' and warns them about the fix
+    # In 0.10.0, Padrino::Rendering now has to be explicitly included in the application
+    def render(*args)
+      if !defined?(DEFAULT_RENDERING_OPTIONS) && !@_render_included &&
+          (args.size == 1 || (args.size == 2 && args[0].is_a?(String) && args[1].is_a?(Hash)))
+        logger.warn "[Deprecation] Please 'register Padrino::Rendering' for each application as shown here:
+          https://gist.github.com/1d36a35794dbbd664ea4 for 'render' to function as expected"
+        self.class.instance_eval { register Padrino::Rendering }
+        @_render_included = true
+        render(*args)
+      else # pass through, rendering is valid
+        super(*args)
+      end
+    end # render method
+  end # Application
+end # Padrino

data/lib/middleman/vendor/padrino-core-0.10.0/lib/padrino-core/application/rendering.rb

@@ -0,0 +1,228 @@
+require 'padrino-core/support_lite' unless defined?(SupportLite)
+
+module Padrino
+  ##
+  # Padrino enhances the Sinatra ‘render’ method to have support for automatic template engine detection,
+  # enhanced layout functionality, locale enabled rendering, among other features.
+  #
+  module Rendering
+    class TemplateNotFound < RuntimeError #:nodoc:
+    end
+
+    ##
+    # This is an array of file patterns to ignore.
+    # If your editor add a suffix during editing to your files please add it like:
+    #
+    #   Padrino::Rendering::IGNORE_FILE_PATTERN << /~$/
+    #
+    IGNORE_FILE_PATTERN = [
+      /~$/ # This is for Gedit
+    ] unless defined?(IGNORE_FILE_PATTERN)
+
+    ##
+    # Default rendering options used in the #render-method
+    #
+    DEFAULT_RENDERING_OPTIONS = { :strict_format => false, :raise_exceptions => true } unless defined?(DEFAULT_RENDERING_OPTIONS)
+
+    ##
+    # Main class that register this extension
+    #
+    class << self
+      def registered(app)
+        app.send(:include, InstanceMethods)
+        app.extend(ClassMethods)
+      end
+      alias :included :registered
+    end
+
+    module ClassMethods
+      ##
+      # Use layout like rails does or if a block given then like sinatra.
+      # If used without a block, sets the current layout for the route.
+      #
+      # By default, searches in your:
+      #
+      # +app+/+views+/+layouts+/+application+.(+haml+|+erb+|+xxx+)
+      # +app+/+views+/+layout_name+.(+haml+|+erb+|+xxx+)
+      #
+      # If you define +layout+ :+custom+ then searches for your layouts in
+      # +app+/+views+/+layouts+/+custom+.(+haml+|+erb+|+xxx+)
+      # +app+/+views+/+custom+.(+haml+|+erb+|+xxx+)
+      #
+      def layout(name=:layout, &block)
+        return super(name, &block) if block_given?
+        @layout = name
+      end
+
+      ##
+      # Returns the cached template file to render for a given url, content_type and locale.
+      #
+      # render_options = [template_path, content_type, locale]
+      #
+      def fetch_template_file(render_options)
+        (@_cached_templates ||= {})[render_options]
+      end
+
+      ###
+      # Caches the template file for the given rendering options
+      #
+      # render_options = [template_path, content_type, locale]
+      #
+      def cache_template_file!(template_file, render_options)
+        (@_cached_templates ||= {})[render_options] = template_file || []
+      end
+
+      ##
+      # Returns the cached layout path.
+      #
+      def fetch_layout_path(given_layout=nil)
+        layout_name = given_layout || @layout || :application
+        @_cached_layout ||= {}
+        cached_layout_path = @_cached_layout[layout_name]
+        return cached_layout_path if cached_layout_path
+        has_layout_at_root = Dir["#{views}/#{layout_name}.*"].any?
+        layout_path = has_layout_at_root ? layout_name.to_sym : File.join('layouts', layout_name.to_s).to_sym
+        @_cached_layout[layout_name] = layout_path unless reload_templates?
+        layout_path
+      end
+    end
+
+    module InstanceMethods
+      attr_reader :current_engine
+
+      def content_type(type=nil, params={}) #:nodoc:
+        type.nil? ? @_content_type : super(type, params)
+      end
+
+      private
+        ##
+        # Enhancing Sinatra render functionality for:
+        #
+        # * Using layout similar to rails
+        # * Use render 'path/to/my/template'   (without symbols)
+        # * Use render 'path/to/my/template'   (with engine lookup)
+        # * Use render 'path/to/template.haml' (with explicit engine lookup)
+        # * Use render 'path/to/template', :layout => false
+        # * Use render 'path/to/template', :layout => false, :engine => 'haml'
+        # * Use render { :a => 1, :b => 2, :c => 3 } # => return a json string
+        #
+        def render(engine, data=nil, options={}, locals={}, &block)
+          # If engine is a hash then render data converted to json
+          return engine.to_json if engine.is_a?(Hash)
+
+          # If engine is nil, ignore engine parameter and shift up all arguments
+          # render nil, "index", { :layout => true }, { :localvar => "foo" }
+          engine, data, options = data, options, locals if engine.nil? && data
+
+          # Data is a hash of options when no engine isn't explicit
+          # render "index", { :layout => true }, { :localvar => "foo" }
+          # Data is options, and options is locals in this case
+          data, options, locals = nil, data, options if data.is_a?(Hash)
+
+          # If data is unassigned then this is a likely a template to be resolved
+          # This means that no engine was explicitly defined
+          data, engine = *resolve_template(engine, options) if data.nil?
+
+          # Setup root
+          root = settings.respond_to?(:root) ? settings.root : ""
+
+          # Use @layout if it exists
+          options[:layout] = @layout if options[:layout].nil?
+
+          # Resolve layouts similar to in Rails
+          if (options[:layout].nil? || options[:layout] == true) && !settings.templates.has_key?(:layout)
+            layout_path, layout_engine = *resolved_layout
+            options[:layout] = layout_path || false # We need to force layout false so sinatra don't try to render it
+            options[:layout] = false unless layout_engine == engine # TODO allow different layout engine
+            options[:layout_engine] = layout_engine || engine if options[:layout]
+            logger.debug "Resolving layout #{root}/views#{options[:layout]}" if defined?(logger) && options[:layout].present?
+          elsif options[:layout].present?
+            options[:layout] = settings.fetch_layout_path(options[:layout] || @layout)
+            logger.debug "Resolving layout #{root}/views#{options[:layout]}" if defined?(logger)
+          end
+
+          # Cleanup the template
+          @current_engine, engine_was = engine, @current_engine
+          @_out_buf,  _buf_was = "", @_out_buf
+
+          # Pass arguments to Sinatra render method
+          super(engine, data, options.dup, locals, &block)
+        ensure
+          @current_engine = engine_was
+          @_out_buf = _buf_was
+        end
+
+        ##
+        # Returns the located layout tuple to be used for the rendered template (if available)
+        #
+        # ==== Example
+        #
+        # resolve_layout
+        # => ["/layouts/custom", :erb]
+        # => [nil, nil]
+        #
+        def resolved_layout
+          located_layout = resolve_template(settings.fetch_layout_path, :raise_exceptions => false, :strict_format => true)
+          located_layout ? located_layout : [nil, nil]
+        end
+
+        ##
+        # Returns the template path and engine that match content_type (if present), I18n.locale.
+        #
+        # === Options
+        #
+        #   :strict_format::  The resolved template must match the content_type of the request (defaults to false)
+        #   :raise_exceptions::  Raises a +TemplateNotFound+ exception if the template cannot be located.
+        #
+        # ==== Example
+        #
+        #   get "/foo", :provides => [:html, :js] do; render 'path/to/foo'; end
+        #   # If you request "/foo.js" with I18n.locale == :ru => [:"/path/to/foo.ru.js", :erb]
+        #   # If you request "/foo" with I18n.locale == :de => [:"/path/to/foo.de.haml", :haml]
+        #
+        def resolve_template(template_path, options={})
+          # Fetch cached template for rendering options
+          template_path = "/#{template_path}" unless template_path.to_s[0] == ?/
+          rendering_options = [template_path, content_type, locale]
+          cached_template = settings.fetch_template_file(rendering_options)
+          return cached_template if cached_template
+
+          # Resolve view path and options
+          options.reverse_merge!(DEFAULT_RENDERING_OPTIONS)
+          view_path = options.delete(:views) || settings.views || "./views"
+          target_extension = File.extname(template_path)[1..-1] || "none" # explicit template extension
+          template_path = template_path.chomp(".#{target_extension}")
+
+          # Generate potential template candidates
+          templates = Dir[File.join(view_path, template_path) + ".*"].map do |file|
+            template_engine = File.extname(file)[1..-1].to_sym # retrieves engine extension
+            template_file   = file.sub(view_path, '').chomp(".#{template_engine}").to_sym # retrieves template filename
+            [template_file, template_engine] unless IGNORE_FILE_PATTERN.any? { |pattern| template_engine.to_s =~ pattern }
+          end
+
+          # Check if we have a simple content type
+          simple_content_type = [:html, :plain].include?(content_type)
+
+          # Resolve final template to render
+          located_template =
+            templates.find { |file, e| file.to_s == "#{template_path}.#{locale}.#{content_type}" } ||
+            templates.find { |file, e| file.to_s == "#{template_path}.#{locale}" && simple_content_type } ||
+            templates.find { |file, e| File.extname(file.to_s) == ".#{target_extension}" or e.to_s == target_extension.to_s } ||
+            templates.find { |file, e| file.to_s == "#{template_path}.#{content_type}" } ||
+            templates.find { |file, e| file.to_s == "#{template_path}" && simple_content_type } ||
+            (!options[:strict_format] && templates.first) # If not strict, fall back to the first located template
+
+          raise TemplateNotFound, "Template '#{template_path}' not found in '#{view_path}'!"  if !located_template && options[:raise_exceptions]
+          settings.cache_template_file!(located_template, rendering_options) unless settings.reload_templates?
+          located_template
+        end
+
+        ##
+        # Return the I18n.locale if I18n is defined
+        #
+        def locale
+          I18n.locale if defined?(I18n)
+        end
+    end # InstanceMethods
+  end # Rendering
+end # Padrino