Merge pull request #213 from php-school/debug-logger

Debug logger

Author: AydinHassan

app/config.php

@@ -4,6 +4,7 @@
 
 use Colors\Color;
 use PhpSchool\PhpWorkshop\Listener\InitialCodeListener;
+use PhpSchool\PhpWorkshop\Logger\ConsoleLogger;
 use PhpSchool\PhpWorkshop\Logger\Logger;
 use Psr\Log\LoggerInterface;
 use function DI\create;
@@ -96,6 +97,10 @@
         $appName = $c->get('appName');
         $globalDir = $c->get('phpschoolGlobalDir');
 
+        if ($c->get('debugMode')) {
+            return new ConsoleLogger($c->get(OutputInterface::class), $c->get(Color::class));
+        }
+
         return new Logger("$globalDir/logs/$appName.log");
     },
     ExerciseDispatcher::class => function (ContainerInterface $c) {

composer.json

@@ -30,7 +30,8 @@
         "php-school/keylighter": "^0.8.4",
         "nikic/php-parser": "^4.0",
         "guzzlehttp/guzzle": "^7.2",
-        "psr/log": "^1.1"
+        "psr/log": "^1.1",
+        "ext-json": "*"
     },
     "require-dev": {
         "composer/composer": "^2.0",

src/Application.php

@@ -169,13 +169,13 @@ public function setBgColour(string $colour): void
         $this->bgColour = $colour;
     }
 
