dry-view 0.5.1 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b7142689536853b1e216512d00558c4edbaafe44ee3abc2d1e51eb1ad498bc1
-  data.tar.gz: 6373160c6fa073a52c9fa106b6f1c8ac0b58c088bbce26e29b4b65ff587dad27
+  metadata.gz: 5e819c2e7fc0b6fe2aed059b2d63993b2e107e7d9b682652dc9a0dedefdf7458
+  data.tar.gz: e45c5c695005d30eb755ccffd22efc5bbdf7c91b018f4c2fe859cb6b015f70bc
 SHA512:
-  metadata.gz: 0eaccf27fc9d7f29a8b3be6e9b695341738e67d98b132630d8ec6bc462683bdcfa4613ed59c00a8d3791f93789f4a5c437ee6dd2b66c5c893d52e537a3a93f51
-  data.tar.gz: a6b0bb154f5056de7b1bf6ca21d78e7ad9e1453dcc64d438d7f435e6285f236e0627d55838ba020bdf68749a4a1da577b6dc1e2cacc9e8b8993ba553d99a797d
+  metadata.gz: a4797bca5d6dba8ba676794d9ff21c531c1ee303a0af87f924ee09e89c9faadc898f5b1dc9d24731c32e62d5b5c031efa4b6f8a7062ab30bd3f7ea4397eac7b2
+  data.tar.gz: 60fe4d2131720fd19cebe465283f06f05abb0247b094fc946ff96ac9b0b77c5962561ee68da1dd067876ace1d5def0caccdf18e7598a25800cf199aad5f36772

data/CHANGELOG.md

