Improved foundational backend unit tests (#1405)

* part one of adding tests, updating core

* Apply fixes from StyleCI

[ci skip] [skip ci]

* we need xdebug for code coverage, and hhvm was already removed

* forgot about the sidecar for mysql completely 🤦

* gitignore removed this installed json we need to fake that we have extensions

* using reguarded closure

tests/Test/Concerns/CreatesForum.php

@@ -0,0 +1,150 @@
+<?php
+
+/*
+ * This file is part of Flarum.
+ *
+ * (c) Toby Zerner <toby.zerner@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Flarum\Tests\Test\Concerns;
+
+use Flarum\Database\Migrator;
+use Flarum\Foundation\Application;
+use Flarum\Foundation\Site;
+use Flarum\Http\Server;
+use Flarum\Install\Console\DataProviderInterface;
+use Flarum\Install\Console\DefaultsDataProvider;
+use Illuminate\Database\ConnectionInterface;
+use Illuminate\Database\Schema\Builder;
+
+trait CreatesForum
+{
+    /**
+     * @var Server
+     */
+    protected $http;
+
+    /**
+     * @var Site
+     */
+    protected $site;
+
+    /**
+     * @var Application
+     */
+    protected $app;
+
+    /**
+     * @var DataProviderInterface
+     */
+    protected $configuration;
+
+    /**
+     * Make the test set up Flarum as an installed app.
+     *
+     * @var bool
+     */
+    protected $isInstalled = true;
+
+    protected function createsSite()
+    {
+        $this->site = (new Site)
+            ->setBasePath(__DIR__.'/../../tmp')
+            ->setPublicPath(__DIR__.'/../../tmp/public');
+    }
+
+    protected function createsHttpForum()
+    {
+        $this->http = Server::fromSite(
+            $this->site
+        );
+
+        $this->app = $this->http->app;
+    }
+
+    protected function refreshApplication()
+    {
+        $this->createsSite();
+
+        $data = new DefaultsDataProvider();
+
+        $data->setDebugMode();
+        $data->setSetting('mail_driver', 'log');
+
+        $database = $data->getDatabaseConfiguration();
+        $database['database'] = env('DB_DATABASE', 'flarum');
+        $database['username'] = env('DB_USERNAME', 'root');
+        $database['password'] = env('DB_PASSWORD', '');
+        $data->setDatabaseConfiguration($database);
+
+        $this->configuration = $data;
+
+        $this->setsApplicationConfiguration($data);
+
+        $this->seedsApplication();
+
+        $this->createsHttpForum();
+    }
+
+    protected function teardownApplication()
+    {
+        /** @var ConnectionInterface $connection */
+        $connection = $this->app->make(ConnectionInterface::class);
+        $connection->rollBack();
+    }
+
+    protected function setsApplicationConfiguration(DataProviderInterface $data)
+    {
+        if ($this->isInstalled) {
+            $dbConfig = $data->getDatabaseConfiguration();
+            $this->site->setConfig(
+                $config = [
+                    'debug'    => $data->isDebugMode(),
+                    'database' => [
+                        'driver'    => $dbConfig['driver'],
+                        'host'      => $dbConfig['host'],
+                        'database'  => $dbConfig['database'],
+                        'username'  => $dbConfig['username'],
+                        'password'  => $dbConfig['password'],
+                        'charset'   => 'utf8mb4',
+                        'collation' => 'utf8mb4_unicode_ci',
+                        'prefix'    => $dbConfig['prefix'],
+                        'port'      => $dbConfig['port'],
+                        'strict'    => false
+                    ],
+                    'url'      => $data->getBaseUrl(),
+                    'paths'    => [
+                        'api'   => 'api',
+                        'admin' => 'admin',
+                    ],
+                ]
+            );
+        }
+    }
+
+    protected function seedsApplication()
+    {
+        if ($this->isInstalled) {
+            $app = app(\Illuminate\Contracts\Foundation\Application::class);
+
+            $app->bind(Builder::class, function ($container) {
+                return $container->make(ConnectionInterface::class)->getSchemaBuilder();
+            });
+
+            /** @var Migrator $migrator */
+            $migrator = $app->make(Migrator::class);
+            if (! $migrator->getRepository()->repositoryExists()) {
+                $migrator->getRepository()->createRepository();
+            }
+
+            $migrator->run(__DIR__.'/../../../migrations');
+
+            /** @var ConnectionInterface $connection */
+            $connection = $app->make(\Illuminate\Database\ConnectionInterface::class);
+            $connection->beginTransaction();
+        }
+    }
+}

tests/Test/Concerns/MakesApiRequests.php

@@ -0,0 +1,31 @@
+<?php
+
+/*
+ * This file is part of Flarum.
+ *
+ * (c) Toby Zerner <toby.zerner@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Flarum\Tests\Test\Concerns;
+
+use Flarum\Api\ApiServiceProvider;
+use Flarum\Api\Client;
+use Flarum\User\Guest;
+use Flarum\User\User;
+use Psr\Http\Message\ResponseInterface;
+
+trait MakesApiRequests
+{
+    public function call(string $controller, User $actor = null, array $queryParams = [], array $body = []): ResponseInterface
+    {
+        $this->app->register(ApiServiceProvider::class);
+        $this->app->make('flarum.api.middleware');
+        /** @var Client $api */
+        $api = $this->app->make(Client::class);
+
+        return $api->send($controller, $actor ?? new Guest, $queryParams, $body);
+    }
+}

tests/Test/Concerns/RetrievesAuthorizedUsers.php

@@ -0,0 +1,37 @@
+<?php
+
+/*
+ * This file is part of Flarum.
+ *
+ * (c) Toby Zerner <toby.zerner@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Flarum\Tests\Test\Concerns;
+
+use Flarum\User\User;
+
+trait RetrievesAuthorizedUsers
+{
+    protected $userAttributes = [
+        'username' => 'normal',
+        'password' => 'too-obscure',
+        'email' => 'normal@machine.local'
+    ];
+
+    public function getAdminUser()
+    {
+        return User::find(1);
+    }
+
+    public function getNormalUser()
+    {
+        User::unguarded(function () {
+            return User::firstOrCreate([
+                'username' => $this->userAttributes['username']
+            ], $this->userAttributes);
+        });
+    }
+}

tests/Test/TestCase.php

@@ -11,20 +11,21 @@
 
 namespace Flarum\Tests\Test;
 
-use Mockery;
 use PHPUnit\Framework\TestCase as Test;
 
 abstract class TestCase extends Test
 {
+    use Concerns\CreatesForum,
+        Concerns\MakesApiRequests;
+
     public function setUp()
     {
-        Mockery::close();
-
+        $this->refreshApplication();
         $this->init();
     }
 
     protected function init()
     {
-        // To be overloaded by children - saves having to do setUp/mockery::close every time
+        // .. allows implementation by children without the need to call the parent.
     }
 }