-    public function configure(): ContainerInterface
+    public function configure(bool $debugMode = false): ContainerInterface
     {
         if ($this->container instanceof ContainerInterface) {
             return $this->container;
         }
 
-        $container = $this->getContainer();
+        $container = $this->getContainer($debugMode);
 
         foreach ($this->exercises as $exercise) {
             if (false === $container->has($exercise)) {
@@ -221,10 +221,20 @@ public function configure(): ContainerInterface
      */
     public function run(): int
     {
-        $container = $this->configure();
+        $args = $_SERVER['argv'] ?? [];
+
+        $debug = any($args, function (string $arg) {
+            return $arg === '--debug';
+        });
+
+        $args = array_values(array_filter($args, function (string $arg) {
+            return $arg !== '--debug';
+        }));
+
+        $container = $this->configure($debug);
 
         try {
-            $exitCode = $container->get(CommandRouter::class)->route();
+            $exitCode = $container->get(CommandRouter::class)->route($args);
         } catch (MissingArgumentException $e) {
             $container
                 ->get(OutputInterface::class)
@@ -261,9 +271,10 @@ public function run(): int
     }
 
     /**
+     * @param bool $debugMode
      * @return Container
      */
-    private function getContainer(): Container
+    private function getContainer(bool $debugMode): Container
     {
         $containerBuilder = new ContainerBuilder();
         $containerBuilder->addDefinitions(
@@ -276,6 +287,7 @@ private function getContainer(): Container
         $containerBuilder->addDefinitions(
             [
                 'workshopTitle' => $this->workshopTitle,
+                'debugMode'     => $debugMode,
                 'exercises'     => $this->exercises,
                 'workshopLogo'  => $this->logo,
                 'bgColour'      => $this->bgColour,

src/CommandRouter.php

@@ -100,7 +100,6 @@ public function addCommand(CommandDefinition $c): void
      */
     public function route(array $args = null): int
     {
-
         if (null === $args) {
             $args = $_SERVER['argv'] ?? [];
         }

src/ExerciseRenderer.php

@@ -82,8 +82,6 @@ public function __construct(
      */
     public function __invoke(CliMenu $menu): void
     {
-        $menu->close();
-
         $item = $menu->getSelectedItem();
         $exercise = $this->exerciseRepository->findByName($item->getText());
         $exercises = $this->exerciseRepository->findAll();

src/Factory/MenuFactory.php

@@ -59,6 +59,7 @@ public function __invoke(ContainerInterface $c): CliMenu
             $builder->addItem(
                 $exercise->getName(),
                 function (CliMenu $menu) use ($exerciseRenderer, $eventDispatcher, $exercise) {
+                    $menu->close();
                     $this->dispatchExerciseSelectedEvent($eventDispatcher, $exercise);
                     $exerciseRenderer->__invoke($menu);
                 },

src/Logger/ConsoleLogger.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpSchool\PhpWorkshop\Logger;
+
+use Colors\Color;
+use PhpSchool\PhpWorkshop\Output\OutputInterface;
+use Psr\Log\AbstractLogger;
+use Psr\Log\LoggerInterface;
+
+class ConsoleLogger extends AbstractLogger implements LoggerInterface
+{
+    /**
+     * @var OutputInterface
+     */
+    private $output;
+
+    /**
+     * @var Color
+     */
+    private $color;
+
+    public function __construct(OutputInterface $output, Color $color)
+    {
+        $this->output = $output;
+        $this->color = $color;
+    }
+
+    public function log($level, $message, array $context = []): void
+    {
+        $parts = [
+            sprintf(
+                '%s - %s - %s',
+                $this->color->fg('yellow', (new \DateTime())->format('H:i:s')),
+                $this->color->bg('red', strtoupper($level)),
+                $this->color->fg('red', $message)
+            ),
+            json_encode($context, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT)
+        ];
+
+        $this->output->writeLine(implode("\n", $parts));
+    }
+}

src/functions.php

@@ -73,3 +73,19 @@ function collect(array $array): Collection
         return new Collection($array);
     }
 }
+
+
+if (!function_exists('any')) {
+
+    /**
+     * @param array<mixed> $values
+     * @param callable $cb
+     * @return bool
+     */
+    function any(array $values, callable $cb): bool
+    {
+        return array_reduce($values, function (bool $carry, $value) use ($cb) {
+            return $carry || $cb($value);
+        }, false);
+    }
+}

test/ApplicationTest.php

@@ -15,6 +15,9 @@
 use PhpSchool\PhpWorkshopTest\Asset\MockEventDispatcher;
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
+use PhpSchool\PhpWorkshop\Logger\ConsoleLogger;
+use PhpSchool\PhpWorkshop\Logger\Logger;
+use PHPUnit\Framework\TestCase;
 
 class ApplicationTest extends BaseTest
 {
@@ -53,7 +56,7 @@ public function testEventListenersFromLocalAndWorkshopConfigAreMerged(): void
         $rp->setAccessible(true);
         $rp->setValue($app, $frameworkFile);
 
-        $container = $rm->invoke($app);
+        $container = $rm->invoke($app, false);
 
         $eventListeners = $container->get('eventListeners');
 
@@ -162,8 +165,16 @@ public function testConfigureReturnsSameContainerInstance(): void
         self::assertSame($application->configure(), $application->configure());
     }
 
-    public function tearDown(): void
+    public function testDebugFlagSwitchesLoggerToConsoleLogger(): void
     {
-        parent::tearDown();
+        $configFile = $this->getTemporaryFile('config.php', '<?php return [];');
+        $application = new Application('My workshop', $configFile);
+        $container = $application->configure(true);
+
+        $container->set('phpschoolGlobalDir', $this->getTemporaryDirectory());
+        $container->set('appName', 'my-workshop');
+
+        $logger = $container->get(LoggerInterface::class);
+        self::assertInstanceOf(ConsoleLogger::class, $logger);
     }
 }

test/BaseTest.php

@@ -16,10 +16,8 @@ abstract class BaseTest extends TestCase
     public function getTemporaryDirectory(): string
     {
         if (!$this->tempDirectory) {
-            $tempDirectory = System::tempDir($this->getName());
-            mkdir($tempDirectory, 0777, true);
-
-            $this->tempDirectory = realpath($tempDirectory);
+            $this->tempDirectory = System::tempDir($this->getName());
+            mkdir($this->tempDirectory, 0777, true);
         }
 
         return $this->tempDirectory;