Merge pull request #18 from victorwelling/master

Changes for v2.0

Author: victorwelling

CHANGELOG.md

@@ -1,6 +1,24 @@
 # Changelog
 All notable changes to Shoot will be documented in this file.
 
+## [2.0.0] - 2019-03-04
+### Added
+- Documentation on nesting presentation models and the `optional` tag.
+- An `Installer` class which sets up Shoot for an instance of Twig.
+
+### Changed
+- Shoot now requires PHP 7.2.
+- The Twig dependency has been bumped to v2.6.
+- PHPUnit has been bumped to v8.0, and all tests have been updated accordingly.
+- The `SuppressionMiddleware` is no longer enabled by the default. You'll have to pass it to the `Pipeline` constructor
+along with any other middleware you use.
+- The `LoggingMiddleware` now also logs errors. Kind of odd it did not do that before.
+
+### Fixed
+- The optional tag would still output any contents from before the exception was thrown. This is now fixed.
+- Models now work as expected when using extends, embed and blocks – removing what was previously a limitation of Shoot.
+
+
 ## [1.0.0] - 2018-08-27
 ### Added
 - The `optional` tag was added. This allows runtime exceptions to be suppressed so parts which are not essential to the
@@ -14,7 +32,7 @@ page can be left out in case of failure.
 - The `getPresenter` method of `HasPresenterInterface` was renamed to `getPresenterName` as it more accurately describes
 its purpose. 
 - `HasDataTrait` has been moved to a `Utilities` namespace.
-- The Twig dependency has been bumped to v2.5
+- The Twig dependency has been bumped to v2.5.
 - Lots of housekeeping in code and documentation.
 
 ### Deprecated

README.md

@@ -7,7 +7,7 @@ Shoot is an extension for [Twig][link-twig], a popular template engine for PHP.
 your templates more manageable. Think of Shoot as a DI container for template data. 
 
 ## Prerequisites
-Shoot assumes you're using PHP 7 and Twig to render templates in a [PSR-7][link-psr7] HTTP context. It also needs a
+Shoot assumes you're using PHP 7.2 and Twig to render templates in a [PSR-7][link-psr7] HTTP context. It also needs a
 [PSR-11][link-psr11] compatible DI container.
 
 Although not a requirement, a framework with support for [PSR-15][link-psr15] HTTP middleware does make your life a
