GitAuto: [FEATURE] Add MVC Capability to Pancake Toolkit

docs/user-guide/mvc-usage.md

@@ -0,0 +1,60 @@
+# MVC Usage Guide
+
+This document provides an overview of how to use the new MVC components in the Pancake toolkit.
+
+## BaseController
+
+The `BaseController` class provides common functionality for rendering views and redirecting URLs.
+
+### Example
+
+```php
+use Pancake\MVC\BaseController;
+
+$templateEngine = new YourTemplateEngine();
+$controller = new BaseController($templateEngine);
+
+$controller->render('home', ['key' => 'value']);
+$controller->redirect('http://example.com');
+```
+
+## ApiController
+
+The `ApiController` class extends `BaseController` and is designed for API responses, rendering JSON.
+
+### Example
+
+```php
+use Pancake\MVC\ApiController;
+
+$controller = new ApiController(null);
+$controller->render(['key' => 'value']);
+```
+
+## Router
+
+The `Router` class manages route registration and dispatching.
+
+### Example
+
+```php
+use Pancake\MVC\Router;
+
+$router = new Router();
+$router->add('GET', '/home', 'HomeController', 'index');
+$router->dispatch('GET', '/home');
+```
+
+## DIContainer Integration
+
+The `DIContainer` is used to manage dependencies for controllers and the template engine.
+
+### Example
+
+```php
+$container = new Pancake\DIContainer();
+$controller = $container->resolve('BaseController');
+$controller->render('home', ['key' => 'value']);
+```
+
+```

src/Pancake/DIContainer.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Pancake;
+
+class DIContainer
+{
+    private $bindings = [];
+
+    public function registerSingleton($name, $resolver)
+    {
+        $this->bindings[$name] = ['resolver' => $resolver, 'shared' => true, 'instance' => null];
+    }
+
+    public function registerTransient($name, $resolver)
+    {
+        $this->bindings[$name] = ['resolver' => $resolver, 'shared' => false];
+    }
+
+    public function resolve($name)
+    {
+        if (!isset($this->bindings[$name])) {
+            throw new \Exception("No binding registered for {$name}");
+        }
+
+        $binding = $this->bindings[$name];
+
+        if ($binding['shared']) {
+            if ($binding['instance'] === null) {
+                $binding['instance'] = $binding['resolver']();
+            }
+            return $binding['instance'];
+        }
+
+        return $binding['resolver']();
+    }
+}
+
+// Registering components
+$container = new DIContainer();
+$container->registerSingleton('templateEngine', function () {
+    return new DefaultTemplateEngine(); // Assume DefaultTemplateEngine is defined elsewhere
+});
+$container->registerTransient('BaseController', function () use ($container) {
+    return new MVC\BaseController($container->resolve('templateEngine'));
+});
+$container->registerTransient('ApiController', function () use ($container) {
+    return new MVC\ApiController($container->resolve('templateEngine'));
+});

src/Pancake/MVC/ApiController.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Pancake\MVC;
+
+class ApiController extends BaseController
+{
+    public function render($data = [])
+    {
+        header('Content-Type: application/json');
+        echo json_encode($data);
+    }
+}

src/Pancake/MVC/BaseController.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Pancake\MVC;
+
+class BaseController
+{
+    protected $templateEngine;
+
+    public function __construct($templateEngine)
+    {
+        $this->templateEngine = $templateEngine;
+    }
+
+    public function render($view, $data = [])
+    {
+        echo $this->templateEngine->render($view, $data);
+    }
+
+    public function redirect($url)
+    {
+        header('Location: ' . $url);
+        exit();
+    }
+}

src/Pancake/MVC/Router.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Pancake\MVC;
+
+class Router
+{
+    private $routes = [];
+
+    public function add($method, $uri, $controller, $action)
+    {
+        $this->routes[] = compact('method', 'uri', 'controller', 'action');
+    }
+
+    public function dispatch($method, $uri)
+    {
+        foreach ($this->routes as $route) {
+            if ($route['method'] === $method && $route['uri'] === $uri) {
+                $controller = new $route['controller']();
+                $action = $route['action'];
+                return $controller->$action();
+            }
+        }
+        // Handle 404
+        header("HTTP/1.0 404 Not Found");
+        echo "404 Not Found";
+    }
+}

tests/MVC/ApiControllerTest.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace GuiBranco\Pancake\Tests\MVC;
+
+use PHPUnit\Framework\TestCase;
+use Pancake\MVC\ApiController;
+
+class ApiControllerTest extends TestCase
+{
+    public function testRenderJson()
+    {
+        $controller = new ApiController(null);
+
+        $this->expectOutputString('{"key":"value"}');
+        $controller->render(['key' => 'value']);
+    }
+}

tests/MVC/BaseControllerTest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace GuiBranco\Pancake\Tests\MVC;
+
+use PHPUnit\Framework\TestCase;
+use Pancake\MVC\BaseController;
+
+class BaseControllerTest extends TestCase
+{
+    public function testRender()
+    {
+        $templateEngine = $this->createMock(TemplateEngine::class);
+        $templateEngine->expects($this->once())
+                       ->method('render')
+                       ->with('view', ['key' => 'value'])
+                       ->willReturn('rendered view');
+
+        $controller = new BaseController($templateEngine);
+        $this->expectOutputString('rendered view');
+        $controller->render('view', ['key' => 'value']);
+    }
+
+    public function testRedirect()
+    {
+        $controller = new BaseController(null);
+
+        $this->expectException(\PHPUnit\Framework\Error\Warning::class);
+        $this->expectExceptionMessage('Cannot modify header information');
+
+        $controller->redirect('http://example.com');
+    }
+}

tests/MVC/RouterTest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace GuiBranco\Pancake\Tests\MVC;
+
+use PHPUnit\Framework\TestCase;
+use Pancake\MVC\Router;
+
+class RouterTest extends TestCase
+{
+    public function testAddAndDispatch()
+    {
+        $router = new Router();
+
+        $mockController = $this->createMock(\stdClass::class);
+        $mockController->expects($this->once())
+                       ->method('testAction')
+                       ->willReturn('action executed');
+
+        $router->add('GET', '/test', get_class($mockController), 'testAction');
+
+        $this->expectOutputString('action executed');
+        $router->dispatch('GET', '/test');
+    }
+
+    public function testDispatchNotFound()
+    {
+        $router = new Router();
+
+        $this->expectOutputString('404 Not Found');
+        $router->dispatch('GET', '/non-existent');
+    }
+}