dry-view 0.5.3 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c234898af572e4ebd4b6717f0ba9519f2b4feda8a6d7b2133c00ee8cea2ac7a
-  data.tar.gz: 6f086379dad341a18fbf4f68b3b6edde81cdcdf30e38c859aa5ba86556c56ae7
+  metadata.gz: 4d0cd65b1329feef3497caadc8f41521850546d9c60aa673d035215bcaaee922
+  data.tar.gz: 46e2e12a0d192dd2e7443c334bc62fdd86ff76f1aa308c1b1ac14a921e67565b
 SHA512:
-  metadata.gz: 0af32817c536bd8beeb57d63e856aeb49400579ab084a586c7d8fcdad32052d91244cf4a450a5b10243915fa652140d3389fccbd2421a04d2479767d515e5bb5
-  data.tar.gz: e6dbf82b4d90b57751a74047ffa8d9cda75986bb468a42553ab150f8c9f12458662329f0be859bc1701ce6d39e3ee1ee523abcc23d0ce928ccba106e3b9593f3
+  metadata.gz: f235921f2631c60446690342c388cc624665f21a9a1e40e979efa285bfa8fd73c3a0f4bb453931e1fc25cdc5a6201d58f42a7a4a6275a96c2f5d641f0ec23961
+  data.tar.gz: 2cc2906563bcd30b21c1034d0ffb97c395e77898b8ab7d117cdf11aa52462c7a874e05ddb66a59c600c29a31c65f7e3808fae4f447df817cdedbc255e7d0c179

data/.codeclimate.yml

@@ -0,0 +1,18 @@
+version: "2"
+plugins:
+  rubocop:
+    enabled: true
+    checks:
+      Rubocop/AllCops:
+        TargetRubyVersion: 2.2
+      Rubocop/Metrics/ClassLength:
+        Max: 150
+      Rubocop/Metrics/LineLength:
+        Max: 100
+      Rubocop/Metrics/MethodLength:
+        Max: 20
+exclude_patterns:
+  - "benchmarks/"
+  - "bin/"
+  - "examples/"
+  - "spec/"

data/.travis.yml

@@ -3,21 +3,26 @@ cache: bundler
 bundler_args: --without tools benchmarks
 before_install:
   - gem update --system
+  - gem install bundler
 script:
   - bundle exec rake
-after_success:
-    # Send coverage report from the job #1 == current MRI release
-  - '[ "${TRAVIS_JOB_NUMBER#*.}" = "1" ] && [ "$TRAVIS_BRANCH" = "master" ] && bundle exec codeclimate-test-reporter'
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+after_script:
+  - "[ -d coverage ] && ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT"
 rvm:
-  - 2.5.0
-  - 2.4.2
-  - 2.3.6
-  - jruby-9.1.10.0
+  - 2.6.0
+  - 2.5.3
+  - 2.4.5
+  - 2.3.8
+  - jruby-9.2.5.0
 notifications:
   email: false
   webhooks:
     urls:
       - https://webhooks.gitter.im/e/19098b4253a72c9796db
-    on_success: change  # options: [always|never|change] default: always
-    on_failure: always  # options: [always|never|change] default: always
-    on_start: false     # default: false
+    on_success: change # options: [always|never|change] default: always
+    on_failure: always # options: [always|never|change] default: always
+    on_start: false # default: false

data/.yardopts

@@ -0,0 +1,5 @@
+--query '@api.text != "private"'
+--markup-provider=redcarpet
+--markup=markdown
+--plugin junk
+lib/**/*.rb

data/CHANGELOG.md

@@ -1,3 +1,60 @@
+# 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])
+
+### 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])
+
+### Fixed
+
+- Preserve renderer options when chdir-ing (timriley in [889ac7b](https://github.com/dry-rb/dry-view/commit/889ac7b))
+
+[Compare v0.5.3...v0.6.0](https://github.com/dry-rb/dry-view/compare/v0.5.3...v0.6.0)
+
+[pr72]: https://github.com/dry-rb/dry-view/pull/72
+[pr80]: https://github.com/dry-rb/dry-view/pull/80
+[pr86]: https://github.com/dry-rb/dry-view/pull/86
+[pr87]: https://github.com/dry-rb/dry-view/pull/87
+[pr88]: https://github.com/dry-rb/dry-view/pull/88
+[pr89]: https://github.com/dry-rb/dry-view/pull/89
+[pr90]: https://github.com/dry-rb/dry-view/pull/90
+[pr91]: https://github.com/dry-rb/dry-view/pull/91
+[pr97]: https://github.com/dry-rb/dry-view/pull/97
+[pr98]: https://github.com/dry-rb/dry-view/pull/98
+[pr106]: https://github.com/dry-rb/dry-view/pull/106
+[pr110]: https://github.com/dry-rb/dry-view/pull/110
+[pr115]: https://github.com/dry-rb/dry-view/pull/115
+[pr116]: https://github.com/dry-rb/dry-view/pull/116
+[pr118]: https://github.com/dry-rb/dry-view/pull/118
+[pr119]: https://github.com/dry-rb/dry-view/pull/119
+
+# 0.5.4 / 2019-01-06 [YANKED 2019-01-18]
+
+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))
+
 # 0.5.3 / 2018-10-22
 
 ### Added
@@ -8,6 +65,8 @@
 
 - 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)
+
 [pr62]: https://github.com/dry-rb/dry-view/pull/62
 [pr63]: https://github.com/dry-rb/dry-view/pull/63
 
