hanami-view 1.3.3 → 2.0.0.alpha2

data/lib/hanami/layout.rb

@@ -1,190 +0,0 @@
-require 'hanami/utils/class_attribute'
-require 'hanami/view/rendering/layout_registry'
-require 'hanami/view/rendering/layout_scope'
-require 'hanami/view/rendering/null_layout'
-require 'hanami/view/rendering/null_view'
-
-module Hanami
-  # Layout
-  #
-  # @since 0.1.0
-  #
-  # @see Hanami::Layout::ClassMethods
-  module Layout
-    # Register a layout
-    #
-    # @api private
-    # @since 0.1.0
-    #
-    # @example
-    #   require 'hanami/view'
-    #
-    #   class ApplicationLayout
-    #     include Hanami::Layout
-    #   end
-    def self.included(base)
-      conf = Hanami::View::Configuration.for(base)
-      conf.add_layout(base)
-
-      base.class_eval do
-        extend Hanami::View::Dsl.dup
-        extend ClassMethods
-
-        include Utils::ClassAttribute
-        class_attribute :configuration
-
-        self.configuration = conf.duplicate
-      end
-
-      conf.copy!(base)
-    end
-
-    # Class level API
-    #
-    # @since 0.1.0
-    module ClassMethods
-      # Template name suffix
-      #
-      # @api private
-      # @since 0.1.0
-      #
-      # @see Hanami::Layout::ClassMethods#suffix
-      # @see Hanami::Layout::ClassMethods#template
-      SUFFIX = '_layout'.freeze
-
-      # A registry that holds all the registered layouts.
-      #
-      # @api private
-      # @since 0.1.0
-      #
-      # @see Hanami::View::Rendering::LayoutRegistry
-      def registry
-        @registry ||= View::Rendering::LayoutRegistry.new(self)
-      end
-
-      # Template name
-      #
-      # @api private
-      # @since 0.1.0
-      #
-      # @see Hanami::Layout::ClassMethods#SUFFIX
-      # @see Hanami::Layout::ClassMethods#suffix
-      #
-      # @example
-      #   # Given a template 'templates/application.html.erb'
-      #
-      #   class ApplicationLayout
-      #     include Hanami::Layout
-      #   end
-      #
-      # ApplicationLayout.template # => 'application'
-      def template
-        super.sub(suffix, '')
-      end
-
-      # Template name suffix
-      #
-      # @api private
-      # @since 0.1.0
-      #
-      # @see Hanami::Layout::ClassMethods#SUFFIX
-      # @see Hanami::Layout::ClassMethods#template
-      def suffix
-        SUFFIX
-      end
-
-      protected
-
-      # Loading mechanism hook.
-      #
-      # @api private
-      # @since 0.1.0
-      #
-      # @see Hanami::View.load!
-      def load!
-        load_registry!
-        configuration.freeze
-      end
-
-      private
-
-      # @api private
-      def load_registry!
-        @registry = nil
-        registry.freeze
-      end
-    end
-
-    # Initialize a layout
-    #
-    # @param scope [Hanami::View::Rendering::Scope,::Hash] view rendering scope.
-    #   Optionally a scope can be expressed as a Ruby `::Hash`, but it MUST contain
-    #   the `:format` key, to specify which template to render.
-    # @option scope [Symbol] :format the format to render (e.g. `:html`, `:xml`, `:json`)
-    #   This is mandatory only if a `:Hash` is passed as `scope`.
-    #
-    # @param rendered [String] the output of the view rendering process
-    #
-    # @api private
-    # @since 0.1.0
-    #
-    # @see Hanami::View::Rendering#render
-    def initialize(scope, rendered)
-      # NOTE: This complex data transformation is due to a combination of a bug and the intent of maintaing backward compat (SemVer).
-      # See https://github.com/hanami/view/pull/156
-      s, r = *case scope
-              when ::Hash
-                [Hanami::View::Rendering::Scope.new(Hanami::View::Rendering::NullView, scope), rendered]
-              when Hanami::View::Template
-                [Hanami::View::Rendering::Scope.new(Hanami::View::Rendering::NullView, rendered.merge(format: scope.format)), ""]
-              else
-                [scope, rendered]
-              end
-
-      @scope = View::Rendering::LayoutScope.new(self, s)
-      @rendered = r
-    end
-
-    # Render the layout
-    #
-    # @return [String] the output of the rendering process
-    #
-    # @api private
-    # @since 0.1.0
-    #
-    # @see Hanami::View::Rendering#render
-    def render
-      template.render(@scope, &Proc.new{@rendered})
-    end
-
-    # It tries to invoke a method for the view or a local for the given key.
-    # If the lookup fails, it returns a null object.
-    #
-    # @return [Object,Hanami::View::Rendering::NullLocal] the returning value
-    #
-    # @since 1.1.0
-    #
-    # @example Safe method navigation
-    #   class ApplicationLayout
-    #     include Hanami::Layout
-    #
-    #     def render_flash
-    #       return if local(:flash).nil?
-    #
-    #       # ...
-    #     end
-    #   end
-    def local(key)
-      @scope.local(key)
-    end
-
-    protected
-    # The template for the current format
-    #
-    # @api private
-    # @since 0.1.0
-    def template
-      self.class.registry.resolve({format: @scope.format})
-    end
-  end
-end