@@ -1,21 +1,129 @@
-# 0.5.1 / 2018-02-20
+<!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
+
+## 0.7.1 2021-02-08
+
+
+### Fixed
+
+- Template not found errors properly show configured paths (@adam12 in #144)
+
+### Changed
+
+- Compatible with Ruby 2.7/3.0 keyword argument handling (@flash-gordon in 4e7cefb)
+- dry-equalizer dependency dropped in favor of dry-core (@solnic)
+
+[Compare v0.7.0...v0.7.1](https://github.com/dry-rb/dry-view/compare/v0.7.0...v0.7.1)
+
+## 0.7.0 2019-03-06
+
+
+### Added
+
+- Raise a `Dry::View::UndefinedConfigError` when a view is called but no paths have been configured (timriley in [#130][pr130])
+
+### Fixed
+
+- Avoid a `SystemStackError` when a view is configured with a template that cannot be found on the filesystem (timriley in [#129][pr129])
+
+### Changed
+
+- [BREAKING] Move `Dry::View::Renderer::TemplateNotFoundError` to `Dry::View::TemplateNotFoundError` (timriley in [#130][pr130])
+- [BREAKING] `Dry::View::UndefinedConfigError` is raised instead of `Dry::View::UndefinedTemplateError` when a view is called but no template has been configured (timriley in [#130][pr130])
+- Stop searching upwards through parent directories when rendering a view's template (as opposed to partials) (timriley in [#130][pr130])
+- Stop searching in `shared/` subdirectories when rendering a view's template (as opposed to partials) (timriley in [#130][pr130])
+- Adjust template lookup cache keys to ensure no false hits (timriley in [#130][pr130])
+
+[Compare v0.6.0...v0.7.0](https://github.com/dry-rb/dry-view/compare/v0.6.0...v0.7.0)
+
+## 0.6.0 2019-01-30
+
+
+### Added
+
+- [BREAKING] `Dry::View#call` now returns a `Dry::View::Rendered` instance, which carries both the rendered output (accessible via `#to_s` or `#to_str`) as well as all of the view's locals, wrapped in their view parts (accessible via `#locals` or individually via `#[]`) (timriley in [#72][pr72])
+- [BREAKING] Added `Dry::View::PartBuilder` (renamed from `Dry::View::Decorator`), which resolves part classes from a namespace configured via View's `part_namespace` setting. A custom part builder can be specified via a View's `part_builder` setting. (timriley in [#80][pr80])
+- [BREAKING] Context classes can now declare decorated attributes just like part classes, via `.decorate` class-level API. Context classes are now required to inherit from `Dry::View::Context`. `Dry::View::Context` provides a `#with` method for creating copies of itself while preserving the rendering details needed for decorated attributes to work (timriley in [#89][pr89] and [#91][pr91])
+- Customizable _scope_ objects, which work like view parts, but instead of encapsulating a single value, they encapsulate a whole template or partial and all of its locals. Scopes can be created via `#scope` method in templates, parts, as well as scope classes themselves. Scope classes are resolved via a View's `scope_builder` setting, which defaults to an instance of `Dry::View::ScopeBuilder`.
+- Added `inflector` setting to View, which is used by the part and scope builders to resolve classes for a given part or scope name. Defaults to `Dry::Inflector.new` (timriley in [#80][pr80] and [#90][pr90])
+- Exposures can be sent to the layout template when defined with `layout: true` option (GustavoCaso in [#87][pr87])
+- Exposures can be left undecorated by a part when defined with `decorate: false` option (timriley in [#88][pr88])
+- Part classes have access to the current template format via a private `#_format` method (timriley in [#118][pr118])
+- Added "Tilt adapter" layer, to ensure a rendering engine compatible with dry-view's features is being used. Added adapters for "haml" and "erb" templates to ensure that "hamlit-block" and "erbse" are required and used as engines (unlike their more common counterparts, both of these engines support the implicit block capturing that is a central part of dry-view rendering behaviour) (timriley in [#106][pr106])
+- Added `renderer_engine_mapping` setting to View, which allows an explicit engine class to be provided for the rendering of a given type of template (e.g. `config.renderer_engine_mapping = {erb: Tilt::ErubiTemplate}`) (timriley in [#106][pr106])
+
+### Fixed
+
+- Preserve renderer options when chdir-ing (timriley in [889ac7b](https://github.com/dry-rb/dry-view/commit/889ac7b))
+
+### Changed
+
+- [BREAKING] `Dry::View::Controller` renamed to `Dry::View` (timriley in [#115][pr115])
+- [BREAKING] `Dry::View` `context` setting renamed to `default_context` (GustavoCaso in [#86][pr86])
+- Exposure values are wrapped in their view parts before being made available as exposure dependencies (timriley in [#80][pr80])
+- Exposures can access current context object through `context:` block or method parameter (timriley in [#119][pr119])
+- Improved performance due to caching various lookups (timriley and GustavoCaso in [#97][pr97])
+- `Part#inspect` output simplified to include only name and value (timriley in [#98][pr98])
+- Attribute decoration in `Part` now achieved via a prepended module, which means it is possible to decorate an attribute provided by an instance method directly on the part class, which wasn't possible with the previous `method_missing`-based approach (timriley in [#110][pr110])
+- `Part` classes can be initialized with missing `name:` and `rendering:` values, which can be useful for unit testing Part methods that don't use any rendering facilities (timriley in [#116][pr116])
+
+[Compare v0.5.4...v0.6.0](https://github.com/dry-rb/dry-view/compare/v0.5.4...v0.6.0)
+
+## 0.5.4 2019-01-06
+
+This version was yanked due to the release accidentally containing a batch of breaking changes from master.
+
+### Fixed
+
+- Preserve renderer options when chdir-ing (timriley in [889ac7b](https://github.com/dry-rb/dry-view/commit/889ac7b))
+
+
+[Compare v0.5.3...v0.5.4](https://github.com/dry-rb/dry-view/compare/v0.5.3...v0.5.4)
+
+## 0.5.3 2018-10-22
+
+
+### Added
+
+- `renderer_options` setting for configuring tilt-based renderer (liseki in [#62][pr62])
+
+### Changed
+
+- Part objects wrap values more transparently, via added `#respond_to_missing?` (liseki in [#63][pr63])
+
+[Compare v0.5.2...v0.5.3](https://github.com/dry-rb/dry-view/compare/v0.5.2...v0.5.3)
+
+## 0.5.2 2018-06-13
+
+
+### Changed
+
+- Only truthy view part attributes are decorated (timriley)
+
+[Compare v0.5.1...v0.5.2](https://github.com/dry-rb/dry-view/compare/v0.5.1...v0.5.2)
+
+## 0.5.1 2018-02-20
+
 
 ### Added
 
 - Exposures are inherited from parent view controller classes (GustavoCaso)
 
+
 [Compare v0.5.0...v0.5.1](https://github.com/dry-rb/dry-view/compare/v0.5.0...v0.5.1)
 
-# 0.5.0 / 2018-01-23
+## 0.5.0 2018-01-23
+
 
 ### Added
 
 - Support for parts with decorated attributes (timriley + GustavoCaso)
 - Ability to easily create another part instance via `Part#new` (GustavoCaso)
 
+
 [Compare v0.4.0...v0.5.0](https://github.com/dry-rb/dry-view/compare/v0.4.0...v0.5.0)
 
-# 0.4.0 / 2017-11-01
+## 0.4.0 2017-11-01
+
 
 ### Added
 
@@ -29,35 +137,52 @@
 - Allow `Dry::View::Part` instances to be created without explicitly passing a `renderer`. This is helpful for unit testing view parts that don't need to render anything (dNitza)
 - Partials can be nested within additional sub-directories by rendering them their relative path as their name, e.g. `render(:"foo/bar")` will look for a `foo/_bar.html.slim` template within the normal template lookup paths (timriley)
 
-# 0.3.0 / 2017-05-14
+[Compare v0.3.0...v0.4.0](https://github.com/dry-rb/dry-view/compare/v0.3.0...v0.4.0)
+
+## 0.3.0 2017-05-14
 
 This release reintroduces view parts in a more helpful form. You can provide your own custom view part classes to encapsulate your view logic, as well as a  decorator for custom, shared behavior arouund view part wrapping.
 
+### Added
+
+- Wrap all values passed to the template in `Dry::View::Part` objects
+- Added a `decorator` config to `Dry::View::Controller`, with a default `Dry::View::Decorator` that wraps the exposure values in `Dry::View::Part` objects (as above). Provide your own part classes by passing an `:as` option to your exposures, e.g. `expose :user, as: MyApp::UserPart`
+
 ### Changed
 
 - [BREAKING] Partial rendering in templates requires an explicit `render` method call instead of method_missing behaviour usinig the partial's name (e.g. `<%= render :my_partial %>` instead of `<%= my_partial %>`)
 
-### Added
+[Compare v0.2.2...v0.3.0](https://github.com/dry-rb/dry-view/compare/v0.2.2...v0.3.0)
 
-- Wrap all values passed to the template in `Dry::View::Part` objects
-- Added a `decorator` config to `Dry::View::Controller`, with a default `Dry::View::Decorator` that wraps the exposure values in `Dry::View::Part` objects (as above). Provide your own part classes by passing an `:as` option to your exposures, e.g. `expose :user, as: MyApp::UserPart`
+## 0.2.2 2017-01-31
 
-# 0.2.2 / 2017-01-31
 
 ### Changed
 
 - Make input passthrough exposures (when there is no block or matching instance metod) return nil instead of raise in the case of a missing input key (timriley)
 
-# 0.2.1 / 2017-01-30
+[Compare v0.2.1...v0.2.2](https://github.com/dry-rb/dry-view/compare/v0.2.1...v0.2.2)
+
+## 0.2.1 2017-01-30
+
 
 ### Fixed
 
 - Exposure blocks now have access to the view controller instance when they're called (timriley)
 
-# 0.2.0 / 2017-01-30
+
+[Compare v0.2.0...v0.2.1](https://github.com/dry-rb/dry-view/compare/v0.2.0...v0.2.1)
+
+## 0.2.0 2017-01-30
 
 This release is a major reorientation for dry-view, and it should allow for more natural, straightforward template authoring.
 
+### Added
+
+- Will render templates using any Tilt-supported engine, based on the template's final file extension (e.g. `hello.html.slim` will use Slim). For thread-safety, be sure to explicitly require any engine gems you intend to use. (timriley)
+- `expose` (and `expose_private`) `Dry::View::Controller` class methods allow you to more easily declare and prepare the data for your template (timriley)
+- Added `Dry::View::Scope`, which is the scope used for rendering templates. This includes the data from the exposures along with the context object (timriley)
+
 ### Changed
 
 - [BREAKING] `Dry::View::Layout` renamed to `Dry::View::Controller`. The "view controller" name better represents this object's job: to  (timriley)
@@ -69,13 +194,10 @@ This release is a major reorientation for dry-view, and it should allow for more
 - [BREAKING] With view parts removed, partials can only be rendered by top-level method calls within templates (timriley)
 - Ruby version 2.1.0 is now the earliest supported version (timriley)
 
-### Added
+[Compare v0.1.1...v0.2.0](https://github.com/dry-rb/dry-view/compare/v0.1.1...v0.2.0)
 
-- Will render templates using any Tilt-supported engine, based on the template's final file extension (e.g. `hello.html.slim` will use Slim). For thread-safety, be sure to explicitly require any engine gems you intend to use. (timriley)
-- `expose` (and `expose_private`) `Dry::View::Controller` class methods allow you to more easily declare and prepare the data for your template (timriley)
-- Added `Dry::View::Scope`, which is the scope used for rendering templates. This includes the data from the exposures along with the context object (timriley)
+## 0.1.1 2016-07-07
 
-# 0.1.1 / 2016-07-07
 
 ### Changed
 
@@ -83,12 +205,15 @@ This release is a major reorientation for dry-view, and it should allow for more
 - Render template content first, before passing that content to the layout. This makes "content_for"-style behaviours possible, where the template stores some data that the layout can then use later (timriley)
 - Configure default template encoding to be UTF-8, fixing some issues with template rendering on deployed sites (gotar)
 
-# 0.1.0 / 2016-03-28
+[Compare v0.1.0...v0.1.1](https://github.com/dry-rb/dry-view/compare/v0.1.0...v0.1.1)
+
+## 0.1.0 2016-03-28
+
 
 ### Added
 
-– `Dry::View::Layout` supports multiple view template formats. Configure format/engine pairs (e.g. `{html: :slim, text: :erb}`) on the `formats` setting. The first format becomes the default. Request specific formats when calling the view, e.g. `my_view.call(format: :text)`.
+- – `Dry::View::Layout` supports multiple view template formats. Configure format/engine pairs (e.g. `{html: :slim, text: :erb}`) on the `formats` setting. The first format becomes the default. Request specific formats when calling the view, e.g. `my_view.call(format: :text)`.
 
 ### Changed
 
-– Extracted from rodakase and renamed to dry-view. `Rodakase::View` is now `Dry::View`.
+- – Extracted from rodakase and renamed to dry-view. `Rodakase::View` is now `Dry::View`.

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 dry-rb team
+
+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

@@ -1,21 +1,29 @@
-[gitter]: https://gitter.im/dry-rb/chat
 [gem]: https://rubygems.org/gems/dry-view
-[travis]: https://travis-ci.org/dry-rb/dry-view
-[inch]: http://inch-ci.org/github/dry-rb/dry-view
+[actions]: https://github.com/dry-rb/dry-view/actions
+[codacy]: https://www.codacy.com/gh/dry-rb/dry-view
+[chat]: https://dry-rb.zulipchat.com
+[inchpages]: http://inch-ci.org/github/dry-rb/dry-view
 
-# dry-view [![Join the Gitter chat](https://badges.gitter.im/Join%20Chat.svg)][gitter]
+# dry-view [![Join the chat at https://dry-rb.zulipchat.com](https://img.shields.io/badge/dry--rb-join%20chat-%23346b7a.svg)][chat]
 
-[![Gem Version](https://img.shields.io/gem/v/dry-view.svg)][gem]
-[![Build Status](https://img.shields.io/travis/dry-rb/dry-view.svg)][travis]
-[![Maintainability](https://api.codeclimate.com/v1/badges/de81a8026a2e7f64e4df/maintainability)](https://codeclimate.com/github/dry-rb/dry-view/maintainability)
-[![Test Coverage](https://api.codeclimate.com/v1/badges/de81a8026a2e7f64e4df/test_coverage)](https://codeclimate.com/github/dry-rb/dry-view/test_coverage)
-[![API Documentation Coverage](http://inch-ci.org/github/dry-rb/dry-view.svg)][inch]
+[![Gem Version](https://badge.fury.io/rb/dry-view.svg)][gem]
+[![CI Status](https://github.com/dry-rb/dry-view/workflows/ci/badge.svg)][actions]
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/fe8a45d76d8b45f6a680a29c48b43a99)][codacy]
+[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/fe8a45d76d8b45f6a680a29c48b43a99)][codacy]
+[![Inline docs](http://inch-ci.org/github/dry-rb/dry-view.svg?branch=master)][inchpages]
 
+## Links
 
-A simple, standalone view rendering system built around functional view
-controllers and templates. dry-view allows you to model your views as stateless
-transformations, accepting user input and returning your rendered view.
+* [User documentation](http://dry-rb.org/gems/dry-view)
+* [API documentation](http://rubydoc.info/gems/dry-view)
 
-## Links
+## Supported Ruby versions
+
+This library officially supports the following Ruby versions:
+
+* MRI >= `2.5`
+* jruby >= `9.2`
+
+## License
 
-* [Documentation](http://dry-rb.org/gems/dry-view)
+See `LICENSE` file.

data/dry-view.gemspec

@@ -1,32 +1,40 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+# this file is managed by dry-rb/devtools project
+
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'dry/view/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "dry-view"
-  spec.version       = Dry::View::VERSION
-  spec.authors       = ["Piotr Solnica", "Tim Riley"]
-  spec.email         = ["piotr.solnica@gmail.com", "tim@icelab.com.au"]
-  spec.summary       = "Functional view rendering system"
+  spec.name          = 'dry-view'
+  spec.authors       = ["Tim Riley", "Piotr Solnica"]
+  spec.email         = ["tim@icelab.com.au", "piotr.solnica@gmail.com"]
+  spec.license       = 'MIT'
+  spec.version       = Dry::View::VERSION.dup
+
+  spec.summary       = "A complete, standalone view rendering system that gives you everything you need to write well-factored view code"
   spec.description   = spec.summary
-  spec.homepage      = "https://github.com/dry-rb/dry-view"
-  spec.license       = "MIT"
+  spec.homepage      = 'https://dry-rb.org/gems/dry-view'
+  spec.files         = Dir["CHANGELOG.md", "LICENSE", "README.md", "dry-view.gemspec", "lib/**/*"]
+  spec.bindir        = 'bin'
+  spec.executables   = []
+  spec.require_paths = ['lib']
 
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  spec.metadata['changelog_uri']     = 'https://github.com/dry-rb/dry-view/blob/master/CHANGELOG.md'
+  spec.metadata['source_code_uri']   = 'https://github.com/dry-rb/dry-view'
+  spec.metadata['bug_tracker_uri']   = 'https://github.com/dry-rb/dry-view/issues'
 
-  spec.required_ruby_version = '>= 2.2.0'
+  spec.required_ruby_version = ">= 2.5.0"
 
-  spec.add_runtime_dependency "tilt", "~> 2.0"
-  spec.add_runtime_dependency "dry-core", "~> 0.2"
+  # to update dependencies edit project.yml
+  spec.add_runtime_dependency "concurrent-ruby", "~> 1.0"
   spec.add_runtime_dependency "dry-configurable", "~> 0.1"
-  spec.add_runtime_dependency "dry-equalizer", "~> 0.2"
+  spec.add_runtime_dependency "dry-core", "~> 0.5", ">= 0.5"
+  spec.add_runtime_dependency "dry-inflector", "~> 0.1"
+  spec.add_runtime_dependency "tilt", "~> 2.0", ">= 2.0.6"
 
-  spec.add_development_dependency "bundler", "~> 1.7"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.1"
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
 end

data/lib/dry-view.rb

@@ -1 +1,3 @@
-require 'dry/view'
+# frozen_string_literal: true
+
+require "dry/view"

data/lib/dry/view.rb

@@ -1,2 +1,514 @@
-require 'dry/view/renderer'
-require 'dry/view/controller'
+# frozen_string_literal: true
+
+require "dry/configurable"
+require "dry/core/cache"
+require "dry/core/equalizer"
+require "dry/inflector"
+
+require_relative "view/context"
+require_relative "view/exposures"
+require_relative "view/errors"
+require_relative "view/part_builder"
+require_relative "view/path"
+require_relative "view/render_environment"
+require_relative "view/rendered"
+require_relative "view/renderer"
+require_relative "view/scope_builder"
+
+# A collection of next-generation Ruby libraries, helping you to write clear,
+# flexible, and more maintainable Ruby code. Each dry-rb gem fulfils a common
+# task, and together they make a powerful platform for any kind of Ruby
+# application.
+module Dry
+  # A standalone, template-based view rendering system that offers everything
+  # you need to write well-factored view code.
+  #
+  # This represents a single view, holding the configuration and exposures
+  # necessary for rendering its template.
+  #
+  # @abstract Subclass this and provide your own configuration and exposures to
+  #   define your own view (along with a custom `#initialize` if you wish to
+  #   inject dependencies into your subclass)
+  #
+  # @see https://dry-rb.org/gems/dry-view/
+  #
+  # @api public
+  class View
+    # @api private
+    DEFAULT_RENDERER_OPTIONS = {default_encoding: "utf-8"}.freeze
+
+    include Dry::Equalizer(:config, :exposures)
+
+    extend Dry::Core::Cache
+
+    extend Dry::Configurable
+
+    # @!group Configuration
+
+    # @overload config.paths=(paths)
+    #   Set an array of directories that will be searched for all templates
+    #   (templates, partials, and layouts).
+    #
+    #   These will be converted into Path objects and used for template lookup
+    #   when rendering.
+    #
+    #   This is a **required setting**.
+    #
+    #   @param paths [String, Path, Array<String, Path>] the paths
+    #
+    #   @api public
+    # @!scope class
+    setting :paths do |paths|
+      Array(paths).map { |path| Path[path] }
+    end
+
+    # @overload config.template=(name)
+    #   Set the name of the template for rendering this view. Template name
+    #   should be relative to the configured `paths`.
+    #
+    #   This is a **required setting**.
+    #
+    #   @param name [String] template name
+    #   @api public
+    # @!scope class
+    setting :template
+
+    # @overload config.layout=(name)
+    #   Set the name of the layout to render templates within. Layouts will be
+    #   looked up within the configured `layouts_dir`, within the configured
+    #   `paths`.
+    #
+    #   A false or nil value will use no layout. Defaults to `nil`.
+    #
+    #   @param name [String, FalseClass, nil] layout name, or false to indicate no layout
+    #   @api public
+    # @!scope class
+    setting :layout, false
+
+    # @overload config.layouts_dir=(dir)
+    #   Set the name of the directory (within the configured `paths`) holding
+    #   the layouts. Defaults to `"layouts"`
+    #
+    #   @param dir [String] directory name
+    #   @api public
+    # @!scope class
+    setting :layouts_dir, "layouts"
+
+    # @overload config.scope=(scope_class)
+    #   Set the scope class to use when rendering the view's template.
+    #
+    #   Configuring a custom scope class allows you to provide extra behaviour
+    #   (alongside exposures) to the template.
+    #
+    #   @see https://dry-rb.org/gems/dry-view/scopes/
+    #
+    #   @param scope_class [Class] scope class (inheriting from `Dry::View::Scope`)
+    #   @api public
+    # @!scope class
+    setting :scope
+
+    # @overload config.default_context=(context)
+    #   Set the default context object to use when rendering. This will be used
+    #   unless another context object is applied at render-time to `View#call`
+    #
+    #   Defaults to a frozen instance of `Dry::View::Context`.
+    #
+    #   @see View#call
+    #
+    #   @param context [Dry::View::Context] context object
+    #   @api public
+    # @!scope class
+    setting :default_context, Context.new.freeze
+
+    # @overload config.default_format=(format)
+    #   Set the default format to use when rendering.
+    #
+    #   Defaults to `:html`.
+    #
+    #   @param format [Symbol]
+    #   @api public
+    # @!scope class
+    setting :default_format, :html
+
+    # @overload config.scope_namespace=(namespace)
+    #   Set a namespace that will be searched when building scope classes.
+    #
+    #   @param namespace [Module, Class]
+    #
+    #   @see Scope
+    #
+    #   @api public
+    # @!scope class
+    setting :part_namespace
+
+    # @overload config.part_builder=(part_builder)
+    #   Set a custom part builder class
+    #
+    #   @see https://dry-rb.org/gems/dry-view/parts/
+    #
+    #   @param part_builder [Class]
+    #   @api public
+    # @!scope class
+    setting :part_builder, PartBuilder
+
+    # @overload config.scope_namespace=(namespace)
+    #   Set a namespace that will be searched when building scope classes.
+    #
+    #   @param namespace [Module, Class]
+    #
+    #   @see Scope
+    #
+    #   @api public
+    # @!scope class
+    setting :scope_namespace
+
+    # @overload config.scope_builder=(scope_builder)
+    #   Set a custom scope builder class
+    #
+    #   @see https://dry-rb.org/gems/dry-view/scopes/
+    #
+    #   @param scope_builder [Class]
+    #   @api public
+    # @!scope class
+    setting :scope_builder, ScopeBuilder
+
+    # @overload config.inflector=(inflector)
+    #   Set an inflector to provide to the part_builder and scope_builder.
+    #
+    #   Defaults to `Dry::Inflector.new`.
+    #
+    #   @param inflector
+    #   @api public
+    # @!scope class
+    setting :inflector, Dry::Inflector.new
+
+    # @overload config.renderer_options=(options)
+    #   A hash of options to pass to the template engine. Template engines are
+    #   provided by Tilt; see Tilt's documentation for what options your
+    #   template engine may support.
+    #
+    #   Defaults to `{default_encoding: "utf-8"}`. Any options passed will be
+    #   merged onto the defaults.
+    #
+    #   @see https://github.com/rtomayko/tilt
+    #
+    #   @param options [Hash] renderer options
+    #   @api public
+    # @!scope class
+    setting :renderer_options, DEFAULT_RENDERER_OPTIONS do |options|
+      DEFAULT_RENDERER_OPTIONS.merge(options.to_h).freeze
+    end
+
+    # @overload config.renderer_engine_mapping=(mapping)
+    #   A hash specifying the (Tilt-compatible) template engine class to use
+    #   for a given format. Template engine detection is automatic based on
+    #   format; use this setting only if you want to force a non-preferred
+    #   engine.
+    #
+    #   @example
+    #     config.renderer_engine_mapping = {erb: Tilt::ErubiTemplate}
+    #
+    #   @see https://github.com/rtomayko/tilt
+    #
+    #   @param mapping [Hash<Symbol, Class>] engine mapping
+    #   @api public
+    # @!scope class
+    setting :renderer_engine_mapping
+
+    # @!endgroup
+
+    # @api private
+    def self.inherited(klass)
+      super
+      exposures.each do |name, exposure|
+        klass.exposures.import(name, exposure)
+      end
+    end
+
+    # @!group Exposures
+
+    # @!macro [new] exposure_options
+    #   @param options [Hash] the exposure's options
+    #   @option options [Boolean] :layout expose this value to the layout (defaults to false)
+    #   @option options [Boolean] :decorate decorate this value in a matching Part (defaults to
+    #     true)
+    #   @option options [Symbol, Class] :as an alternative name or class to use when finding a
+    #     matching Part
+
+    # @overload expose(name, **options, &block)
+    #   Define a value to be passed to the template. The return value of the
+    #   block will be decorated by a matching Part and passed to the template.
+    #
+    #   The block will be evaluated with the view instance as its `self`. The
+    #   block's parameters will determine what it is given:
+    #
+    #   - To receive other exposure values, provide positional parameters
+    #     matching the exposure names. These exposures will already by decorated
+    #     by their Parts.
+    #   - To receive the view's input arguments (whatever is passed to
+    #     `View#call`), provide matching keyword parameters. You can provide
+    #     default values for these parameters to make the corresponding input
+    #     keys optional
+    #   - To receive the Context object, provide a `context:` keyword parameter
+    #   - To receive the view's input arguments in their entirety, provide a
+    #     keywords splat parameter (i.e. `**input`)
+    #
+    #   @example Accessing input arguments
+    #     expose :article do |slug:|
+    #       article_repo.find_by_slug(slug)
+    #     end
+    #
+    #   @example Accessing other exposures
+    #     expose :articles do
+    #       article_repo.listing
+    #     end
+    #
+    #     expose :featured_articles do |articles|
+    #       articles.select(&:featured?)
+    #     end
+    #
+    #   @param name [Symbol] name for the exposure
+    #   @macro exposure_options
+    #
+    # @overload expose(name, **options)
+    #   Define a value to be passed to the template, provided by an instance
+    #   method matching the name. The method's return value will be decorated by
+    #   a matching Part and passed to the template.
+    #
+    #   The method's parameters will determine what it is given:
+    #
+    #   - To receive other exposure values, provide positional parameters
+    #     matching the exposure names. These exposures will already by decorated
+    #     by their Parts.
+    #   - To receive the view's input arguments (whatever is passed to
+    #     `View#call`), provide matching keyword parameters. You can provide
+    #     default values for these parameters to make the corresponding input
+    #     keys optional
+    #   - To receive the Context object, provide a `context:` keyword parameter
+    #   - To receive the view's input arguments in their entirey, provide a
+    #     keywords splat parameter (i.e. `**input`)
+    #
+    #   @example Accessing input arguments
+    #     expose :article
+    #
+    #     def article(slug:)
+    #       article_repo.find_by_slug(slug)
+    #     end
+    #
+    #   @example Accessing other exposures
+    #     expose :articles
+    #     expose :featured_articles
+    #
+    #     def articles
+    #       article_repo.listing
+    #     end
+    #
+    #     def featured_articles
+    #       articles.select(&:featured?)
+    #     end
+    #
+    #   @param name [Symbol] name for the exposure
+    #   @macro exposure_options
+    #
+    # @overload expose(name, **options)
+    #   Define a single value to pass through from the input data (when there is
+    #   no instance method matching the `name`). This value will be decorated by
+    #   a matching Part and passed to the template.
+    #
+    #   @param name [Symbol] name for the exposure
+    #   @macro exposure_options
+    #   @option options [Boolean] :default a default value to provide if there is no matching
+    #     input data
+    #
+    # @overload expose(*names, **options)
+    #   Define multiple values to pass through from the input data (when there
+    #   is no instance methods matching their names). These values will be
+    #   decorated by matching Parts and passed through to the template.
+    #
+    #   The provided options will be applied to all the exposures.
+    #
+    #   @param names [Symbol] names for the exposures
+    #   @macro exposure_options
+    #   @option options [Boolean] :default a default value to provide if there is no matching
+    #     input data
+    #
+    # @see https://dry-rb.org/gems/dry-view/exposures/
+    #
+    # @api public
+    def self.expose(*names, **options, &block)
+      if names.length == 1
+        exposures.add(names.first, block, **options)
+      else
+        names.each do |name|
+          exposures.add(name, **options)
+        end
+      end
+    end
+
+    # @api public
+    def self.private_expose(*names, **options, &block)
+      expose(*names, **options, private: true, &block)
+    end
+
+    # Returns the defined exposures. These are unbound, since bound exposures
+    # are only created when initializing a View instance.
+    #
+    # @return [Exposures]
+    # @api private
+    def self.exposures
+      @exposures ||= Exposures.new
+    end
+
+    # @!endgroup
+
+    # @!group Render environment
+
+    # Returns a render environment for the view and the given options. This
+    # environment isn't chdir'ed into any particular directory.
+    #
+    # @param format [Symbol] template format to use (defaults to the `default_format` setting)
+    # @param context [Context] context object to use (defaults to the `default_context` setting)
+    #
+    # @see View.template_env render environment for the view's template
+    # @see View.layout_env render environment for the view's layout
+    #
+    # @return [RenderEnvironment]
+    # @api public
+    def self.render_env(format: config.default_format, context: config.default_context)
+      RenderEnvironment.prepare(renderer(format), config, context)
+    end
+
+    # @overload template_env(format: config.default_format, context: config.default_context)
+    #   Returns a render environment for the view and the given options,
+    #   chdir'ed into the view's template directory. This is the environment
+    #   used when rendering the template, and is useful to to fetch
+    #   independently when unit testing Parts and Scopes.
+    #
+    #   @param format [Symbol] template format to use (defaults to the `default_format` setting)
+    #   @param context [Context] context object to use (defaults to the `default_context` setting)
+    #
+    #   @return [RenderEnvironment]
+    #   @api public
+    def self.template_env(**args)
+      render_env(**args).chdir(config.template)
+    end
+
+    # @overload layout_env(format: config.default_format, context: config.default_context)
+    #   Returns a render environment for the view and the given options,
+    #   chdir'ed into the view's layout directory. This is the environment used
+    #   when rendering the view's layout.
+    #
+    #   @param format [Symbol] template format to use (defaults to the `default_format` setting)
+    #   @param context [Context] context object to use (defaults to the `default_context` setting)
+    #
+    #   @return [RenderEnvironment] @api public
+    def self.layout_env(**args)
+      render_env(**args).chdir(layout_path)
+    end
+
+    # Returns renderer for the view and provided format
+    #
+    # @api private
+    def self.renderer(format)
+      fetch_or_store(:renderer, config, format) {
+        Renderer.new(
+          config.paths,
+          format: format,
+          engine_mapping: config.renderer_engine_mapping,
+          **config.renderer_options
+        )
+      }
+    end
+
+    # @api private
+    def self.layout_path
+      File.join(config.layouts_dir, config.layout)
+    end
+
+    # @!endgroup
+
+    # The view's bound exposures
+    #
+    # @return [Exposures]
+    # @api private
+    attr_reader :exposures
+
+    # Returns an instance of the view. This binds the defined exposures to the
+    # view instance.
+    #
+    # Subclasses can define their own `#initialize` to accept injected
+    # dependencies, but must call `super()` to ensure the standard view
+    # initialization can proceed.
+    #
+    # @api public
+    def initialize
+      @exposures = self.class.exposures.bind(self)
+    end
+
+    # The view's configuration
+    #
+    # @api private
+    def config
+      self.class.config
+    end
+
+    # Render the view
+    #
+    # @param format [Symbol] template format to use
+    # @param context [Context] context object to use
+    # @param input input data for preparing exposure values
+    #
+    # @return [Rendered] rendered view object
+    # @api public
+    def call(format: config.default_format, context: config.default_context, **input)
+      ensure_config
+
+      env = self.class.render_env(format: format, context: context)
+      template_env = self.class.template_env(format: format, context: context)
+
+      locals = locals(template_env, input)
+      output = env.template(config.template, template_env.scope(config.scope, locals))
+
+      if layout?
+        layout_env = self.class.layout_env(format: format, context: context)
+        output = env.template(
+          self.class.layout_path,
+          layout_env.scope(config.scope, layout_locals(locals))
+        ) { output }
+      end
+
+      Rendered.new(output: output, locals: locals)
+    end
+
+    private
+
+    # @api private
+    def ensure_config
+      raise UndefinedConfigError, :paths unless Array(config.paths).any?
+      raise UndefinedConfigError, :template unless config.template
+    end
+
+    # @api private
+    def locals(render_env, input)
+      exposures.(context: render_env.context, **input) do |value, exposure|
+        if exposure.decorate? && value
+          render_env.part(exposure.name, value, **exposure.options)
+        else
+          value
+        end
+      end
+    end
+
+    # @api private
+    def layout_locals(locals)
+      locals.each_with_object({}) do |(key, value), layout_locals|
+        layout_locals[key] = value if exposures[key].for_layout?
+      end
+    end
+
+    # @api private
+    def layout?
+      !!config.layout # rubocop:disable Style/DoubleNegation
+    end
+  end
+end