@@ -39,7 +39,7 @@ rendering your templates and Shoot loads the data as needed. Enjoy this ASCII il
 ```
 
 For this to work, Shoot introduces a few concepts:
-* _Presentation models_ – Think of them as data contracts for your templates, ie. _Views_.
+* _Presentation models_ – Think of them as data contracts for your templates, i.e. _Views_.
 * _Presenters_ – These do the actual work. A presenter is coupled to a specific presentation model, and loads just the
 data it needs. These presenters are automatically invoked by Shoot as your templates are rendered.
 * _Middleware_ – As each template is rendered, it passes through Shoot's middleware pipeline. Invoking the presenters is

src/Extension.php

@@ -40,7 +40,7 @@ public function __construct(Pipeline $pipeline)
      *
      * @internal
      */
-    public function process(View $view)
+    public function process(View $view): void
     {
         $this->pipeline->process($view);
     }

src/Middleware/InspectorMiddleware.php

@@ -40,7 +40,7 @@ public function process(View $view, ServerRequestInterface $request, callable $n
      *
      * @return void
      */
-    private function value($value, string $label = '')
+    private function value($value, string $label = ''): void
     {
         if (is_scalar($value)) {
             $this->scalar($value, $label);
@@ -57,7 +57,7 @@ private function value($value, string $label = '')
      *
      * @return void
      */
-    private function scalar($scalar, string $label = '')
+    private function scalar($scalar, string $label = ''): void
     {
         if (is_bool($scalar)) {
             $scalar = $scalar ? 'true' : 'false';
@@ -80,7 +80,7 @@ private function scalar($scalar, string $label = '')
      *
      * @return void
      */
-    private function iterable(array $iterable, string $label = '')
+    private function iterable(array $iterable, string $label = ''): void
     {
         if ($label === '') {
             $label = '...';
@@ -105,7 +105,7 @@ private function iterable(array $iterable, string $label = '')
      *
      * @return void
      */
-    private function object($object, string $label = '')
+    private function object($object, string $label = ''): void
     {
         if ($object instanceof PresentationModel) {
             $this->presentationModel($object, $label);
@@ -121,7 +121,7 @@ private function object($object, string $label = '')
      *
      * @return void
      */
-    private function view(View $view)
+    private function view(View $view): void
     {
         $this->group($view->getName(), false);
         $this->presentationModel($view->getPresentationModel(), 'presentationModel');
@@ -134,7 +134,7 @@ private function view(View $view)
      *
      * @return void
      */
-    private function presentationModel(PresentationModel $presentationModel, string $label = '')
+    private function presentationModel(PresentationModel $presentationModel, string $label = ''): void
     {
         if ($label === '') {
             $label = $presentationModel->getName();
@@ -167,7 +167,7 @@ private function escape(string $string): string
      *
      * @return void
      */
-    private function group(string $label, bool $collapsed = true)
+    private function group(string $label, bool $collapsed = true): void
     {
         $label = $this->escape($label);
 
@@ -181,23 +181,23 @@ private function group(string $label, bool $collapsed = true)
     /**
      * @return void
      */
-    private function groupEnd()
+    private function groupEnd(): void
     {
         echo 'console.groupEnd();';
     }
 
     /**
      * @return void
      */
-    private function script()
+    private function script(): void
     {
         echo '<script>';
     }
 
     /**
      * @return void
      */
-    private function scriptEnd()
+    private function scriptEnd(): void
     {
         echo '</script>';
     }

src/Pipeline.php

@@ -26,8 +26,6 @@ final class Pipeline
      */
     public function __construct(array $middleware = [])
     {
-        $middleware = $this->addSuppressionMiddleware($middleware);
-
         $this->middleware = $this->chainMiddleware($middleware);
     }
 
@@ -58,7 +56,7 @@ public function withRequest(ServerRequestInterface $request, callable $callback)
      *
      * @internal
      */
-    public function process(View $view)
+    public function process(View $view): void
     {
         if ($this->request === null) {
             throw new MissingRequestException('Cannot process a view without a request set. This method should be called from the callback passed to Pipeline::withRequest');
@@ -67,26 +65,6 @@ public function process(View $view)
         call_user_func($this->middleware, $view);
     }
 
-    /**
-     * @param MiddlewareInterface[] $middleware
-     *
-     * @return MiddlewareInterface[]
-     *
-     * @deprecated 2.0.0 Should not have been default behaviour. Will be removed as of the next major release.
-     */
-    private function addSuppressionMiddleware(array $middleware): array
-    {
-        foreach ($middleware as $instance) {
-            if ($instance instanceof SuppressionMiddleware) {
-                return $middleware;
-            }
-        }
-
-        $middleware[] = new SuppressionMiddleware();
-
-        return $middleware;
-    }
-
     /**
      * @param MiddlewareInterface[] $middleware
      *

src/PresentationModel.php

@@ -72,7 +72,7 @@ final public function withVariables(array $variables): self
      *
      * @return void
      */
-    private function setVariables(array $variables)
+    private function setVariables(array $variables): void
     {
         foreach ($variables as $variable => $value) {
             if ($this->variableExists($variable)) {

src/Twig/Node/DisplayEndNode.php

@@ -38,7 +38,7 @@ public function __construct(ModuleNode $module)
      *
      * @return void
      */
-    public function compile(Compiler $compiler)
+    public function compile(Compiler $compiler): void
     {
         if ($this->module->hasAttribute('is_embedded')) {
             return;

src/Twig/Node/DisplayStartNode.php

@@ -41,7 +41,7 @@ public function __construct(ModuleNode $module, FindPresentationModelInterface $
      *
      * @return void
      */
-    public function compile(Compiler $compiler)
+    public function compile(Compiler $compiler): void
     {
         if ($this->module->hasAttribute('is_embedded')) {
             return;

src/Twig/Node/OptionalNode.php

@@ -30,7 +30,7 @@ public function __construct(Node $body, int $lineNumber, string $tag)
      *
      * @return void
      */
-    public function compile(Compiler $compiler)
+    public function compile(Compiler $compiler): void
     {
         $runtimeErrorClass = RuntimeError::class;
         $suppressedExceptionClass = SuppressedException::class;

src/Twig/NodeVisitor/ModelNodeVisitor.php

@@ -94,7 +94,7 @@ public function getPriority(): int
      *
      * @throws LogicException
      */
-    private function assign(string $view, string $presentationModel)
+    private function assign(string $view, string $presentationModel): void
     {
         if (isset($this->presentationModels[$view])) {
             throw new ModelAlreadyAssignedException("A presentation model has already been assigned to {$view}");