Contents

module Padrino
  # Represents a particular mounted padrino application
  # Stores the name of the application (app folder name) and url mount path
  # @example Mounter.new("blog_app").to("/blog")
  # @example Mounter.new("blog_app", :app_file => "/path/to/root/app.rb").to("/blog")
  # @example Mounter.new("blog_app", :app_class => "Blog").to("/blog")
  class Mounter
    attr_accessor :name, :uri_root, :app_file, :app_klass
    def initialize(name, options={})
      @name      = name
      @app_klass = options[:app_class] || name.classify
      @app_file  = options[:app_file]  || Padrino.mounted_root(name, 'app.rb')
    end

    # Registers the mounted application onto Padrino
    # @example Mounter.new("blog_app").to("/blog")
    def to(mount_url)
      @uri_root = mount_url
      Padrino.mounted_apps << self
    end

    # Maps Padrino application onto a Rack::Builder
    # For use in constructing a Rack application
    # @example @app.map_onto(@builder)
    def map_onto(builder)
      require(self.app_file)
      app_data, app_klass = self, self.app_klass.constantize
      builder.map self.uri_root do
        app_klass.set :uri_root, app_data.uri_root
        app_klass.set :app_file, app_data.app_file
        run app_klass
      end
    end
  end

  class << self
    # Returns the root to the mounted apps base directory
    def mounted_root(*args)
      File.join(Padrino.root, "apps", *args)
    end

    # Returns the mounted padrino applications (MountedApp objects)
    def mounted_apps
      @mounted_apps ||= []
    end

    # Mounts a new sub-application onto Padrino project
    # @example Padrino.mount("blog_app").to("/blog")
    def mount(name, options={})
      Mounter.new(name, options)
    end
    
    # Mounts the core application onto Padrino project
    # @example Padrino.mount_core(:app_file => "/path/to/file", :app_class => "Blog")
    def mount_core(options={})
      options.reverse_merge!(:app_file => Padrino.root('app.rb'))
      Mounter.new("core", options).to("/")
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
padrino-core-0.1.2	lib/padrino-core/mounter.rb