data/lib/hanami/presenter.rb

@@ -1,98 +0,0 @@
-require 'hanami/view/escape'
-
-module Hanami
-  # Presenter pattern implementation
-  #
-  # It delegates to the wrapped object the missing method invocations.
-  #
-  # The output of concrete and delegated methods is escaped as XSS prevention.
-  #
-  # @since 0.1.0
-  #
-  # @example Basic usage
-  #   require 'hanami/view'
-  #
-  #   class Map
-  #     attr_reader :locations
-  #
-  #     def initialize(locations)
-  #       @locations = locations
-  #     end
-  #
-  #     def location_names
-  #       @locations.join(', ')
-  #     end
-  #   end
-  #
-  #   class MapPresenter
-  #     include Hanami::Presenter
-  #
-  #     def count
-  #       locations.count
-  #     end
-  #
-  #     def location_names
-  #       super.upcase
-  #     end
-  #
-  #     def inspect_object
-  #       @object.inspect
-  #     end
-  #   end
-  #
-  #   map = Map.new(['Rome', 'Boston'])
-  #   presenter = MapPresenter.new(map)
-  #
-  #   # access a map method
-  #   puts presenter.locations # => ['Rome', 'Boston']
-  #
-  #   # access presenter concrete methods
-  #   puts presenter.count # => 1
-  #
-  #   # uses super to access original object implementation
-  #   puts presenter.location_names # => 'ROME, BOSTON'
-  #
-  #   # it has private access to the original object
-  #   puts presenter.inspect_object # => #<Map:0x007fdeada0b2f0 @locations=["Rome", "Boston"]>
-  #
-  # @example Escape
-  #   require 'hanami/view'
-  #
-  #   User = Struct.new(:first_name, :last_name)
-  #
-  #   class UserPresenter
-  #     include Hanami::Presenter
-  #
-  #     def full_name
-  #       [first_name, last_name].join(' ')
-  #     end
-  #
-  #     def raw_first_name
-  #       _raw first_name
-  #     end
-  #   end
-  #
-  #   first_name = '<script>alert('xss')</script>'
-  #
-  #   user = User.new(first_name, nil)
-  #   presenter = UserPresenter.new(user)
-  #
-  #   presenter.full_name
-  #     # => "&lt;script&gt;alert(&apos;xss&apos;)&lt;&#x2F;script&gt;"
-  #
-  #   presenter.raw_full_name
-  #      # => "<script>alert('xss')</script>"
-  module Presenter
-    # Inject escape logic into the given class.
-    #
-    # @since 0.4.0
-    # @api private
-    #
-    # @see Hanami::View::Escape
-    def self.included(base)
-      base.class_eval do
-        include ::Hanami::View::Escape::Presentable
-      end
-    end
-  end
-end

data/lib/hanami/view/configuration.rb