@@ -17,7 +76,7 @@
 
 - Only truthy view part attributes are decorated (timriley)
 
-[Compare v0.5.0...v0.5.1](https://github.com/dry-rb/dry-view/compare/v0.5.1...v0.5.2)
+[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
 

data/Gemfile

@@ -2,21 +2,31 @@ source 'https://rubygems.org'
 
 gemspec
 
-gem 'inflecto'
-
 group :tools do
+  gem 'hotch'
   gem 'pry-byebug', platform: :mri
 end
 
 group :test do
-  gem 'rack', '>= 1.0.0', '<= 2.0.0'
-  gem 'slim'
+  gem "rack", ">= 2.0.6"
+
+  gem "erbse"
+  gem "erubi"
+  gem "hamlit"
+  gem "hamlit-block"
+  gem 'slim', "~> 4.0"
 
   gem 'simplecov'
-  gem 'codeclimate-test-reporter'
 end
 
 group :benchmarks do
   gem 'benchmark-ips'
   gem 'actionview'
+  gem 'actionpack'
+end
+
+group :docs do
+  gem 'yard'
+  gem 'yard-junk'
+  gem 'redcarpet', platforms: :mri
 end

data/README.md

@@ -1,21 +1,46 @@
-[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
-
-# dry-view [![Join the Gitter chat](https://badges.gitter.im/Join%20Chat.svg)][gitter]
+# dry-view
 
 [![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)
+[![Maintainability](https://api.codeclimate.com/v1/badges/de81a8026a2e7f64e4df/maintainability)][maint]
+[![Test Coverage](https://api.codeclimate.com/v1/badges/de81a8026a2e7f64e4df/test_coverage)][cov]
 [![API Documentation Coverage](http://inch-ci.org/github/dry-rb/dry-view.svg)][inch]
 
-
-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.
+dry-view is a complete, standalone view rendering system that gives you
+everything you need to write well-factored view code.
 
 ## Links
 
-* [Documentation](http://dry-rb.org/gems/dry-view)
+* [Documentation][docs]
+* [API documentation][api]
+* [dry-rb website][website]
+* [Support forum][support]
+
+## Development
+
+After checking out this repo, run `bin/setup` to setup the project.
+
+Then, run `rake spec` to run the tests.
+
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome [on GitHub][repo]. For new feature
+development, we recommend having a discussion [in the forum][support] before
+beginning your work.
+
+<!-- Links -->
+[docs]: https://dry-rb.org/gems/dry-view
+[api]: https://www.rubydoc.info/github/dry-rb/dry-view
+[website]: https://dry-rb.org/
+[support]: https://discourse.dry-rb.org/
+[repo]: https://github.com/dry-rb/dry-view
+
+<!-- Badge links -->
+[gitter]: https://gitter.im/dry-rb/chat
+[gem]: https://rubygems.org/gems/dry-view
+[travis]: https://travis-ci.org/dry-rb/dry-view
+[maint]: https://codeclimate.com/github/dry-rb/dry-view/maintainability
+[cov]: https://codeclimate.com/github/dry-rb/dry-view/test_coverage
+[inch]: http://inch-ci.org/github/dry-rb/dry-view

data/bin/setup

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative "setup_helpers"
+
+Setup.execute "bundle"

data/bin/setup_helpers.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module Setup
+  module_function
+
+  def execute(cmd)
+    puts "Running #{cmd}"
+
+    status, out, err = nil
+
+    Open3.popen3(cmd) do |stdin, stdout, stderr, wait_thr|
+      _pid = wait_thr.pid
+      stdin.close
+      out = stdout.read
+      err = stderr.read
+      status = wait_thr.value
+    end
+
+    if !status.success?
+      puts "Failed to run #{cmd}"
+      puts err
+      exit 1
+    end
+  end
+end

data/dry-view.gemspec

@@ -1,4 +1,3 @@
-# coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'dry/view/version'
@@ -6,27 +5,27 @@ 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.authors       = ["Tim Riley", "Piotr Solnica"]
+  spec.email         = ["tim@icelab.com.au", "piotr.solnica@gmail.com"]
+  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.homepage      = "https://dry-rb.org/gems/dry-view"
   spec.license       = "MIT"
 
-  spec.files         = `git ls-files -z`.split("\x0")
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(benchmarks|examples|spec)/}) }
   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.required_ruby_version = '>= 2.2.0'
 
-  spec.add_runtime_dependency "tilt", "~> 2.0"
+  spec.add_runtime_dependency "tilt", "~> 2.0", ">= 2.0.6"
   spec.add_runtime_dependency "dry-core", "~> 0.2"
   spec.add_runtime_dependency "dry-configurable", "~> 0.1"
   spec.add_runtime_dependency "dry-equalizer", "~> 0.2"
+  spec.add_runtime_dependency "dry-inflector", "~> 0.1"
 
-  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "bundler"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.1"
 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,503 @@
-require 'dry/view/renderer'
-require 'dry/view/controller'
+# frozen_string_literal: true
+
+require "dry/configurable"
+require "dry/core/cache"
+require "dry/equalizer"
+require "dry/inflector"
+
+require_relative "view/context"
+require_relative "view/exposures"
+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
+    UndefinedTemplateError = Class.new(StandardError)
+
+    # @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)
+      raise UndefinedTemplateError, "no +template+ configured" unless config.template
+
+      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 = layout_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 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
+    end
+  end
+end