@@ -1,504 +0,0 @@
-require 'set'
-require 'hanami/utils/class'
-require 'hanami/utils/kernel'
-require 'hanami/utils/string'
-require 'hanami/utils/load_paths'
-require 'hanami/view/rendering/layout_finder'
-require 'hanami/view/rendering/partial_templates_finder'
-
-module Hanami
-  module View
-    # Configuration for the framework, controllers and actions.
-    #
-    # Hanami::Controller has its own global configuration that can be manipulated
-    # via `Hanami::View.configure`.
-    #
-    # Every time that `Hanami::View` and `Hanami::Layout` are included, that
-    # global configuration is being copied to the recipient. The copy will
-    # inherit all the settings from the original, but all the subsequent changes
-    # aren't reflected from the parent to the children, and viceversa.
-    #
-    # This architecture allows to have a global configuration that capture the
-    # most common cases for an application, and let views and layouts
-    # layouts to specify exceptions.
-    #
-    # @since 0.2.0
-    class Configuration
-      # Default root
-      #
-      # @since 0.2.0
-      # @api private
-      DEFAULT_ROOT = '.'.freeze
-
-      # Default encoding
-      #
-      # @since 0.5.0
-      # @api private
-      DEFAULT_ENCODING = Encoding::UTF_8
-
-      attr_reader :load_paths
-      attr_reader :views
-      attr_reader :layouts
-      attr_reader :modules
-      attr_reader :partials
-
-      # Return the original configuration of the framework instance associated
-      # with the given class.
-      #
-      # When multiple instances of Hanami::View are used in the same application,
-      # we want to make sure that a controller or an action will  receive the
-      # expected configuration.
-      #
-      # @param base [Class] a view or a layout
-      #
-      # @return [Hanami::Controller::Configuration] the configuration associated
-      #   to the given class.
-      #
-      # @since 0.2.0
-      # @api private
-      #
-      # @example Direct usage of the framework
-      #   require 'hanami/view'
-      #
-      #   class Show
-      #     include Hanami::View
-      #   end
-      #
-      #   Hanami::View::Configuration.for(Show)
-      #     # => will return from Hanami::View
-      #
-      # @example Multiple instances of the framework
-      #   require 'hanami/view'
-      #
-      #   module MyApp
-      #     View = Hanami::View.duplicate(self)
-      #
-      #     module Views::Dashboard
-      #       class Index
-      #         include MyApp::View
-      #       end
-      #     end
-      #   end
-      #
-      #   class Show
-      #     include Hanami::Action
-      #   end
-      #
-      #   Hanami::View::Configuration.for(Show)
-      #     # => will return from Hanami::View
-      #
-      #   Hanami::View::Configuration.for(MyApp::Views::Dashboard::Index)
-      #     # => will return from MyApp::View
-      def self.for(base)
-        # TODO this implementation is similar to Hanami::Controller::Configuration consider to extract it into Hanami::Utils
-        namespace = Utils::String.namespace(base)
-        framework = Utils::Class.load("#{namespace}::View") || Utils::Class.load!('Hanami::View')
-        framework.configuration
-      end
-
-      # Initialize a configuration instance
-      #
-      # @return [Hanami::View::Configuration] a new configuration's instance
-      #
-      # @since 0.2.0
-      def initialize
-        @namespace = Object
-        reset!
-      end
-
-      # Set the Ruby namespace where to lookup for views.
-      #
-      # When multiple instances of the framework are used, we want to make sure
-      # that if a `MyApp` wants a `Dashboard::Index` view, we are loading the
-      # right one.
-      #
-      # If not set, this value defaults to `Object`.
-      #
-      # This is part of a DSL, for this reason when this method is called with
-      # an argument, it will set the corresponding instance variable. When
-      # called without, it will return the already set value, or the default.
-      #
-      # @overload namespace(value)
-      #   Sets the given value
-      #   @param value [Class, Module, String] a valid Ruby namespace identifier
-      #
-      # @overload namespace
-      #   Gets the value
-      #   @return [Class, Module, String]
-      #
-      # @since 0.2.0
-      #
-      # @example Getting the value
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configuration.namespace # => Object
-      #
-      # @example Setting the value
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     namespace 'MyApp::Views'
-      #   end
-      def namespace(value = nil)
-        if value
-          @namespace = value
-        else
-          @namespace
-        end
-      end
-
-      # Set the root path where to search for templates
-      #
-      # If not set, this value defaults to the current directory.
-      #
-      # This is part of a DSL, for this reason when this method is called with
-      # an argument, it will set the corresponding instance variable. When
-      # called without, it will return the already set value, or the default.
-      #
-      # @overload root(value)
-      #   Sets the given value
-      #   @param value [String,Pathname,#to_pathname] an object that can be
-      #     coerced to Pathname
-      #   @raise [Errno::ENOENT] if the given path doesn't exist
-      #
-      # @overload root
-      #   Gets the value
-      #   @return [Pathname]
-      #
-      # @since 0.2.0
-      #
-      # @see Hanami::View::Dsl#root
-      # @see http://www.ruby-doc.org/stdlib-2.1.2/libdoc/pathname/rdoc/Pathname.html
-      # @see http://rdoc.info/gems/hanami-utils/Hanami/Utils/Kernel#Pathname-class_method
-      #
-      # @example Getting the value
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configuration.root # => #<Pathname:.>
-      #
-      # @example Setting the value
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     root '/path/to/templates'
-      #   end
-      #
-      #   Hanami::View.configuration.root # => #<Pathname:/path/to/templates>
-      def root(value = nil)
-        if value
-          @root = Utils::Kernel.Pathname(value).realpath
-        else
-          @root
-        end
-      end
-
-      # Set the global layout
-      #
-      # If not set, this value defaults to `nil`, while at the rendering time
-      # it will use `Hanami::View::Rendering::NullLayout`.
-      #
-      # This is part of a DSL, for this reason when this method is called with
-      # an argument, it will set the corresponding instance variable. When
-      # called without, it will return the already set value, or the default.
-      #
-      # @overload layout(value)
-      #   Sets the given value
-      #   @param value [Symbol] the name of the layout
-      #
-      # @overload layout
-      #   Gets the value
-      #   @return [Class]
-      #
-      # @since 0.2.0
-      #
-      # @see Hanami::View::Dsl#layout
-      #
-      # @example Getting the value
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configuration.layout # => nil
-      #
-      # @example Setting the value
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     layout :application
-      #   end
-      #
-      #   Hanami::View.configuration.layout # => ApplicationLayout
-      #
-      # @example Setting the value in a namespaced app
-      #   require 'hanami/view'
-      #
-      #   module MyApp
-      #     View = Hanami::View.duplicate(self) do
-      #       layout :application
-      #     end
-      #   end
-      #
-      #   MyApp::View.configuration.layout # => MyApp::ApplicationLayout
-      def layout(value = nil)
-        if value.nil?
-          Rendering::LayoutFinder.find(@layout, @namespace)
-        else
-          @layout = value
-        end
-      end
-
-      # Default encoding for templates
-      #
-      # This is part of a DSL, for this reason when this method is called with
-      # an argument, it will set the corresponding instance variable. When
-      # called without, it will return the already set value, or the default.
-      #
-      # @overload default_encoding(value)
-      #   Sets the given value
-      #   @param value [String,Encoding] a string representation of the encoding,
-      #     or an Encoding constant
-      #
-      #   @raise [ArgumentError] if the given value isn't a supported encoding
-      #
-      # @overload default_encoding
-      #   Gets the value
-      #   @return [Encoding]
-      #
-      # @since 0.5.0
-      #
-      # @example Set UTF-8 As A String
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     default_encoding 'utf-8'
-      #   end
-      #
-      # @example Set UTF-8 As An Encoding Constant
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     default_encoding Encoding::UTF_8
-      #   end
-      #
-      # @example Raise An Error For Unknown Encoding
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     default_encoding 'foo'
-      #   end
-      #
-      #     # => ArgumentError
-      def default_encoding(value = nil)
-        if value.nil?
-          @default_encoding
-        else
-          @default_encoding = Encoding.find(value)
-        end
-      end
-
-      # Prepare the views.
-      #
-      # The given block will be yielded when `Hanami::View` will be included by
-      # a view.
-      #
-      # This method can be called multiple times.
-      #
-      # @param blk [Proc] the code block
-      #
-      # @return [void]
-      #
-      # @raise [ArgumentError] if called without passing a block
-      #
-      # @since 0.3.0
-      #
-      # @see Hanami::View.configure
-      # @see Hanami::View.duplicate
-      #
-      # @example Including shared utilities
-      #   require 'hanami/view'
-      #
-      #   module UrlHelpers
-      #     def comments_path
-      #       '/'
-      #     end
-      #   end
-      #
-      #   Hanami::View.configure do
-      #     prepare do
-      #       include UrlHelpers
-      #     end
-      #   end
-      #
-      #   Hanami::View.load!
-      #
-      #   module Comments
-      #     class New
-      #       # The following include will cause UrlHelpers to be included too.
-      #       # This makes `comments_path` available in the view context
-      #       include Hanami::View
-      #
-      #       def form
-      #         %(<form action="#{ comments_path }" method="POST"></form>)
-      #       end
-      #     end
-      #   end
-      #
-      # @example Preparing multiple times
-      #   require 'hanami/view'
-      #
-      #   Hanami::View.configure do
-      #     prepare do
-      #       include UrlHelpers
-      #     end
-      #
-      #     prepare do
-      #       format :json
-      #     end
-      #   end
-      #
-      #   Hanami::View.configure do
-      #     prepare do
-      #       include FormattingHelpers
-      #     end
-      #   end
-      #
-      #   Hanami::View.load!
-      #
-      #   module Articles
-      #     class Index
-      #       # The following include will cause the inclusion of:
-      #       #   * UrlHelpers
-      #       #   * FormattingHelpers
-      #       #
-      #       # It also sets the view to render only JSON
-      #       include Hanami::View
-      #     end
-      #   end
-      def prepare(&blk)
-        if block_given?
-          @modules.push(blk)
-        else
-          raise ArgumentError.new('Please provide a block')
-        end
-      end
-
-      # Add a view to the registry
-      #
-      # @since 0.2.0
-      # @api private
-      def add_view(view)
-        @views.add(view)
-      end
-
-      # Add a layout to the registry
-      #
-      # @since 0.2.0
-      # @api private
-      def add_layout(layout)
-        @layouts.add(layout)
-      end
-
-      # Duplicate by copying the settings in a new instance.
-      #
-      # @return [Hanami::View::Configuration] a copy of the configuration
-      #
-      # @since 0.2.0
-      # @api private
-      def duplicate
-        Configuration.new.tap do |c|
-          c.namespace        = namespace
-          c.root             = root
-          c.layout           = @layout # lazy loading of the class
-          c.default_encoding = default_encoding
-          c.load_paths       = load_paths.dup
-          c.modules          = modules.dup
-        end
-      end
-
-      # Load the configuration for the current framework
-      #
-      # @since 0.2.0
-      # @api private
-      def load!
-        views.each   { |v| v.__send__(:load!) }
-        layouts.each { |l| l.__send__(:load!) }
-        load_partials!
-        freeze
-      end
-
-      # Load partials for each partial template file found under the
-      # given load paths
-      #
-      # @since 0.7.0
-      # @api private
-      def load_partials!
-        Hanami::View::Rendering::PartialTemplatesFinder.new(self).find.each do |partial|
-          add_partial(partial)
-        end
-      end
-
-      # Load partials for each partial template file found under the
-      # given load paths
-      #
-      # @since 0.7.0
-      # @api private
-      def find_partial(relative_partial_path, template_name, format)
-        partials_for_view = partials.has_key?(relative_partial_path) ?  partials[relative_partial_path] : partials[template_name]
-        partials_for_view ? partials_for_view[format.to_sym] : nil
-      end
-
-      # Add a partial to the registry
-      #
-      # @since 0.7.0
-      # @api private
-      def add_partial(partial)
-        @partials[partial.key][partial.format.to_sym] = partial.template
-      end
-
-      # Reset all the values to the defaults
-      #
-      # @since 0.2.0
-      # @api private
-      def reset!
-        root             DEFAULT_ROOT
-        default_encoding DEFAULT_ENCODING
-
-        @partials   = Hash.new { |h, k| h[k] = Hash.new }
-        @views      = Set.new
-        @layouts    = Set.new
-        @load_paths = Utils::LoadPaths.new(root)
-        @layout     = nil
-        @modules    = []
-      end
-
-      # Copy the configuration for the given action
-      #
-      # @param base [Class] the target action
-      #
-      # @return void
-      #
-      # @since 0.3.0
-      # @api private
-      def copy!(base)
-        modules.each do |mod|
-          base.class_eval(&mod)
-        end
-      end
-
-      # @api private
-      alias_method :unload!, :reset!
-
-      protected
-      # @api private
-      attr_writer :namespace
-      # @api private
-      attr_writer :root
-      # @api private
-      attr_writer :load_paths
-      # @api private
-      attr_writer :layout
-      # @api private
-      attr_writer :default_encoding
-      # @api private
-      attr_writer :modules
-    end
-  end
-end